Help:Editing: Difference between revisions
m (link fix) |
(changed sample OCF links (RIP OCF); removed some niche advice on specific templates; various wording) |
||
(7 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{ | {{PoliciesSidebox}} | ||
Below is a selected set of tips that will get you started editing any wiki that's powered by the MediaWiki software. Basic tips are followed by {{SectionLink||Advanced tricks}} that we've used on the wiki. For additional reading, see {{SectionLink||Further help}} which directs to pages on Wikimedia Foundation's sites (the developer of MediaWiki). Their general [[metawikimedia:Help:Contents|Help pages]] are available in [[wp:it:Aiuto:Aiuto|Italian]], [[wp:ru:Википедия:Справка|Russian]] and many other languages. That is where you'll find the most detailed and up-to-date info on editing a MediaWiki wiki. | |||
==Text formatting== | ==Text formatting== | ||
Line 10: | Line 10: | ||
Underlining text is not as convenient; it requires you to fall back to raw HTML markup:<br /> | 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>. | <code><nowiki><u>Here's the underline tag</u></nowiki></code> gives you <u>Here's the underline tag</u>. | ||
===Monospace and unformatted text=== | ===Monospace and unformatted text=== | ||
Line 62: | Line 59: | ||
===External 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> | '''['''<nowiki>https://discord.com/invite/eqDMnkD here is our Discord server</nowiki>''']''' | ||
The result is: [ | The result is: [https://discord.com/invite/eqDMnkD here is our Discord server] | ||
(1b) If you omit the label text, the result will be different: | (1b) If you omit the label text, the result will be different: | ||
here '''['''<nowiki>https://discord.com/invite/eqDMnkD</nowiki>''']''' is our Discord server | |||
The result is: here [ | The result is: here [https://discord.com/invite/eqDMnkD] is our Discord server. However, this is not 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 | :Here is our Discord server: https://discord.com/invite/eqDMnkD | ||
Note that external images will appear inline if you use their bare URL like this. | Note that external images will appear inline if you use their bare URL like this. | ||
===Intrawiki links=== | ===Intrawiki links=== | ||
(2a) | "Intrawiki" refers to links to other pages on this wiki. | ||
(2a) Simply write the following to get an intrawiki link: | |||
<nowiki>[[Quotes/Consoles#STURMANDERUNG_:_Final_Stage]]</nowiki> | <nowiki>[[Quotes/Consoles#STURMANDERUNG_:_Final_Stage]]</nowiki> | ||
Line 80: | Line 79: | ||
The result is this: [[Quotes/Consoles#STURMANDERUNG_:_Final_Stage]] | The result is this: [[Quotes/Consoles#STURMANDERUNG_:_Final_Stage]] | ||
(2b) Write following to get an | (2b) Write the following to get an intrawiki link which is labeled with some text: | ||
<nowiki>[[OniSplit#Download_links|You can download OniSplit here]]</nowiki> | <nowiki>[[OniSplit#Download_links|You can download OniSplit here]]</nowiki> | ||
Line 86: | Line 85: | ||
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 | This kind of link spares you from writing '''<nowiki>http://wiki.oni2.net/</nowiki>OniSplit#Download_links''', and also allows various features of the wiki to work properly, such as "What links here" and the [[Special:LonelyPages|orphaned pages]] list. | ||
=== | ===Interwiki links=== | ||
You can link to pages on wikis in the Wikimedia family, e.g. [[wikt:Wiktionary:Main_Page|Wiktionary]], [[wp:Main_Page|Wikipedia]] and [[metawikimedia:Main_Page|Meta-Wiki]], as if they were pages of our own wiki by adding the shortcuts '''<nowiki>wiktionary:</nowiki>''', '''<nowiki>wikipedia:</nowiki>''' and '''<nowiki>metawikimedia:</nowiki>''' within double brackets. 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 label 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]]. | |||
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 [https://wiki.oni2.net/w/api.php?action=query&meta=siteinfo&siprop=interwikimap 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. <code><nowiki>[[Image:TXMPPOSTER3.png]]</nowiki></code>. This markup will be replaced by the named image. If you only want to link to an image, not display it, you type <code><nowiki>[[:Image:TXMPPOSTER3.png]]</nowiki></code> 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, placed 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]]. | |||
==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. [[:Category:Templates|Here's a list of our wiki's templates.]] Click on one, and then click on "What links here": you should see a list of pages, each one probably followed by "(transclusion)". Look at the wiki markup for those pages to see how the template was utilized on 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, and which often use magic words (terms with special meaning to the MediaWiki parser) to provide logic (but again, this logic can be used on any page). Templates usually provide a standardized format for something like a table, header or footer, e.g. [[:Template:OBD File Footer]]. You should familiarize yourself with our templates if you plan to do a decent amount of editing; they are not only time-savers but 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. | |||
==Tables== | |||
MediaWiki provides simple markup for creating HTML tables that avoids the need to create lots of <code><nowiki><tr></nowiki></code> and <code><nowiki><td></nowiki></code> tags, though the results are also somewhat more limited than a pure HTML table. To open a table simply write <code><nowiki>{|</nowiki></code>, optionally declare column names with <code><nowiki>!</nowiki></code>, then declare new rows with <code><nowiki>|-</nowiki></code> and new cells within a row with <code><nowiki>|</nowiki></code>. This markup… | |||
<pre> | |||
{| | |||
!Column 1 | |||
!Column 2 | |||
|- | |||
|R1C1 | |||
|R1C2 | |||
|- | |||
|R2C1 | |||
|R2C2 | |||
|}</pre> | |||
…produces this table: | |||
{| | |||
!Column 1 | |||
!Column 2 | |||
|- | |||
|R1C1 | |||
|R1C2 | |||
|- | |||
|R2C1 | |||
|R2C2 | |||
|} | |||
Normally we apply the class "wikitable" to a table to give it borders and make it look pretty with <code>{| class="wikitable"</code>, though you can do a lot of manual styling for almost any custom look you want (see {{SectionLink||Further help}} to read more about tables). | |||
To make the table a fixed width, add this CSS styling to the first line: <code>{| style="width:500px;"</code>. You can also use a percentage such as <code>width:50%;</code>. To center the table on the page, use <code>{| style="margin-left:auto; margin-right:auto;"</code>. To right-align it, use <code>"float:right;"</code> instead. | |||
You can add styling directives to individual columns, rows and cells like this: | |||
<pre> | |||
{| class="wikitable" | |||
!width="200"|Column 1 | |||
!Column 2 | |||
|- style="font-size:75%;" | |||
|R1C1 | |||
|R1C2 | |||
|- | |||
|colspan="2" align="center" style="height:40px; background:DarkSeaGreen;" valign="top"|R2C1&2 | |||
|}</pre> | |||
…which yields: | |||
{| class="wikitable" | |||
!width="200"|Column 1 | |||
!Column 2 | |||
|- style="font-size:75%;" | |||
|R1C1 | |||
|R1C2 | |||
|- | |||
|colspan="2" align="center" style="height:40px; background:DarkSeaGreen;" valign="top"|R2C1&2 | |||
|} | |||
For more advanced table markup, see below. | |||
==Advanced tricks== | |||
Some of these "tricks" are very simple in practice, but hard to remember. This is basically a list of bookmarks to helpful examples around the wiki: | |||
*Alphabetic footnotes: [[Quotes/Manual]] | |||
*Indenting wrapped text: [[Walkthrough]] | |||
*Justified text: [[Oni2:Aftermath]] | |||
*Math extension usage: [[OBD:SNDD]], [[XML:OBAN]] | |||
*Multicolumn text: [[User:Iritscen]] | |||
*Retitling a page: [[Template:Retitle]] | |||
*Separating footnotes and citations on an article: [[Oni]] | |||
*Tables: | |||
**Advanced styling: [[Template:OBD File Header]] | |||
**Aesthetic designs: [[Template:PoliciesSidebox]], [[Anniversary Edition]] | |||
**Hideable columns: [[OBD:Versions]] | |||
**Multipart tables: [[Rights]] | |||
**Multirow sortable groups: {{SectionLink|Videos|Full playthroughs}} | |||
**Sortable columns: [[Oni 2 (Angel Studios)/Levels]] | |||
==Further help== | ==Further help== | ||
Here's some more comprehensive help, straight from the source. | Here's some more comprehensive help, straight from the source. | ||
; | ;Reading | ||
:[[metawikimedia:Help:Go button|Go]] | [[metawikimedia:Help:Searching|Search]] | [[metawikimedia:Help:URL|URL]] | [[mw:Help:Namespaces|Namespace]] | [[metawikimedia:Help:Page name|Page name]] | [[metawikimedia:Help:Section|Section]] | [[mw:Help:What links here|Backlinks]] | :[[metawikimedia:Help:Go button|Go]] | [[metawikimedia:Help:Searching|Search]] | [[metawikimedia:Help:URL|URL]] | [[mw:Help:Namespaces|Namespace]] | [[metawikimedia:Help:Page name|Page name]] | [[metawikimedia:Help:Section|Section]] | [[mw:Help:What links here|Backlinks]] | ||
:[[metawikimedia:Help:Link|Link]] | [[metawikimedia:Help:Piped link|Piped link]] | [[metawikimedia:Help:Interwiki linking|Interwiki link]] | [[metawikimedia: | :[[metawikimedia:Help:Link|Link]] | [[metawikimedia:Help:Piped link|Piped link]] | [[metawikimedia:Help:Interwiki linking on Wikimedia wikis|Interwiki link]] | [[metawikimedia:Redirects|Redirect]] | [[mw:Help:Categories|Category]] | [[metawikimedia:Help:Image page|Image page]] | ||
;Logging in and preferences | ;Logging in and preferences | ||
:[[metawikimedia:Help:Logging in|Logging in]] | [[mw:Help:Preferences|Preferences]] | [[metawikimedia:Help:User style|User style]] | :[[metawikimedia:Help:Logging in|Logging in]] | [[mw:Help:Preferences|Preferences]] | [[metawikimedia:Help:User style|User style]] | ||
Line 143: | Line 203: | ||
:[[mw:Help:Starting a new page|Starting a new page]] | [[metawikimedia:Help:Moving a page|Renaming (moving) a page]] | [[mw:Manual:Administrators#Protection|Protecting pages]] | [[mw:Help:History#Deleting a page|Deleting a page]] | :[[mw:Help:Starting a new page|Starting a new page]] | [[metawikimedia:Help:Moving a page|Renaming (moving) a page]] | [[mw:Manual:Administrators#Protection|Protecting pages]] | [[mw:Help:History#Deleting a page|Deleting a page]] | ||
;[[metawikimedia:Help:Special page|Special pages]] | ;[[metawikimedia:Help:Special page|Special pages]] | ||
:[[metawikimedia:Help:Talk page|Talk | :[[metawikimedia:Help:Talk page|Talk pages]] | ||
[[Category:Policies and documentation]] | [[Category:Policies and documentation]] |
Latest revision as of 17:43, 18 April 2025
OniGalore Policies and Help | |
About Us | Code of Conduct |
Editing Help | Dos and Don'ts |
| |
Disclaimers | Privacy Policy |
Copyrights | User Groups |
Below is a selected set of tips that will get you started editing any wiki that's powered by the MediaWiki software. Basic tips are followed by § Advanced tricks that we've used on the wiki. For additional reading, see § Further help which directs to pages on Wikimedia Foundation's sites (the developer of MediaWiki). Their general Help pages are available in Italian, Russian and many other languages. That is where you'll find the most detailed and up-to-date info on editing a MediaWiki wiki.
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.
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.
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
- 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
- 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.
[https://discord.com/invite/eqDMnkD here is our Discord server]
The result is: here is our Discord server
(1b) If you omit the label text, the result will be different:
here [https://discord.com/invite/eqDMnkD] is our Discord server
The result is: here [1] is our Discord server. However, this is not 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 Discord server: https://discord.com/invite/eqDMnkD
Note that external images will appear inline if you use their bare URL like this.
Intrawiki links
"Intrawiki" refers to links to other pages on this wiki.
(2a) Simply write the following to get an intrawiki link:
[[Quotes/Consoles#STURMANDERUNG_:_Final_Stage]]
The result is this: Quotes/Consoles#STURMANDERUNG_:_Final_Stage
(2b) Write the following to get an intrawiki link which is labeled with some text:
[[OniSplit#Download_links|You can download OniSplit here]]
The result is this: You can download OniSplit here
This kind of link spares you from writing http://wiki.oni2.net/OniSplit#Download_links, and also allows various features of the wiki to work properly, such as "What links here" and the orphaned pages list.
Interwiki links
You can link to pages on wikis in the Wikimedia family, e.g. Wiktionary, Wikipedia and Meta-Wiki, as if they were pages of our own wiki by adding the shortcuts wiktionary:, wikipedia: and metawikimedia: within double brackets. 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 label 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.
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 an image, not display it, 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, placed 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 our wiki's templates. Click on one, and then click on "What links here": you should see a list of pages, each one probably followed by "(transclusion)". Look at the wiki markup for those pages to see how the template was utilized on 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, and which often use magic words (terms with special meaning to the MediaWiki parser) to provide logic (but again, this logic can be used on any page). Templates usually provide a standardized format for something like a table, header or footer, e.g. Template:OBD File Footer. You should familiarize yourself with our templates if you plan to do a decent amount of editing; they are not only time-savers but 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.
Tables
MediaWiki provides simple markup for creating HTML tables that avoids the need to create lots of <tr>
and <td>
tags, though the results are also somewhat more limited than a pure HTML table. To open a table simply write {|
, optionally declare column names with !
, then declare new rows with |-
and new cells within a row with |
. This markup…
{| !Column 1 !Column 2 |- |R1C1 |R1C2 |- |R2C1 |R2C2 |}
…produces this table:
Column 1 | Column 2 |
---|---|
R1C1 | R1C2 |
R2C1 | R2C2 |
Normally we apply the class "wikitable" to a table to give it borders and make it look pretty with {| class="wikitable"
, though you can do a lot of manual styling for almost any custom look you want (see § Further help to read more about tables).
To make the table a fixed width, add this CSS styling to the first line: {| style="width:500px;"
. You can also use a percentage such as width:50%;
. To center the table on the page, use {| style="margin-left:auto; margin-right:auto;"
. To right-align it, use "float:right;"
instead.
You can add styling directives to individual columns, rows and cells like this:
{| class="wikitable" !width="200"|Column 1 !Column 2 |- style="font-size:75%;" |R1C1 |R1C2 |- |colspan="2" align="center" style="height:40px; background:DarkSeaGreen;" valign="top"|R2C1&2 |}
…which yields:
Column 1 | Column 2 |
---|---|
R1C1 | R1C2 |
R2C1&2 |
For more advanced table markup, see below.
Advanced tricks
Some of these "tricks" are very simple in practice, but hard to remember. This is basically a list of bookmarks to helpful examples around the wiki:
- Alphabetic footnotes: Quotes/Manual
- Indenting wrapped text: Walkthrough
- Justified text: Oni2:Aftermath
- Math extension usage: OBD:SNDD, XML:OBAN
- Multicolumn text: User:Iritscen
- Retitling a page: Template:Retitle
- Separating footnotes and citations on an article: Oni
- Tables:
- Advanced styling: Template:OBD File Header
- Aesthetic designs: Template:PoliciesSidebox, Anniversary Edition
- Hideable columns: OBD:Versions
- Multipart tables: Rights
- Multirow sortable groups: Videos § Full playthroughs
- Sortable columns: Oni 2 (Angel Studios)/Levels
Further help
Here's some more comprehensive help, straight from the source.
- Reading
- Go | Search | 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 | Parameter default | Magic word
- ParserFunctions | Substitution | Array | Calculation | System message
- Page management
- Starting a new page | Renaming (moving) a page | Protecting pages | Deleting a page
- Special pages
- Talk pages