Difference between revisions of "Help:Basic MediaWiki Syntax"
(Add separator line between 'Indented items' and 'Bullet list') |
|||
(23 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
+ | This is a brief introduction to MediaWiki [[source]] syntax. For a more comprehensive guide, see [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents here]. | ||
+ | __NOTOC__ | ||
+ | ==Text== | ||
+ | |||
<div align="center"> | <div align="center"> | ||
{| style="border:1px solid #A3B1BF; text-align:left; background:#f5faff" | {| style="border:1px solid #A3B1BF; text-align:left; background:#f5faff" | ||
Line 33: | Line 37: | ||
|- | |- | ||
|Internal link<br /> | |Internal link<br /> | ||
− | (within the Computer History wiki) | + | (within the Computer History wiki)<br /> |
+ | ''This, and the one above, can be combined.'' | ||
| | | | ||
<tt><nowiki>[[name of page]]</nowiki></tt><br /> | <tt><nowiki>[[name of page]]</nowiki></tt><br /> | ||
<tt><nowiki>[[name of page|display text]]</nowiki></tt><br /> | <tt><nowiki>[[name of page|display text]]</nowiki></tt><br /> | ||
+ | <tt><nowiki>[[name of page#heading]]</nowiki></tt><br /> | ||
| | | | ||
[[name of page]]<br /> | [[name of page]]<br /> | ||
[[name of page|display text]]<br /> | [[name of page|display text]]<br /> | ||
+ | [[name of page#heading]]<br /> | ||
|- | |- | ||
− | |colspan=" | + | |colspan="2"|<span style="font-size:0.9em; text-align:center;">''Wikipedia style, followed here, is generally to only link the '''first''' instance of a term on a page.''</span> |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
|colspan="3" style="border-top:1px solid #cee0f2;"| | |colspan="3" style="border-top:1px solid #cee0f2;"| | ||
|- | |- | ||
|External link<br /> | |External link<br /> | ||
− | (to other websites) | + | (to other websites)<br /> |
+ | ''The middle one is '''much''' preferred.'' | ||
| | | | ||
<tt><nowiki>[http://www.example.org]</nowiki></tt><br /> | <tt><nowiki>[http://www.example.org]</nowiki></tt><br /> | ||
Line 63: | Line 65: | ||
|- | |- | ||
|colspan="3" style="border-top:1px solid #cee0f2;"| | |colspan="3" style="border-top:1px solid #cee0f2;"| | ||
+ | |- | ||
+ | | | ||
+ | Text can be commented out | ||
+ | | | ||
+ | matching <nowiki><!--</nowiki> and <nowiki>--></nowiki> around text to be ignored | ||
|- | |- | ||
| | | | ||
Line 73: | Line 80: | ||
{{CURRENTDAY}} {{CURRENTMONTHNAME}} {{CURRENTYEAR}} (UTC) | {{CURRENTDAY}} {{CURRENTMONTHNAME}} {{CURRENTYEAR}} (UTC) | ||
|-<!--2ND HEADING--> | |-<!--2ND HEADING--> | ||
− | | colspan="3" style="background:#E6F2FF; padding: 0.2em; font-family: sans-serif; font-size: 0.9em; text-align:center;" | | + | | colspan="3" style="background:#E6F2FF; padding: 0.2em; font-family: sans-serif; font-size: 0.9em; text-align:center;" | Items below only apply at the beginning of a line |
|- | |- | ||
|Headings<br /> | |Headings<br /> | ||
<span style="font-size:0.9em;">''A Table of Contents will automatically be generated when four headings are added to an article.''</span> | <span style="font-size:0.9em;">''A Table of Contents will automatically be generated when four headings are added to an article.''</span> | ||
+ | |||
+ | <span style="font-size:0.9em;">''For a reason that has been lost in the mists of time, Wikipedia (and thus here) uses '==' as the top level section marker; '=' seems to work now, but please keep up the style.''</span> | ||
| | | | ||
<tt><nowiki>== Level 1 ==</nowiki></tt><br /> | <tt><nowiki>== Level 1 ==</nowiki></tt><br /> | ||
Line 84: | Line 93: | ||
<tt><nowiki>====== Level 5 ======</nowiki></tt> | <tt><nowiki>====== Level 5 ======</nowiki></tt> | ||
| | | | ||
+ | __TOC__ | ||
+ | |||
== Level 1 == | == Level 1 == | ||
=== Level 2 === | === Level 2 === | ||
Line 89: | Line 100: | ||
===== Level 4 ===== | ===== Level 4 ===== | ||
====== Level 5 ====== | ====== Level 5 ====== | ||
+ | |- | ||
+ | |colspan="3" style="border-top:1px solid #cee0f2;"| | ||
+ | |- | ||
+ | |Indented items<br /> | ||
+ | ''(used mostly on Talk: pages)'' | ||
+ | | | ||
+ | <tt>: foo</tt><br /> | ||
+ | <tt>:: bar</tt><br /> | ||
+ | | | ||
+ | : foo | ||
+ | :: bar | ||
|- | |- | ||
|colspan="3" style="border-top:1px solid #cee0f2;"| | |colspan="3" style="border-top:1px solid #cee0f2;"| | ||
Line 117: | Line 139: | ||
## two point one | ## two point one | ||
# three | # three | ||
+ | |} | ||
+ | </div> | ||
+ | |||
+ | ==Pre-formatted text== | ||
+ | |||
+ | There are a number of ways to include pre-formatted text (e.g. [[source code]] fragments); all of these techniques also use a fixed-width [[font]] for the text: | ||
+ | |||
+ | * Start each line with a space character; normal markups can be used; e.g.: | ||
+ | |||
+ | <nowiki>" This is '''pre-formatted''' text"</nowiki> | ||
+ | |||
+ | produces: | ||
+ | |||
+ | This is '''pre-formatted''' text | ||
+ | |||
+ | * Use the [[Hypertext Markup Language|HTML]] <nowiki><nowiki></nowiki> tag, with a space character before the <nowiki><nowiki></nowiki>. (Remember to add a matching closing tag after the pre-formatted text block). | ||
+ | |||
+ | * Use the HTML <nowiki><pre></nowiki> tag (again, remember the closing tag). | ||
+ | |||
+ | Note that the HTML <nowiki><blockquote></nowiki> tag only indents the block; text within it will still be justified. | ||
+ | |||
+ | ==Tables== | ||
+ | |||
+ | <pre> | ||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | ! Table !! Prototype | ||
+ | |- | ||
+ | | colspan="2" | Headers | ||
+ | |- | ||
+ | | aa || rowspan="2" | yy | ||
+ | |- | ||
+ | | bb | ||
+ | |- | ||
+ | | cc || zz | ||
+ | |} | ||
+ | </pre> | ||
+ | |||
+ | produces: | ||
+ | |||
+ | {| class="wikitable" style="text-align:center;" | ||
+ | ! Table !! Prototype | ||
+ | |- | ||
+ | | colspan="2" | Headers | ||
+ | |- | ||
+ | | aa || rowspan="2" | yy | ||
|- | |- | ||
− | | | + | | bb |
|- | |- | ||
− | | | + | | cc || zz |
− | | | ||
− | |||
− | |||
− | |||
|} | |} | ||
− | </ | + | |
+ | ==Images== | ||
+ | |||
+ | Including the special form: | ||
+ | |||
+ | <nowiki>[[File:Pdp1115.jpg|thumb|150px|left|Caption text]]</nowiki> | ||
+ | |||
+ | produces: | ||
+ | |||
+ | [[File:Pdp1115.jpg|thumb|150px|left|Caption text]] | ||
+ | |||
+ | (The legacy keyword 'Image' may be used in place of "File".) Leaving out the "150px" inserts the image full-size. The optional keywords 'left' and 'right' can be added to control the horizontal placement. | ||
+ | |||
+ | (Notice that this text fills up around the image. Add a <nowiki><br clear=all></nowiki> after the image line to force the text to re-start below the image.) | ||
+ | |||
+ | New images can be uploaded via the 'Upload file' page (link on the left-hand side of all pages). | ||
+ | |||
+ | A lengthy tutorial on images is [https://en.wikipedia.org/wiki/Help:Pictures here]; complete specifications for the use of the 'File' special form are available [https://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax here] and [https://www.mediawiki.org/wiki/Help:Images here]. | ||
+ | <br clear=all> | ||
+ | ==See also== | ||
+ | |||
+ | * [https://www.mediawiki.org/wiki/Help:Contents MediaWiki.org help pages] - a wealth of detail | ||
+ | ** [https://www.mediawiki.org/wiki/Help:Formatting Help:Formatting] - detailed help on formatting | ||
+ | ** [https://www.mediawiki.org/wiki/Help:Tables Help:Tables] - ditto for tables | ||
+ | |||
+ | [[Category: Help]] |
Latest revision as of 13:09, 8 May 2024
This is a brief introduction to MediaWiki source syntax. For a more comprehensive guide, see here.
Text
Description | You type | You get |
Applies anywhere | ||
Italicise text |
''italic'' |
italic |
Bold text |
'''bold''' |
bold |
Bold and italic |
'''''bold & italic''''' |
bold & italic |
Internal link (within the Computer History wiki) |
[[name of page]] |
|
Wikipedia style, followed here, is generally to only link the first instance of a term on a page. | ||
External link (to other websites) |
[http://www.example.org] |
|
Text can be commented out |
matching <!-- and --> around text to be ignored | |
Sign your posts |
~~~~ |
Your username 18:12, |
Items below only apply at the beginning of a line | ||
Headings A Table of Contents will automatically be generated when four headings are added to an article. For a reason that has been lost in the mists of time, Wikipedia (and thus here) uses '==' as the top level section marker; '=' seems to work now, but please keep up the style. |
== Level 1 == |
ContentsLevel 1Level 2Level 3Level 4Level 5 |
Indented items (used mostly on Talk: pages) |
: foo |
|
Bullet list |
* one |
|
Numbered list |
# one |
|
Pre-formatted text
There are a number of ways to include pre-formatted text (e.g. source code fragments); all of these techniques also use a fixed-width font for the text:
- Start each line with a space character; normal markups can be used; e.g.:
" This is '''pre-formatted''' text"
produces:
This is pre-formatted text
- Use the HTML <nowiki> tag, with a space character before the <nowiki>. (Remember to add a matching closing tag after the pre-formatted text block).
- Use the HTML <pre> tag (again, remember the closing tag).
Note that the HTML <blockquote> tag only indents the block; text within it will still be justified.
Tables
{| class="wikitable" style="text-align: center;" ! Table !! Prototype |- | colspan="2" | Headers |- | aa || rowspan="2" | yy |- | bb |- | cc || zz |}
produces:
Table | Prototype |
---|---|
Headers | |
aa | yy |
bb | |
cc | zz |
Images
Including the special form:
[[File:Pdp1115.jpg|thumb|150px|left|Caption text]]
produces:
(The legacy keyword 'Image' may be used in place of "File".) Leaving out the "150px" inserts the image full-size. The optional keywords 'left' and 'right' can be added to control the horizontal placement.
(Notice that this text fills up around the image. Add a <br clear=all> after the image line to force the text to re-start below the image.)
New images can be uploaded via the 'Upload file' page (link on the left-hand side of all pages).
A lengthy tutorial on images is here; complete specifications for the use of the 'File' special form are available here and here.
See also
- MediaWiki.org help pages - a wealth of detail
- Help:Formatting - detailed help on formatting
- Help:Tables - ditto for tables