learnxinyminutes-docs/wikitext.html.markdown

266 lines
11 KiB
Markdown
Raw Normal View History

---
2024-10-20 21:46:35 +00:00
language: Wikitext
contributors:
- ["Yuxi Liu", "https://github.com/yuxiliu1995/"]
filename: wikitext.md
---
A wiki is an online collaboratively edited hypertext publication, the most famous of which is Wikipedia. Wikitext is the markup language used by wikis. Its syntax is similar to a mix of Markdown and HTML.
## Syntax
`<!--- comments are hidden when reading, but visible when editing --->`
| wikitext | equivalent Markdown | effect |
| ---- | ---- | ---- |
| `''italics''` | `*italics*` | *italics* |
| `'''bold'''` | `**bold**` | **bold** |
| `'''''both'''''` | `***both***` | ***both*** |
| `<u>underlined</u>` | `<u>underlined</u>` | <u>underlined</u> |
| `<nowiki>do not render</nowiki>` | N/A | `do not render` |
| `<code>inline code snippet</code>` | \`inline code snippet\` | `inline code snippet` |
| `----` | `----` | horizontal linebreak |
| `<s>strikethrough</s>` | `~~strikethrough~~` | ~~strikethrough~~ |
Section headings are bracketed by `=`. They go from `= One equal sign =` to `====== Six equal signs ======`. They are equivalent to Markdown's hashtag headings, from `# One hashtag` to `###### Six hashtags`. Why six in both? I believe it's because HTML has six levels of headings, from `<h1>` to `<h6>`.
Note that the `= One equal sign =` heading actually corresponds to the title of the page, and so cannot actually be used within a page. Consequently, the least number of equal signs is `== Two equal signs ==`.
2024-05-27 18:15:14 +00:00
Subscripts and superscripts can be written as `x<sub>1</sub>` and `x<sup>1</sup>`. Alternatively they can be written by the `<math>` tag (see below). `<small>Small</small>` and `<big>big</big>` texts are rarely used.
2024-05-27 18:15:14 +00:00
```wikitext
Colons allow indentation
:Each colon creates an indentation three characters wide.
::and they can be nested.
```
`*` Unnumbered lists start with `*`, and numbered lists start with `#`. <br>
&emsp; `**` Lists can be nested <br>
&emsp; &emsp; `***` for arbitrarily many levels.
The syntax for tables is [very complicated](https://en.wikipedia.org/wiki/Help:Table). The simplest of the [simple tables](https://en.wikipedia.org/wiki/Help:Basic_table_markup) is as follows:
```wikitext
{| class="wikitable"
2024-05-27 18:15:14 +00:00
|+
! column title A
! column title B
|-
2024-05-27 18:15:14 +00:00
| cell A1
| cell B1
|-
2024-05-27 18:15:14 +00:00
| cell A2
| cell B2
|-
2024-05-27 18:15:14 +00:00
| ...
| ...
|}
```
2024-05-27 18:15:14 +00:00
which renders to
| **column title A** | **column title B** |
|---|---|
| cell A1 | cell B1 |
| cell A2 | cell B2 |
Be warned that the newlines in a wikitext table are meaningful. Deleting a single newline above would completely change the shape of the rendered table.
You can insert images, audios, videos, or other forms of media by `[[File:Image.png|thumb|right|Image caption]]`. All media files must be hosted on [Wikimedia Commons](https://commons.wikimedia.org/wiki/Main_Page).
You can insert quotations either by HTML-like tag
2024-05-27 18:15:14 +00:00
```wikitext
<blockquote>
<p>Quotation text.</p>
<p>Name, source, reference</p>
</blockquote>
```
2024-05-27 18:15:14 +00:00
or [template](#templates)
2024-05-27 18:15:14 +00:00
```wikitext
{{Quote|text=Quotation text.|title=Title|author=Author|source=Location in the publication}}
```
A "[non-breaking space](https://en.wikipedia.org/wiki/Non-breaking_space)" is a whitespace that should not be separated by linebreaks, such as the whitespace in "400 km/h". This is written as `400&amp;nbsp;km/h`.
Extra whitespaces can be specified by `pad` tag. For example, `{{pad|4.0em}}` is a white space with length 4.0 [em-dashes](https://en.wikipedia.org/wiki/Dash#Em_dash).
2024-05-27 18:15:14 +00:00
Longer code blocks can be done by
```wikitext
<syntaxhighlight lang="cpp">
#include <iostream>
int m2 (int ax, char *p_ax) {
std::cout <<"Hello World!";
return 0;
}</syntaxhighlight>
```
2024-05-27 18:15:14 +00:00
which renders to
```cpp
#include <iostream>
int m2 (int ax, char *p_ax) {
std::cout <<"Hello World!";
return 0;
}
```
## Linking
2024-05-27 18:15:14 +00:00
Basic `[[linking]]` is done by double brackets.
2024-05-27 18:15:14 +00:00
The `|` symbol allows displaying a `[[Actual page title|different text]]`.
The `#` symbol allows linking to sections within a text, like `[[Frog#Locomotion]]` or `[[Frog#Locomotion|locomotion in frogs]]`.
2024-05-27 18:15:14 +00:00
If a word is interrupted by a link, it is "blended" into the link. For example, `[[copy edit]]ors` renders to [copy editors](https://en.wikipedia.org/wiki/copy_edit).
To suppress this behavior, use `<nowiki>`. For example, `[[micro-]]<nowiki />second` renders to [micro-](https://en.wikipedia.org/wiki/micro-)second.
There are three kinds of external linking. The third kind is preferred:
| wikitext | renders to |
|----|----|
| `https://www.wikipedia.org` | [https://www.wikipedia.org](https://www.wikipedia.org) |
| `[https://www.wikipedia.org]` | [[1]](https://www.wikipedia.org) |
| `[https://www.wikipedia.org Wikipedia]` | [Wikipedia](https://www.wikipedia.org) |
## Templates
Templates are macros for wikitext, and they look like `{{template name|attribute=value|...}}`. There are thousands of templates, but only a few are in common use.
The most (in)famous one is the \[citation needed\]`{{cn}}` template. Note that `{{cn}}` is synonymous with `{{citation needed}}`, as one template can have many names.
`{{reflist}}` is usually put at the ends of pages, to generate a list of references used in the page.
An `infobox` template is, as it says, a template for a box containing information. Usually, each page contains at most two infoboxes, one on top and one on bottom. For particularly detailed pages, there can be more than two.
The infobox on the top is usually used to compactly display tabular information. They are common for biographies, geographical locations, and such. For example, the top infobox for [Euler](https://en.wikipedia.org/wiki/Leonhard_Euler) is:
2024-05-27 18:15:14 +00:00
```wikitext
{{Infobox scientist
| name = Leonhard Euler
| image = Leonhard Euler.jpg
| caption = Portrait by [[Jakob Emanuel Handmann]], 1753
| birth_date = {{birth date|df=y|1707|4|15}}
| birth_place = [[Basel]], [[Swiss&nbsp;Confederacy]]
| death_date = {{nowrap|{{death date and age|df=y|1783|9|18|1707|4|15}}}} {{awrap|{{bracket|[[Adoption of the Gregorian calendar#Adoption in Eastern Europe|OS]]: 7 September 1783}}}}
...
}}
```
The infobox at the bottom is usually used to display a curated table of related links. For example, the bottom infobox for [EulerLagrange equation](https://en.wikipedia.org/wiki/Euler%E2%80%93Lagrange_equation) is just `{{Leonhard Euler}}`, which displays a box containing links to many of the things named after Euler.
`~~~~` is used to sign on talk pages, and expands to something like `Username (talk) 10:50, 12 June 2023 (UTC)`.
### Mathematics
2024-05-27 18:15:14 +00:00
`<math>` tag renders $\LaTeX$ inline like `$`, while `<math display=block>` renders it on a separate line like `$$`.
`<math>E = mc^2</math>` renders to $E = mc^2$.
`<math display=block></math>` renders to $$E = mc^2$$.
One can also include math using [HTML renders](https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Mathematics#Using_HTML) or even by [plain Unicode](https://en.wikipedia.org/wiki/Mathematical_operators_and_symbols_in_Unicode). These are less flexible but more compatible with older browsers. Further, parts of Wikipedia syntax themselves are incompatible with `<math>`, such as in section titles or some templates, forcing the use of HTML or Unicode in such cases.
2024-05-27 18:15:14 +00:00
Theorems and proofs can be boxed and named:
2024-05-27 18:15:14 +00:00
```wikitext
{{Math theorem
|name=Pythagorean theorem
|note=Pythagoras, 500s BC
|math_statement=Let <math>a, b, c</math> be the three side lengths of a right triangle, then
<math display=block>a^2 + b^2 = c^2</math>
}}
{{Math proof
|title=Proof by similar triangles
|proof=Drop a perpendicular from point C to side AB. Now argue by proportionality. <math>\blacksquare</math>
}}
```
## References
2024-05-27 18:15:14 +00:00
References are the backbone of Wikipedia `{{citation needed}}`. There are in general two ways to do citations.
| type | inline citation | expanded citation |
| ---- | ---- | ---- |
| purpose | Support specific claims. | Provide general reference work for the entire page. |
| location | Immediately after the supported claim. | In the `== References ==` section. |
| appearance | analytic continuation of of _f_.<sup>[\[6\]](#6)</sup> | Abramowitz, Milton; Stegun, Irene A., eds. (1972). ["Chapter 6"](http://www.math.sfu.ca/~cbm/aands/page_253.htm)... |
| syntax | `<ref>{{cite book\|...}}</ref>` | `{{cite book\|...}}` |
As expanded citations are just inline citations without the `<ref>` tag, we will describe just inline citations.
2024-05-27 18:15:14 +00:00
The most basic form is a plaintext citation, like `<ref>Author, Title, date, [url](https://example.com/), etc</ref>`.
One should generally use a templated citation, like `<ref>{{cite web|url=https://example.com/|title=Example|date=2001|access-date=2023}}</ref>`. There are three forms of citation templates: [`cite web`](https://en.wikipedia.org/wiki/Template:Cite_web), [`cite journal`](https://en.wikipedia.org/wiki/Template:Cite_journal), [`cite book`](https://en.wikipedia.org/wiki/Template:Cite_book).
A citation can be named as `<ref name="X">...</ref>`. It can then be invoked as `<ref name="X" />`. The instance `<ref name="X">...</ref>` can go before or after `<ref name="X" />`. Any ordering would render to the same page.
## Typical Wikipedia page
```wikitext
{{Short description|One sentence summary of page}}
{{Infox box at the top
|infobox_data_1=...
|...
}}
[[File:Image of X.png|thumb|right|Image caption]]
The concept '''X''' is usually bolded. Now define the concept X. For non-specialist pages, this section should be written in plain language, with jargons defined in-line. Some [[link]]s would help.
== Introduction ==
Here one usually sets up the notation, overviews the history, and such. Details follow in the next sections.
Footnotes are numbered separately from inline references.{{NoteTag|note=Footnote text.}}
== Relation to Y ==
{{Main|Y}}
{{See also|Another page}}
Something about the relation between X and Y.
== See also ==
* [[Very relevant link]]
* [[Less relevant link]]
== External links ==
* [https://example.com/ External link one]: Summary of what is in the external link.
== Footnotes ==
<references group="note" />{{Notelist}}
== References ==
<!-- generates list of references from inline reference tags, with columns with a minimum width of 30 em-dashes. -->
2024-05-27 18:15:14 +00:00
{{Reflist|30em}}
<!-- extra, non-inlined references below -->
{{Refbegin|30em}}
* {{cite book|title=Book Title|date=2001|chapter=Chapter 1|...}}
* ...
== Further reading ==
* ...
* ...
{{Infox box at the bottom}}
[[Category:First category that the article belongs to]]
[[Category:First category that the article belongs to]]
[[Category:There is no limit to the number of categories allowed]]
```
## Further reading
* [Wikipedia's manual of style](https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style)
2024-05-27 18:15:14 +00:00
* [Wikitext cheatsheet](https://en.wikipedia.org/wiki/Help:Cheatsheet)
* [Wikitext, full reference](https://en.wikipedia.org/wiki/Help:Wikitext).
* [Tables, full reference](https://en.wikipedia.org/wiki/Help:Table#Simple_straightforward_tables)