Help:Editing: Difference between revisions
mNo edit summary |
m (Somewhat better) |
||
Line 1: | Line 1: | ||
[[Help:Editing]] | Merging this with [[Help:Editing]] some time soon. | ||
==Editing== | |||
We won't be giving a detailed course on MediaWiki markup here : just a few basic "how to"s, "do"s and "don't"s. | |||
More to | For generalities on how to use a MediaWiki-powered wiki, you're encouraged to have a look [http://meta.wikimedia.org/wiki/Help:Help HERE] | ||
(also available in [http://meta.wikimedia.org/wiki/Aiuto:Aiuto Italian] and [http://meta.wikimedia.org/wiki/Помощь:Помощь Russian], as well as Greek and French and Slovenian). | |||
---- | |||
---- | |||
==Recommended== | |||
===Preview=== | |||
:Use the "Show preview" button ''as much as possible'' before submitting. Sure, even experienced and good-willing users (like [[User:geyser|me]]) make a few edits in a row sometimes (because they think a page is done and submit it, and ''then'' go through it again and spot a typo or something), but that's nothing compared to the dozens of edits made by someone who's totally oblivious of the preview feature. | |||
===Templates and transclusion=== | |||
More, later. Transclusion may be a bit tricky to figure out at first, but it's well worth it. | |||
===Uploaded files=== | |||
There is no such thing as folders (just "Categories"), so keep in mind all the images go into ''one big folder''. Also, an image can't be renamed or moved in the same way a regular page can. | |||
Therefore, please give your images the most explicit, unique, unambiguous name you can think of. | |||
;Like:[[:Image:GUIDO Hikari closeup.jpg|GUIDO Hikari closeup.jpg]] | |||
;NOT like:[[:Image:August4_2006.jpg|August4_2006.jpg]] | |||
^^ | |||
---- | |||
---- | |||
==Various tips== | |||
===Line formatting=== | |||
====Numbered lists==== | |||
#This line actually begins with a "#" character | |||
##This line actually begins with two "#" characters | |||
###This line actually begins with three "#" characters | |||
###This line actually begins with three "#" characters | |||
##This line actually begins with two "#" characters | |||
#This line actually begins with a "#" character | |||
====Bulleted lists==== | |||
*This line actually begins with a "*" character | |||
**This line actually begins with two "*" characters | |||
***This line actually begins with three "*" characters | |||
**This line actually begins with two "*" characters | |||
*This line actually begins with a "*" character | |||
====Indented paragraphs==== | |||
:This line actually begins with a ":" character. The whole paragraph will wrap around indented; it all has to be on the same line, though. | |||
:To start a new paragraph indented the same way, just start another line with a ":"<br>You can also use the <nowiki><br></nowiki> tag to start a new line. | |||
::Put "::" at the start of the line to indent more. | |||
:::Put ":::" at the start of the line to indent even more. | |||
(actually, it's a lot like tabulation) | |||
====Definitions (titled paragraphs)==== | |||
;This line starts with a ";" | |||
;This one too, but:it switched to indented text when it encountered a ":" (have a look at the markup). | |||
This allows one to typeset definitions, dialogue lines etc rather easily. You can also use it as a quick way to put a line in bold. | |||
*the advantage of the leading ";" is that you don't have to bother about the extra new line before the bold-faced line | |||
*the drawback is that the line can't contain a ":" unless you escape it (e.g. with the <nowiki><nowiki></nowiki> tag). | |||
;Like this <nowiki>: ":"</nowiki> | |||
"Definitions" occur within an already indented paragraph : | |||
:bla | |||
::bla | |||
::;BLA:bla | |||
::bla | |||
:bla | |||
===Unformatted ASCII=== | |||
This line actually starts with a " " character. It is rendered in a box, with a fixed-size font. | |||
Do this for several lines to set apart a whole block of text. | |||
The previous line is only empty in the rendered box; in the markup, there's a " " character. | |||
This one begind with 5 leading spaces in the markup; only 4 are visible when rendered. | |||
You can still put text in ''italics'', '''bold''', or '''''bold italics'''''. | |||
However, leading "*", "#", ":" and ";" won't work : | |||
*bla | |||
#bla | |||
;bla | |||
:bla | |||
Bottom line : be careful when you use leading spaces : is that really what you want? | |||
For regular indentation, prefer ":". | |||
===Smileys=== | |||
Because of the line formatting, one should be careful with putting smileys on a new line. The following are examples of smileys that work fine : | |||
^_^ | |||
^^ | |||
=) | |||
%) | |||
":)" and ";)", however, won't work on a new line. Neither will " :)" and " ;)". | |||
One solution is to avoid such smilies altogether. You can also use these (add three leading "'"s) : | |||
''':) | |||
''';) |
Revision as of 17:40, 27 September 2006
Merging this with Help:Editing some time soon.
Editing
We won't be giving a detailed course on MediaWiki markup here : just a few basic "how to"s, "do"s and "don't"s.
For generalities on how to use a MediaWiki-powered wiki, you're encouraged to have a look HERE
(also available in Italian and Russian, as well as Greek and French and Slovenian).
Recommended
Preview
- Use the "Show preview" button as much as possible before submitting. Sure, even experienced and good-willing users (like me) make a few edits in a row sometimes (because they think a page is done and submit it, and then go through it again and spot a typo or something), but that's nothing compared to the dozens of edits made by someone who's totally oblivious of the preview feature.
Templates and transclusion
More, later. Transclusion may be a bit tricky to figure out at first, but it's well worth it.
Uploaded files
There is no such thing as folders (just "Categories"), so keep in mind all the images go into one big folder. Also, an image can't be renamed or moved in the same way a regular page can.
Therefore, please give your images the most explicit, unique, unambiguous name you can think of.
- Like
- GUIDO Hikari closeup.jpg
- NOT like
- August4_2006.jpg
^^
Various tips
Line formatting
Numbered lists
- This line actually begins with a "#" character
- This line actually begins with two "#" characters
- This line actually begins with three "#" characters
- This line actually begins with three "#" characters
- This line actually begins with two "#" characters
- This line actually begins with two "#" characters
- This line actually begins with a "#" character
Bulleted lists
- This line actually begins with a "*" character
- This line actually begins with two "*" characters
- This line actually begins with three "*" characters
- This line actually begins with two "*" characters
- This line actually begins with two "*" characters
- This line actually begins with a "*" character
Indented paragraphs
- This line actually begins with a ":" character. The whole paragraph will wrap around indented; it all has to be on the same line, though.
- To start a new paragraph indented the same way, just start another line with a ":"
You can also use the <br> tag to start a new line.- Put "::" at the start of the line to indent more.
- Put ":::" at the start of the line to indent even more.
- Put "::" at the start of the line to indent more.
(actually, it's a lot like tabulation)
Definitions (titled paragraphs)
- This line starts with a ";"
- This one too, but
- it switched to indented text when it encountered a ":" (have a look at the markup).
This allows one to typeset definitions, dialogue lines etc rather easily. You can also use it as a quick way to put a line in bold.
- the advantage of the leading ";" is that you don't have to bother about the extra new line before the bold-faced line
- the drawback is that the line can't contain a ":" unless you escape it (e.g. with the <nowiki> tag).
- Like this : ":"
"Definitions" occur within an already indented paragraph :
- bla
- bla
- BLA
- bla
- bla
- bla
- bla
Unformatted ASCII
This line actually starts with a " " character. It is rendered in a box, with a fixed-size font.
Do this for several lines to set apart a whole block of text. The previous line is only empty in the rendered box; in the markup, there's a " " character. This one begind with 5 leading spaces in the markup; only 4 are visible when rendered. You can still put text in italics, bold, or bold italics. However, leading "*", "#", ":" and ";" won't work : *bla #bla ;bla :bla
Bottom line : be careful when you use leading spaces : is that really what you want? For regular indentation, prefer ":".
Smileys
Because of the line formatting, one should be careful with putting smileys on a new line. The following are examples of smileys that work fine :
^_^
^^
=)
%)
":)" and ";)", however, won't work on a new line. Neither will " :)" and " ;)".
One solution is to avoid such smilies altogether. You can also use these (add three leading "'"s) :
:)
;)