Help:Editing: Difference between revisions

From OniGalore
Jump to navigation Jump to search
No edit summary
(→‎Interwiki links: rewrite and update for new interwiki map)
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{SysopAdvice|Be sure to follow our [[seven]]-point plan to editing nirvana [[OniGalore:Policy|HERE]], and you'll become a fine contributor to the wiki in no time at all.|Don't listen to that guy.}}
:''After reading this page, please see our rules on the [[OniGalore:Policy]] page.''


==Editing OniGalore==
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 that will mostly get you by, when it comes to our wiki. For more details, see the section [[#Further Help|Further Help]] below. Wikimedia's general [http://meta.wikimedia.org/wiki/Help:Help Help] is also available in [http://meta.wikimedia.org/wiki/Aiuto:Aiuto Italian] and [http://meta.wikimedia.org/wiki/Помощь:Помощь Russian], as well as many other languages. That is where you'll find the most detailed info on the MediaWiki software.
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 that will mostly get you by, when it comes to our wiki. For more details, see the section [[#Further Help|Further Help]] below.


Wikimedia's general [http://meta.wikimedia.org/wiki/Help:Help Help] is 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. That is where you'll find the most up-to-date info on the MediaWiki software.
==Text formatting==
===Common formatting===
The most common way to emphasize or set apart some text in a line is to use apostrophes to create italicized and bold text:<br />
<code><nowiki>''Using two''</nowiki></code> will give you ''italics''.<br />
<code><nowiki>'''Using three'''</nowiki></code> will give you '''bold'''.


Underlining text is not as convenient; it requires you to fall back to raw HTML markup:<br />
<code><nowiki><u>Here's the underline tag</u></nowiki></code> gives you <u>Here's the underline tag</u>.


----
Finally, although we have not been in the habit of using it on OniGalore, you can highlight text with the mark tag:<br />
----
<code><nowiki><mark>Pay attention</mark></nowiki></code> yields <mark>Pay attention</mark>.


===Links===
===Monospace and unformatted text===
Basically, there are thee types of links: 1) links to external pages and files; 2) intralinks to other pages on the wiki; 3) interwiki links.
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 (e.g., programming code).
The previous line is only empty in the rendered box; if you edit this page, you'll see the " " character in the wiki markup.
 
You can still put text in ''italics'', '''bold''', or '''''bold italics'''''.
However, leading "*", "#", ":" and ";" won't work :
*bla
#bla
;bla
:bla


====External links====
:For regular indentation (like this line), you should start the line with ":" as shown below.
 
There are several other options, the <nowiki><pre></nowiki>, <nowiki><tt></nowiki>, <nowiki><code></nowiki>, and <nowiki><nowiki></nowiki> tags, which will not be discussed in-depth here, but play around with them to see how they behave slightly differently from each other.
 
==Line formatting==
Everyone likes lists. Below are four methods for listing items, but there are also buttons available in the toolbar that make it faster to create these lists than typing the markup by hand. See the documentation for [[XEB]] to learn about the toolbar buttons.
 
'''Normal newlines'''<br />
A quirk of wiki markup is that two consecutive lines will be displayed as one line. In other words, a single newline is ignored. This actually goes back to the fact that wiki markup is based on HTML, which behaves the same way. Instead of hitting Return once to start a new line, you need to hit it twice. Alternately, you can force a linebreak at any time with the <nowiki><br /></nowiki> tag.
 
'''Numbered lists'''<br />
#This line actually begins with a "#" character.
##This line actually begins with two "#" characters.
##So does this one.
#Here's the next single-"#" line.
 
'''Bulleted lists'''<br />
*This line actually begins with a "*" character.
**This line begins with two "*" characters.
 
'''Indented paragraphs'''<br />
:This line begins with a ":" character. The whole paragraph will wrap around using this indentation.
:When starting a second indented line, you don't need to put an extra newline after the previous line like you normally would.
::The more ":"s you put at the start of the line, the more indentation you get.
 
'''Titled paragraphs'''<br />
;This line starts with a ";"
:Starting the next line with a ":" creates the impression of a paragraph under a title, useful for typesetting word definitions, dialogue lines, etc.
 
==Links==
Basically, there are thee types of links: (1) links to external pages and files, (2) intrawiki links to other pages on the wiki, and (3) interwiki links.
 
===External links===
(1a) Write the following to get some text acting as an ''outgoing'' hyperlink.
(1a) Write the following to get some text acting as an ''outgoing'' hyperlink.
  '''['''<nowiki>http://oni.bungie.org/community/forum/ here is our forum</nowiki>''']'''
  '''['''<nowiki>http://oni.bungie.org/community/forum/ here is our forum</nowiki>''']'''
The result is: [http://oni.bungie.org/community/forum/ here is our forum]
The result is: [http://oni.bungie.org/community/forum/ here is our forum]


(1b) If you omit the alternative text, the result will be different:
(1b) If you omit the label text, the result will be different:
  Here '''['''<nowiki>http://oni.bungie.org/community/forum/</nowiki>''']''' is our forum
  Here '''['''<nowiki>http://oni.bungie.org/community/forum/</nowiki>''']''' is our forum
The result is: here [http://oni.bungie.org/community/forum/] is our forum
The result is: here [http://oni.bungie.org/community/forum/] is our forum. However, this is not part of our usual style on this wiki. You should always label your links.


(1c) You can also write URLs without any markup. Like this:
(1c) You can also write URLs without any markup. Like this:
:Here is our forum: http://oni.bungie.org/community/forum/
:Here is our forum: http://oni.bungie.org/community/forum/
Note that images will appear inline if you do that.
Note that external images will appear inline if you use their bare URL like this.


====Intralinks====
===Intrawiki links===
(2a) Write the following to get an ''intrawiki'' link to one of our own pages.
(2a) Write the following to get an ''intrawiki'' link to one of our own pages:
  '''[['''<nowiki>Quotes/Consoles#STURMANDERUNG_:_Final_Stage</nowiki>''']]'''
  '''[['''<nowiki>Quotes/Consoles#STURMANDERUNG_:_Final_Stage</nowiki>''']]'''
The result is this: [[Quotes/Consoles#STURMANDERUNG_:_Final_Stage]]
The result is this: [[Quotes/Consoles#STURMANDERUNG_:_Final_Stage]]


(2b) Write following to get an ''intrawiki'' link which is fixed to some text
(2b) Write following to get an ''intrawiki'' link which is labeled with some text:
  '''[['''<nowiki>OniSplit#Download_links</nowiki>'''|'''<nowiki>here you can download onisplit</nowiki>''']]'''
  '''[['''<nowiki>OniSplit#Download_links</nowiki>'''|'''<nowiki>here you can download onisplit</nowiki>''']]'''
The result is this: [[OniSplit#Download_links|You can download OniSplit here]]
The result is this: [[OniSplit#Download_links|You can download OniSplit here]]


This kind of link (2a/2b) spares you from writing '''<nowiki>http://wiki.oni2.net/</nowiki>'''<font style="color:#777">OniSplit#Download_links</font>
This kind of link (2a/2b) spares you from writing '''<nowiki>http://wiki.oni2.net/</nowiki>OniSplit#Download_links'''


====Interwiki links====
===Interwiki links===
You can link to pages on [http://en.wiktionary.org Wiktionary], the [http://en.wiktionary.org English Wikipedia] and [http://meta.wikimedia.org Meta-Wiki] as if they were pages of our own wiki, using the prefixes '''<nowiki>[[wiktionary:]]</nowiki>''', '''<nowiki>[[wikipedia:]]</nowiki>''' and '''<nowiki>[[metawikipedia:]]</nowiki>'''.
You can link to pages on [http://en.wiktionary.org Wiktionary], the [http://en.wiktionary.org English Wikipedia] and [http://meta.wikimedia.org Meta-Wiki] as if they were pages of our own wiki, using the prefixes '''<nowiki>wiktionary:</nowiki>''', '''<nowiki>wikipedia:</nowiki>''' and '''<nowiki>metawikimedia:</nowiki>'''. When you make an interwiki link, the outbound link icon changes from an upward arrow to a sideward arrow to show that you are linking to a fellow wiki, not some random web site.


An example of using an interwiki prefix would be '''<nowiki>[[wikipedia:Test]]</nowiki>''', which produces [[wikipedia:Test]] (you can supply alternate text using the syntax '''<nowiki>[[wikipedia:Test|Test]]</nowiki>''' to get rid of that pesky prefix in the final markup: [[wikipedia:Test|Test]]). These prefixes accept language codes, so you could use the markup '''<nowiki>[[wikipedia:de:Test|Test]]</nowiki>''' to link to the German article [[wikipedia:de:Test|Test]] (the URL will appear wrong, but Wikipedia knows what it means).


----
All of the Wikimedia Foundation's projects have prefixes available for linking to them. Also note that we have handy shortcuts for the two most-used prefixes; '''wikipedia:''' can be shortened to '''wp:''' and '''wiktionary:''' can be shortened to '''wikt:'''. The complete list of currently supported interwiki links can be obtained by clicking [http://wiki.oni2.net/w/api.php?action=query&meta=siteinfo&siprop=interwikimap here].
----
===Recommendations===
Although we're not as formal as Wikipedia, here are a few things that do matter to us on OniGalore.


====Signature====
Looking at the list, you'll see that some prefixes are not actually for other wikis, but general web shortcuts; '''google:''' produces a Google search query for the provided search term, and '''cache:''' produces a Google page cache query for the provided URL.
You should sign your post whenever you edit a page that is discussion-oriented -- that is, a [[User_talk:Iritscen|talk page]] or a [[AE:Bug-fix_and_feature_requests|project page]], as opposed to a formal article like [[Konoko]].  You sign posts by inserting three or four tildes ("~") after your added text.  A triple tilde will just give us your name and a link to your user page.  It's better to use four tildes, which will also add a time stamp to your signature.


;Three tildes ("<nowiki>~~~</nowiki>") produces:
==Images and categories==
:[[User:geyser|geyser]]
To place an image, you type its name inside of double brackets, preceded by "Image:", e.g. <code><nowiki>[[Image:TXMPPOSTER3.png]]</nowiki></code>. This markup will be replaced by the named image. If you only want to link to the page of an image, you type <code><nowiki>[[:Image:TXMPPOSTER3.png]]</nowiki></code> to get [[:Image:TXMPPOSTER3.png]].
;But using the "four-tilde" button in the toolbar produces the standard Wikipedia signature style:
:--[[User:Iritscen|Iritscen]] 05:11, 11 June 2011 (CEST)


Having the time and date on your post makes discussions easier to follow, so please make it a habit to use the signature button.
Categories work the same way. Every page on the wiki should be placed into at least one category using this kind of markup at the end of the page: <code><nowiki>[[Category:Policies and documentation]]</nowiki></code>. This will cause the name of the category to appear at the bottom of the page. However, if you only want to link to a category page, not place the current page into that category, you use the same technique as linking to an image page: <code><nowiki>[[:Category:Policies and documentation]]</nowiki></code> gives you [[:Category:Policies and documentation]]. To see what categories are available, you can look at the [[Site Map]].


====Preview====
==Templates and transclusion==
Use the "Show preview" button ''as much as possible'' before submitting. Sure, even experienced and careful users have to make corrective edits sometimes, but newcomers to wikis are known for making numerous edits to a page in order to fix their mistakes. One reason this happens is that they do not make full use of the preview feature.
 
====Templates and transclusion====
Text can be "transcluded" from one place on the wiki to another using <nowiki>{{this markup}}</nowiki>. Transclusion means that whenever the original text is updated, so is the text inserted in place of the page link enclosed in double-braces.  Transclusion is most commonly used in order to place templates on a page.  Here's [[:Category:Templates|a list of templates]].  Pick one, and then click on "What links here" once you're on the template page.  You should see a list of pages, each one probably followed by "(transclusion)".  Look at the wiki code for those pages to see how the template's text or markup was placed into the page.
Text can be "transcluded" from one place on the wiki to another using <nowiki>{{this markup}}</nowiki>. Transclusion means that whenever the original text is updated, so is the text inserted in place of the page link enclosed in double-braces.  Transclusion is most commonly used in order to place templates on a page.  Here's [[:Category:Templates|a list of templates]].  Pick one, and then click on "What links here" once you're on the template page.  You should see a list of pages, each one probably followed by "(transclusion)".  Look at the wiki code for those pages to see how the template's text or markup was placed into the page.


Templates are not a special kind of wiki page; they're simply a term that we use to refer to pages that are meant to be transcluded.  Templates usually provide a standardized format for something like a [[:Template:Chapters|table]], or else they supply a standard [[:Template:Cleanup|header]] or [[:Template:OBD_File_Footer|footer]].  You should familiarize yourself with the templates if you plan to do a decent amount of editing; they are not only timesavers, they also help editors make their edits fit in with OniGalore standards.
Templates are not a special kind of wiki page; they're simply a term that we use to refer to pages that are meant to be transcluded.  Templates usually provide a standardized format for something like a [[:Template:Chapters|table]], or else they supply a standard [[:Template:Cleanup|header]] or [[:Template:OBD_File_Footer|footer]].  You should familiarize yourself with the templates if you plan to do a decent amount of editing; they are not only time-savers, they also help editors make their edits fit in with OniGalore standards, and make it easier to change large amounts of wiki text at once.
 
====Categories====
Categories ''are'' a special kind of wiki page. You can browse the page that explains the plan behind the categories [[User:Iritscen/CategoryTree|HERE]], or the actual categorized pages [[Site map|HERE]].  When making a new page (or uploading a file, which creates a file page), you should endeavor to apply the correct category to it by placing <nowiki>[[Category:Category name]]</nowiki> at the <u>very bottom</u> of the page's text. If you aren't sure, you can simply leave the page uncategorized and someone else will categorize it later.
 
====Uploaded files====
Images uploaded to the wiki cannot be grouped in folders smartly, as on your own computer, so keep in mind that proper naming and categorization are the only ways to tell, from a distance, what on earth your file is.
 
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:Real000.png|Real000.png]]
 
Please also place some kind of description in the Summary field if the file is not totally self-explanatory. The category markup, <nowiki>[[Category:Category name]]</nowiki>, goes in the Summary field of the Upload File screen, below any description you may have supplied.
 
 
----
----
 
===Various tips===
====Line formatting====
Everyone likes lists. Below are four methods for listing items, but there are also buttons available in the toolbar that make it faster to create these lists than typing the markup by hand. See the documentation for [[XEB]] to learn about the toolbar buttons.
 
'''Numbered lists'''<br />
#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'''<br />
*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'''<br />
: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)'''<br />
;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" can occur within an already indented paragraph :
:bla
::bla
::;BLA:bla
::bla
:bla
Custom indentation only works flawlessly when you use nothing but ":"; the ";" is a bit limited.
===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 (e.g., programming code).
The previous line is only empty in the rendered box; in the markup, there's a " " character.
    This one begins with 5 leading spaces in the markup; only 4 are there 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 in your text : is that ''really'' what you want?
:For regular indentation (like this line), prefer ":".
 


==Further Help==
==Further help==
Here's some more comprehensive help, straight from the source.
Here's some more comprehensive help, straight from the source.


;[[metawikipedia:Help:Reader|Reading]]
;[[metawikimedia:Help:Reader|Reading]]
:[[metawikipedia:Help:Go button|Go]] | [[metawikipedia:Help:Searching|Search]] | [[metawikipedia:Help:Common words, searching for which is not possible|Stop words]] | [[metawikipedia:Help:URL|URL]] | [[metawikipedia:Help:Namespace|Namespace]] | [[metawikipedia:Help:Page name|Page name]] | [[metawikipedia:Help:Section |Section]]
:[[metawikimedia:Help:Go button|Go]] | [[metawikimedia:Help:Searching|Search]] | [[metawikimedia:Help:Common words, searching for which is not possible|Stop words]] | [[metawikimedia:Help:URL|URL]] | [[metawikimedia:Help:Namespace|Namespace]] | [[metawikimedia:Help:Page name|Page name]] | [[metawikimedia:Help:Section |Section]]
:[[metawikipedia:Help:What links here|Backlinks]] | [[metawikipedia:Help:Link|Link]] | [[metawikipedia:Help:Piped link|Piped link]] | [[metawikipedia:Help:Interwiki linking|Interwiki link]] | [[metawikipedia:Help:Redirect|Redirect]] | [[metawikipedia:Help:Category|Category]] | [[metawikipedia:Help:Image page|Image page]]
:[[metawikimedia:Help:What links here|Backlinks]] | [[metawikimedia:Help:Link|Link]] | [[metawikimedia:Help:Piped link|Piped link]] | [[metawikimedia:Help:Interwiki linking|Interwiki link]] | [[metawikimedia:Help:Redirect|Redirect]] | [[metawikimedia:Help:Category|Category]] | [[metawikimedia:Help:Image page|Image page]]
;Logging in and preferences
;Logging in and preferences
:[[metawikipedia:Help:Logging in|Logging in]] | [[metawikipedia:help:Preferences|Preferences]] | [[metawikipedia:help:User style|User style]]
:[[metawikimedia:Help:Logging in|Logging in]] | [[metawikimedia:help:Preferences|Preferences]] | [[metawikimedia:help:User style|User style]]
;[[metawikipedia:Help:Editing|Editing]]
;[[metawikimedia:Help:Editing|Editing]]
:[[metawikipedia:Help:Advanced editing|Advanced editing]] | [[metawikipedia:Help:Editing FAQ|Editing FAQ]] | [[metawikipedia:Help:Edit toolbar|Edit toolbar]] | [[metawikipedia:Help:Export|Export]] | [[metawikipedia:Help:Import|Import]] | [[metawikipedia:Help:Editing shortcuts|Shortcuts]]  
:[[metawikimedia:Help:Advanced editing|Advanced editing]] | [[metawikimedia:Help:Editing FAQ|Editing FAQ]] | [[metawikimedia:Help:Edit toolbar|Edit toolbar]] | [[metawikimedia:Help:Export|Export]] | [[metawikimedia:Help:Import|Import]] | [[metawikimedia:Help:Editing shortcuts|Shortcuts]]  
;[[metawikipedia:Help:Tracking changes|Tracking changes]]
;[[metawikimedia:Help:Tracking changes|Tracking changes]]
:[[metawikipedia:Help:Recent changes|Recent changes]] <small>([[metawikipedia:Help:Enhanced recent changes|enhanced]])</small> | [[metawikipedia:Help:Related changes|Related changes]] | [[metawikipedia:Help:Watching pages|Watching pages]] | [[metawikipedia:Help:Diff|Diff]]
:[[metawikimedia:Help:Recent changes|Recent changes]] <small>([[metawikimedia:Help:Enhanced recent changes|enhanced]])</small> | [[metawikimedia:Help:Related changes|Related changes]] | [[metawikimedia:Help:Watching pages|Watching pages]] | [[metawikimedia:Help:Diff|Diff]]
:[[metawikipedia:Help:Page history|Page history]] | [[metawikipedia:Help:Edit summary|Edit summary]] | [[metawikipedia:Help:User contributions|User contributions]] | [[metawikipedia:Help:Minor edit|Minor edit]] | [[metawikipedia:Help:Patrolled edit|Patrolled edit]]
:[[metawikimedia:Help:Page history|Page history]] | [[metawikimedia:Help:Edit summary|Edit summary]] | [[metawikimedia:Help:User contributions|User contributions]] | [[metawikimedia:Help:Minor edit|Minor edit]] | [[metawikimedia:Help:Patrolled edit|Patrolled edit]]
;Style & formatting
;Style & formatting
:[[metawikipedia:Help:Wikitext examples|Wikitext examples]] | [[metawikipedia:Help:Reference card|Reference card]] | [[metawikipedia:Help:HTML in wikitext|HTML in wikitext]] | [[metawikipedia:Help:List|List]] | [[metawikipedia:Help:Table|Table]] | [[metawikipedia:Help:Sorting|Sorting]] | [[metawikipedia:Help:Text_color|Colors]]
:[[metawikimedia:Help:Wikitext examples|Wikitext examples]] | [[metawikimedia:Help:Reference card|Reference card]] | [[metawikimedia:Help:HTML in wikitext|HTML in wikitext]] | [[metawikimedia:Help:List|List]] | [[metawikimedia:Help:Table|Table]] | [[metawikimedia:Help:Sorting|Sorting]] | [[metawikimedia:Help:Text_color|Colors]]
;Special input and output
;Special input and output
:[http://www.mediawiki.org/wiki/Extension:Inputbox Inputbox] | [[metawikipedia:Help:Special characters|Special characters]] | [[metawikipedia:Help:Displaying a formula|Displaying a formula]] | [[metawikipedia:Help:Images and other uploaded files|Images<small> (uploads)</small>]] | [http://www.mediawiki.org/wiki/Extension:EasyTimeline/syntax EasyTimeline]
:[http://www.mediawiki.org/wiki/Extension:Inputbox Inputbox] | [[metawikimedia:Help:Special characters|Special characters]] | [[metawikimedia:Help:Displaying a formula|Displaying a formula]] | [[metawikimedia:Help:Images and other uploaded files|Images<small> (uploads)</small>]] | [http://www.mediawiki.org/wiki/Extension:EasyTimeline/syntax EasyTimeline]
;Advanced functioning
;Advanced functioning
:[[metawikipedia:Help:Template|Template]] | [[metawikipedia:Help:Advanced templates|Advanced templates]] | [[metawikipedia:Help:Parser function|Parser function]] | [[metawikipedia:Help:ParserFunctions|ParserFunctions]] | [[metawikipedia:Help:Parameter default|Parameter default]]
:[[metawikimedia:Help:Template|Template]] | [[metawikimedia:Help:Advanced templates|Advanced templates]] | [[metawikimedia:Help:Parser function|Parser function]] | [[metawikimedia:Help:ParserFunctions|ParserFunctions]] | [[metawikimedia:Help:Parameter default|Parameter default]]
:[[metawikipedia:Help:Variable|Variable]] | [http://www.mediawiki.org/wiki/Help:Magic_words Magic word] | [[metawikipedia:Help:System message|System message]] | [[metawikipedia:Help:Substitution|Substitution]] | [[metawikipedia:Help:Array|Array]] | [[metawikipedia:Help:Calculation|Calculation]]
:[[metawikimedia:Help:Variable|Variable]] | [http://www.mediawiki.org/wiki/Help:Magic_words Magic word] | [[metawikimedia:Help:System message|System message]] | [[metawikimedia:Help:Substitution|Substitution]] | [[metawikimedia:Help:Array|Array]] | [[metawikimedia:Help:Calculation|Calculation]]
;Page management
;Page management
:[[metawikipedia:Help:Starting a new page|Starting a new page]] | [[metawikipedia:Help:Moving a page|Renaming (moving) a page]] | [http://www.mediawiki.org/wiki/Manual:Administrators#Protection Protecting pages] | [[metawikipedia:Help:Deleting a page|Deleting a page]]
:[[metawikimedia:Help:Starting a new page|Starting a new page]] | [[metawikimedia:Help:Moving a page|Renaming (moving) a page]] | [http://www.mediawiki.org/wiki/Manual:Administrators#Protection Protecting pages] | [[metawikimedia:Help:Deleting a page|Deleting a page]]
;[[metawikipedia:Help:Special page|Special pages]]
;[[metawikimedia:Help:Special page|Special pages]]
:[[metawikipedia:Help:Talk page|Talk page]] | [[metawikipedia:Help:Testing|Testing]] | [[Test|Sandbox]]
:[[metawikimedia:Help:Talk page|Talk page]] | [[metawikimedia:Help:Testing|Testing]] | [[Test|Sandbox]]




[[Category:Policies and documentation]]
[[Category:Policies and documentation]]

Revision as of 19:13, 4 August 2017

After reading this page, please see our rules on the OniGalore:Policy page.

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 that will mostly get you by, when it comes to our wiki. For more details, see the section Further Help below. Wikimedia's general Help is also available in Italian and Russian, as well as many other languages. That is where you'll find the most detailed info on the MediaWiki software.

Text formatting

Common formatting

The most common way to emphasize or set apart some text in a line is to use apostrophes to create italicized and bold text:
''Using two'' will give you italics.
'''Using three''' will give you bold.

Underlining text is not as convenient; it requires you to fall back to raw HTML markup:
<u>Here's the underline tag</u> gives you Here's the underline tag.

Finally, although we have not been in the habit of using it on OniGalore, you can highlight text with the mark tag:
<mark>Pay attention</mark> yields Pay attention.

Monospace and unformatted text

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 (e.g., programming code).

The previous line is only empty in the rendered box; if you edit this page, you'll see the " " character in the wiki markup.
You can still put text in italics, bold, or bold italics.
However, leading "*", "#", ":" and ";" won't work :
*bla
#bla
;bla
:bla
For regular indentation (like this line), you should start the line with ":" as shown below.

There are several other options, the <pre>, <tt>, <code>, and <nowiki> tags, which will not be discussed in-depth here, but play around with them to see how they behave slightly differently from each other.

Line formatting

Everyone likes lists. Below are four methods for listing items, but there are also buttons available in the toolbar that make it faster to create these lists than typing the markup by hand. See the documentation for XEB to learn about the toolbar buttons.

Normal newlines
A quirk of wiki markup is that two consecutive lines will be displayed as one line. In other words, a single newline is ignored. This actually goes back to the fact that wiki markup is based on HTML, which behaves the same way. Instead of hitting Return once to start a new line, you need to hit it twice. Alternately, you can force a linebreak at any time with the <br /> tag.

Numbered lists

  1. This line actually begins with a "#" character.
    1. This line actually begins with two "#" characters.
    2. So does this one.
  2. Here's the next single-"#" line.

Bulleted lists

  • This line actually begins with a "*" character.
    • This line begins with two "*" characters.

Indented paragraphs

This line begins with a ":" character. The whole paragraph will wrap around using this indentation.
When starting a second indented line, you don't need to put an extra newline after the previous line like you normally would.
The more ":"s you put at the start of the line, the more indentation you get.

Titled paragraphs

This line starts with a ";"
Starting the next line with a ":" creates the impression of a paragraph under a title, useful for typesetting word definitions, dialogue lines, etc.

Links

Basically, there are thee types of links: (1) links to external pages and files, (2) intrawiki links to other pages on the wiki, and (3) interwiki links.

External links

(1a) Write the following to get some text acting as an outgoing hyperlink.

[http://oni.bungie.org/community/forum/ here is our forum]

The result is: here is our forum

(1b) If you omit the label text, the result will be different:

Here [http://oni.bungie.org/community/forum/] is our forum

The result is: here [1] is our forum. However, this is not part of our usual style on this wiki. You should always label your links.

(1c) You can also write URLs without any markup. Like this:

Here is our forum: http://oni.bungie.org/community/forum/

Note that external images will appear inline if you use their bare URL like this.

Intrawiki links

(2a) Write the following to get an intrawiki link to one of our own pages:

[[Quotes/Consoles#STURMANDERUNG_:_Final_Stage]]

The result is this: Quotes/Consoles#STURMANDERUNG_:_Final_Stage

(2b) Write following to get an intrawiki link which is labeled with some text:

[[OniSplit#Download_links|here you can download onisplit]]

The result is this: You can download OniSplit here

This kind of link (2a/2b) spares you from writing http://wiki.oni2.net/OniSplit#Download_links

Interwiki links

You can link to pages on Wiktionary, the English Wikipedia and Meta-Wiki as if they were pages of our own wiki, using the prefixes wiktionary:, wikipedia: and metawikimedia:. When you make an interwiki link, the outbound link icon changes from an upward arrow to a sideward arrow to show that you are linking to a fellow wiki, not some random web site.

An example of using an interwiki prefix would be [[wikipedia:Test]], which produces wikipedia:Test (you can supply alternate text using the syntax [[wikipedia:Test|Test]] to get rid of that pesky prefix in the final markup: Test). These prefixes accept language codes, so you could use the markup [[wikipedia:de:Test|Test]] to link to the German article Test (the URL will appear wrong, but Wikipedia knows what it means).

All of the Wikimedia Foundation's projects have prefixes available for linking to them. Also note that we have handy shortcuts for the two most-used prefixes; wikipedia: can be shortened to wp: and wiktionary: can be shortened to wikt:. The complete list of currently supported interwiki links can be obtained by clicking here.

Looking at the list, you'll see that some prefixes are not actually for other wikis, but general web shortcuts; google: produces a Google search query for the provided search term, and cache: produces a Google page cache query for the provided URL.

Images and categories

To place an image, you type its name inside of double brackets, preceded by "Image:", e.g. [[Image:TXMPPOSTER3.png]]. This markup will be replaced by the named image. If you only want to link to the page of an image, you type [[:Image:TXMPPOSTER3.png]] to get Image:TXMPPOSTER3.png.

Categories work the same way. Every page on the wiki should be placed into at least one category using this kind of markup at the end of the page: [[Category:Policies and documentation]]. This will cause the name of the category to appear at the bottom of the page. However, if you only want to link to a category page, not place the current page into that category, you use the same technique as linking to an image page: [[:Category:Policies and documentation]] gives you Category:Policies and documentation. To see what categories are available, you can look at the Site Map.

Templates and transclusion

Text can be "transcluded" from one place on the wiki to another using {{this markup}}. Transclusion means that whenever the original text is updated, so is the text inserted in place of the page link enclosed in double-braces. Transclusion is most commonly used in order to place templates on a page. Here's a list of templates. Pick one, and then click on "What links here" once you're on the template page. You should see a list of pages, each one probably followed by "(transclusion)". Look at the wiki code for those pages to see how the template's text or markup was placed into the page.

Templates are not a special kind of wiki page; they're simply a term that we use to refer to pages that are meant to be transcluded. Templates usually provide a standardized format for something like a table, or else they supply a standard header or footer. You should familiarize yourself with the templates if you plan to do a decent amount of editing; they are not only time-savers, they also help editors make their edits fit in with OniGalore standards, and make it easier to change large amounts of wiki text at once.

Further help

Here's some more comprehensive help, straight from the source.

Reading
Go | Search | Stop words | URL | Namespace | Page name | Section
Backlinks | Link | Piped link | Interwiki link | Redirect | Category | Image page
Logging in and preferences
Logging in | Preferences | User style
Editing
Advanced editing | Editing FAQ | Edit toolbar | Export | Import | Shortcuts
Tracking changes
Recent changes (enhanced) | Related changes | Watching pages | Diff
Page history | Edit summary | User contributions | Minor edit | Patrolled edit
Style & formatting
Wikitext examples | Reference card | HTML in wikitext | List | Table | Sorting | Colors
Special input and output
Inputbox | Special characters | Displaying a formula | Images (uploads) | EasyTimeline
Advanced functioning
Template | Advanced templates | Parser function | ParserFunctions | Parameter default
Variable | Magic word | System message | Substitution | Array | Calculation
Page management
Starting a new page | Renaming (moving) a page | Protecting pages | Deleting a page
Special pages
Talk page | Testing | Sandbox