Difference between revisions of "Wiki editing guide"
m (Missed a </nowiki>) |
(→Deleting pages and vandalism) |
||
(14 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
UrW wiki uses [https://www.mediawiki.org/wiki/MediaWiki MediaWiki] which has a lot of helpful guides and tutorials on [https://www.mediawiki.org/wiki/Help:Editing_pages how to edit a page]. Another useful source for tutorials are [https://en.wikipedia.org/wiki/Help:Contents Wikipedia's] help pages. In this guide, I try to list some useful tips for editing a page and I'll also add links to mediawiki's help page on the subject in the section headers'. In UrW wiki, edits are limited to registered users to avoid vandalism. | UrW wiki uses [https://www.mediawiki.org/wiki/MediaWiki MediaWiki] which has a lot of helpful guides and tutorials on [https://www.mediawiki.org/wiki/Help:Editing_pages how to edit a page]. Another useful source for tutorials are [https://en.wikipedia.org/wiki/Help:Contents Wikipedia's] help pages. In this guide, I try to list some useful tips for editing a page and I'll also add links to mediawiki's help page on the subject in the section headers'. In UrW wiki, edits are limited to registered users to avoid vandalism. | ||
− | An even shorter guide is wikipedia's [[wikipedia:Help:Cheatsheet| | + | An even shorter guide is wikipedia's [[wikipedia:Help:Cheatsheet|cheatsheet]]. |
==Quick wiki guide== | ==Quick wiki guide== | ||
− | After you're logged in, you can press the edit tab on the top of an article, or the edit links available next to sections. Also, when clicking a red link, i.e. a link to page that doesn't exist, you are taken to the edit tab of that article. | + | After you're logged in, you can press the ''edit'' tab on the top of an article, or the ''edit'' links available next to sections. Also, when clicking a red link, i.e. a link to page that doesn't exist, you are taken to the edit tab of that article. |
+ | |||
For the most part, editing the wiki is really easy: most of the editing is simply writing text, and if you don't know how to do something, you can just check how it's done in another page (or another mediawiki altogether). Links to other articles in the wiki are generally just words in square brackets, and infoboxes are also often easy to update, you'll just have to find the correct variable to modify (or add it if it's missing). Tables and images/files are a bit more tricky. | For the most part, editing the wiki is really easy: most of the editing is simply writing text, and if you don't know how to do something, you can just check how it's done in another page (or another mediawiki altogether). Links to other articles in the wiki are generally just words in square brackets, and infoboxes are also often easy to update, you'll just have to find the correct variable to modify (or add it if it's missing). Tables and images/files are a bit more tricky. | ||
+ | |||
+ | By the way, you can use the <code><nowiki><nowiki></nowiki></nowiki></code> tags to escape wiki markup. | ||
+ | |||
+ | |||
+ | After you've finished editing, or you just want to know how the page looks now, press the ''Show preview'' button at the bottom. This will show a preview of the page with your edits and the edit box will still be at the bottom of the page. After previewing your changes, you should write a short description of what you did in the ''summary'' box. If you only added links or fixed typos or broken links then you should check the ''This is a minor edit box''. When you've previewed and described your edits, press the ''Save page'' button | ||
+ | |||
Next up are some quick tips to things you'll find in the wiki including links, tables, images, templates and infoboxes. | Next up are some quick tips to things you'll find in the wiki including links, tables, images, templates and infoboxes. | ||
− | |||
===[https://en.wikipedia.org/wiki/Help:Wiki_markup Headers and general markup]=== | ===[https://en.wikipedia.org/wiki/Help:Wiki_markup Headers and general markup]=== | ||
− | When editing an article, you may want to divide it into sections and subsections and even subsubsections. Section headers are text written between a number of = signs, e.g. | + | When editing an article, you may want to divide it into sections and subsections and even subsubsections. Section headers are text written between a number of <code>=</code> signs, e.g. |
− | * <nowiki>==Quick wiki guide==</nowiki> is the level 2 header which is the biggest header that should be used when editing. | + | * <code><nowiki>==Quick wiki guide==</nowiki></code> is the level 2 header which is the biggest header that should be used when editing. |
− | * <nowiki>===Links===</nowiki> are the subsection headers in this guide. | + | * <code><nowiki>===Links===</nowiki></code> are the subsection headers in this guide. |
− | * <nowiki>====Infoboxes====</nowiki> You'll rarely need headers this size or smaller. | + | * <code><nowiki>====Infoboxes====</nowiki></code> You'll rarely need headers this size or smaller. |
You can italicize text by using <nowiki>''</nowiki> on both sides of the word or words you want to italicize. Bolding text works similarly but you'll just use <nowiki>'''</nowiki> instead. For example: | You can italicize text by using <nowiki>''</nowiki> on both sides of the word or words you want to italicize. Bolding text works similarly but you'll just use <nowiki>'''</nowiki> instead. For example: | ||
− | * <nowiki>''Italic text''</nowiki> gives ''Italic text'' | + | * <code><nowiki>''Italic text''</nowiki></code> gives ''Italic text'' |
− | * <nowiki>'''Bold text'''</nowiki> gives '''Bold text''' | + | * <code><nowiki>'''Bold text'''</nowiki></code> gives '''Bold text''' |
− | You can force the end of a section with <nowiki><div style="clear: both"></div></nowiki>, e.g. if you have images you want to have in a certain section. There's an example of how images work if the section is not ended in the images section of this article. | + | You can force the end of a section with <code><nowiki><div style="clear: both"></div></nowiki></code>, e.g. if you have images you want to have in a certain section. There's an example of how images work if the section is not ended in the images section of this article. |
===[https://www.mediawiki.org/wiki/Help:Links Links]=== | ===[https://www.mediawiki.org/wiki/Help:Links Links]=== | ||
Line 32: | Line 38: | ||
Links to other pages in the wiki are marked by writing a pair of square brackets on both sides of the other article's title, e.g. | Links to other pages in the wiki are marked by writing a pair of square brackets on both sides of the other article's title, e.g. | ||
− | * <nowiki>[[Watercraft]]</nowiki> Links to the page [[Watercraft]] | + | * <code><nowiki>[[Watercraft]]</nowiki></code> Links to the page [[Watercraft]] |
− | * <nowiki>[[Watercraft]]s</nowiki> Also links to the page [[Watercraft]]. This time the link looks like this though: [[Watercraft]]s | + | * <code><nowiki>[[Watercraft]]s</nowiki></code> Also links to the page [[Watercraft]]. This time the link looks like this though: [[Watercraft]]s |
− | * <nowiki>[[Watercraft|punts and rafts]]</nowiki> Also links to the page [[Watercraft]]. The page that the link is to is simply separated by a | sign and the actual link looks like this: [[Watercraft|punts and rafts]]. | + | * <code><nowiki>[[Watercraft|punts and rafts]]</nowiki></code> Also links to the page [[Watercraft]]. The page that the link is to is simply separated by a | sign and the actual link looks like this: [[Watercraft|punts and rafts]]. |
− | * <nowiki>[[Linen undershirt]]</nowiki> Links to the page [[Linen undershirt]] | + | * <code><nowiki>[[Linen undershirt]]</nowiki></code> Links to the page [[Linen undershirt]] |
− | * <nowiki>[[Linen Undershirt]]</nowiki> Notice the capital letter in Undershirt. This links to the page [[Linen Undershirt&redirect=no|Linen Undershirt]] which is different than the previous page and doesn't exist or is a redirect. | + | * <code><nowiki>[[Linen Undershirt]]</nowiki></code> Notice the capital letter in Undershirt. This links to the page [[Linen Undershirt&redirect=no|Linen Undershirt]] which is different than the previous page and doesn't exist or is a redirect. |
To remedy situations where the same page has title or spelling variations, redirect pages can be created. For example, the ''Linen Undershirt'' page could be redirected to the existing ''Linen undershirt'' page like this: | To remedy situations where the same page has title or spelling variations, redirect pages can be created. For example, the ''Linen Undershirt'' page could be redirected to the existing ''Linen undershirt'' page like this: | ||
− | * <nowiki>#REDIRECT:[[Linen undershirt]]</nowiki> | + | * <code><nowiki>#REDIRECT:[[Linen undershirt]]</nowiki></code> |
External links can be written in multiple ways: | External links can be written in multiple ways: | ||
− | * <nowiki>https://www.mediawiki.org/wiki/Help:Links</nowiki> gives https://www.mediawiki.org/wiki/Help:Links | + | * <code><nowiki>https://www.mediawiki.org/wiki/Help:Links</nowiki></code> gives https://www.mediawiki.org/wiki/Help:Links |
− | * <nowiki>[https://www.mediawiki.org/wiki/Help:Links MediaWiki link help]</nowiki> gives [https://www.mediawiki.org/wiki/Help:Links MediaWiki link help] | + | * <code><nowiki>[https://www.mediawiki.org/wiki/Help:Links MediaWiki link help]</nowiki></code> gives [https://www.mediawiki.org/wiki/Help:Links MediaWiki link help] |
− | * <nowiki>[[wikipedia:Unreal World|UnReal World]]</nowiki> gives [[wikipedia:Unreal world|UnReal World]] | + | * <code><nowiki>[[wikipedia:Unreal World|UnReal World]]</nowiki></code> gives [[wikipedia:Unreal world|UnReal World]] |
− | + | ||
===[https://www.mediawiki.org/wiki/Help:Images Images]=== | ===[https://www.mediawiki.org/wiki/Help:Images Images]=== | ||
Line 54: | Line 59: | ||
Some examples from the wiki: | Some examples from the wiki: | ||
− | * <nowiki>[[File:Settlement collage.png|frame|right|border|Types of settlements clockwise from top left: village, single house, fortified village and kota camp.]]</nowiki> gives the image from the [[Settlement]] article. [[File:Settlement collage.png|frame|right|border|Types of settlements clockwise from top left: village, single house, fortified village and kota camp.]] | + | * <code><nowiki>[[File:Settlement collage.png|frame|right|border|Types of settlements clockwise from top left: village, single house, fortified village and kota camp.]]</nowiki></code> gives the image from the [[Settlement]] article. [[File:Settlement collage.png|frame|right|border|Types of settlements clockwise from top left: village, single house, fortified village and kota camp.]] |
− | * <nowiki>[[File:Fat.png | + | * <code><nowiki>[[File:Fat.png|24px|Chunk of fat]]</nowiki></code> gives the [[File:Fat.png|24px|Chunk of fat]] image from the [[Fat]] article. |
− | + | ||
===[https://www.mediawiki.org/wiki/Help:Tables Tables]=== | ===[https://www.mediawiki.org/wiki/Help:Tables Tables]=== | ||
Line 63: | Line 67: | ||
Here's an example of how a simple table looks in wiki markup: | Here's an example of how a simple table looks in wiki markup: | ||
− | <pre> | + | {| |
+ | |<pre> | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
Line 76: | Line 81: | ||
|} | |} | ||
</pre> | </pre> | ||
+ | |} | ||
The same table without <nowiki><pre></pre></nowiki> tags used to prevent the table from being drawn: | The same table without <nowiki><pre></pre></nowiki> tags used to prevent the table from being drawn: | ||
Line 89: | Line 95: | ||
|row 3 cell 2 | |row 3 cell 2 | ||
|} | |} | ||
− | |||
===[https://www.mediawiki.org/wiki/Help:Templates Templates]=== | ===[https://www.mediawiki.org/wiki/Help:Templates Templates]=== | ||
Line 99: | Line 104: | ||
Examples of templates used in UrW wiki: | Examples of templates used in UrW wiki: | ||
− | * <nowiki>{{key|space}}</nowiki> gives {{key|space}}. It has a [[Template:Key|fancy template page]] that looks different when included in a page. | + | * <code><nowiki>{{key|space}}</nowiki></code> gives {{key|space}}. It has a [[Template:Key|fancy template page]] that looks different when included in a page. |
− | * <nowiki>{{I for imagination}}</nowiki> gives the ''[[I for imagination]]'' tag: {{I for imagination}} | + | * <code><nowiki>{{I for imagination}}</nowiki></code> gives the ''[[I for imagination]]'' tag: {{I for imagination}} |
− | * <nowiki><blockquote>{{:fat}}</blockquote></nowiki> copies the contents of the ''[[Fat]]'' page in a quote box: | + | * <code><nowiki><blockquote>{{:fat}}</blockquote></nowiki></code> copies the contents of the ''[[Fat]]'' page in a quote box:<br> |
<blockquote>{{:fat}}</blockquote> | <blockquote>{{:fat}}</blockquote> | ||
Line 110: | Line 115: | ||
An example of a filled infobox ([[Lynx]]): | An example of a filled infobox ([[Lynx]]): | ||
− | <pre> | + | {| |
+ | |<pre><nowiki> | ||
{{Infobox Animal | {{Infobox Animal | ||
| type = Land Mammal | | type = Land Mammal | ||
Line 130: | Line 136: | ||
| pointProtection = | | pointProtection = | ||
| bluntProtection = | | bluntProtection = | ||
− | | butcher | + | | butcher = 17-23 lb lynx cuts, 3 lb lynx-skin, 0.3 lb lynx fat |
}} | }} | ||
− | </pre> | + | </nowiki></pre> |
+ | |} | ||
This gives the following infobox: | This gives the following infobox: | ||
Line 155: | Line 162: | ||
| pointProtection = | | pointProtection = | ||
| bluntProtection = | | bluntProtection = | ||
− | | butcher | + | | butcher = 17-23 lb lynx cuts, 3 lb lynx-skin, 0.3 lb lynx fat |
}} | }} | ||
Line 163: | Line 170: | ||
somewhere in the infobox template. | somewhere in the infobox template. | ||
+ | |||
+ | ===Deleting pages and vandalism=== | ||
+ | |||
+ | The amount of users who are authorized to remove pages is very limited, so it can take a while before any such person visits the wiki. If you find (or accidentally create) a page that needs to be deleted, add it to the [[:Category:Delete]] so it'll be easy to find when needed. If you don't have a wiki account, or you wish to make sure spam gets removed, you can e-mail erkka at enormouselk.com. In your e-mail include a link to the spam content. Thank you! | ||
+ | |||
+ | If a page, including its title, is clearly spam or other vandalism, it should always be added to the Delete category and all its content should be removed. If spam or vandalism is found on existing wiki pages, the spam should be removed (preferably by clicking the 'undo' button in the page history). We don't want UrW wiki advertising spammers' messages. | ||
+ | |||
+ | [[Category:Wiki editing]] |
Latest revision as of 19:30, 4 July 2024
UrW wiki uses MediaWiki which has a lot of helpful guides and tutorials on how to edit a page. Another useful source for tutorials are Wikipedia's help pages. In this guide, I try to list some useful tips for editing a page and I'll also add links to mediawiki's help page on the subject in the section headers'. In UrW wiki, edits are limited to registered users to avoid vandalism.
An even shorter guide is wikipedia's cheatsheet.
Contents
Quick wiki guide
After you're logged in, you can press the edit tab on the top of an article, or the edit links available next to sections. Also, when clicking a red link, i.e. a link to page that doesn't exist, you are taken to the edit tab of that article.
For the most part, editing the wiki is really easy: most of the editing is simply writing text, and if you don't know how to do something, you can just check how it's done in another page (or another mediawiki altogether). Links to other articles in the wiki are generally just words in square brackets, and infoboxes are also often easy to update, you'll just have to find the correct variable to modify (or add it if it's missing). Tables and images/files are a bit more tricky.
By the way, you can use the <nowiki></nowiki>
tags to escape wiki markup.
After you've finished editing, or you just want to know how the page looks now, press the Show preview button at the bottom. This will show a preview of the page with your edits and the edit box will still be at the bottom of the page. After previewing your changes, you should write a short description of what you did in the summary box. If you only added links or fixed typos or broken links then you should check the This is a minor edit box. When you've previewed and described your edits, press the Save page button
Next up are some quick tips to things you'll find in the wiki including links, tables, images, templates and infoboxes.
Headers and general markup
When editing an article, you may want to divide it into sections and subsections and even subsubsections. Section headers are text written between a number of =
signs, e.g.
-
==Quick wiki guide==
is the level 2 header which is the biggest header that should be used when editing. -
===Links===
are the subsection headers in this guide. -
====Infoboxes====
You'll rarely need headers this size or smaller.
You can italicize text by using '' on both sides of the word or words you want to italicize. Bolding text works similarly but you'll just use ''' instead. For example:
-
''Italic text''
gives Italic text -
'''Bold text'''
gives Bold text
You can force the end of a section with <div style="clear: both"></div>
, e.g. if you have images you want to have in a certain section. There's an example of how images work if the section is not ended in the images section of this article.
Links
Links to other pages in the wiki are marked by writing a pair of square brackets on both sides of the other article's title, e.g.
-
[[Watercraft]]
Links to the page Watercraft -
[[Watercraft]]s
Also links to the page Watercraft. This time the link looks like this though: Watercrafts -
[[Watercraft|punts and rafts]]
Also links to the page Watercraft. The page that the link is to is simply separated by a | sign and the actual link looks like this: punts and rafts. -
[[Linen undershirt]]
Links to the page Linen undershirt -
[[Linen Undershirt]]
Notice the capital letter in Undershirt. This links to the page Linen Undershirt which is different than the previous page and doesn't exist or is a redirect.
To remedy situations where the same page has title or spelling variations, redirect pages can be created. For example, the Linen Undershirt page could be redirected to the existing Linen undershirt page like this:
-
#REDIRECT:[[Linen undershirt]]
External links can be written in multiple ways:
-
https://www.mediawiki.org/wiki/Help:Links
gives https://www.mediawiki.org/wiki/Help:Links -
[https://www.mediawiki.org/wiki/Help:Links MediaWiki link help]
gives MediaWiki link help -
[[wikipedia:Unreal World|UnReal World]]
gives UnReal World
Images
Images are included in an article using the File syntax which is quite complex. Images often need to be used in quite specific ways in articles and it's best to refer to mediawiki or wikipedia for detailed instructions.
Some examples from the wiki:
-
[[File:Settlement collage.png|frame|right|border|Types of settlements clockwise from top left: village, single house, fortified village and kota camp.]]
gives the image from the Settlement article. -
[[File:Fat.png|24px|Chunk of fat]]
gives the image from the Fat article.
Tables
Tables can be a bit owerwhelming at first as each cell is written separately using the wiki markup. First there is the part that tells the wiki that the information is a table and how it should look. Then the information of each cell is written starting from the top left corner of the table and moving from left to right, and after reaching the end of a row, starting again from the row below. Using your browser's search function (usually ctrl + F) helps considerably in finding the correct row.
Here's an example of how a simple table looks in wiki markup:
{| class="wikitable" |- |row 1 cell 1 |row 1 cell 2 |- |row 2 cell 1 |row 2 cell 2 |- |row 3 cell 1 |row 3 cell 2 |} |
The same table without <pre></pre> tags used to prevent the table from being drawn:
row 1 cell 1 | row 1 cell 2 |
row 2 cell 1 | row 2 cell 2 |
row 3 cell 1 | row 3 cell 2 |
Templates
Templates are a way to use the same information or formatting in multiple pages. They are used by typing the template's name in double curly brackets {{}}. Any page can be used as a template but often they are written in a special Template page and the page titled Something template contains instructions for the template's use.
Generally templates simply insert the contents of what's in their page to the page they are included in. This can be done in useful ways though, as will be shown in the subsection discussing UrW wiki's infoboxes, which also are templates.
Examples of templates used in UrW wiki:
-
{{key|space}}
gives space. It has a fancy template page that looks different when included in a page. -
{{I for imagination}}
gives the I for imagination tag:
The following information is rated I for Imagination. It is largely based on the editor's or forum's imagination and is probably a poor attempt at humor. Trusting any of the following information is at the reader's own risk. |
-
<blockquote>{{:fat}}</blockquote>
copies the contents of the Fat page in a quote box:
In UnReal World, fat is both an object received from butchering animals and an essential part of nutrition received from food.
The fat received from animals can be used as food or as tanning material instead of bark.
In character nutrition, eating fat and foods with high fat content such as salmon and bear meat will quickly increase the characters nutrition level to abundant.
Infoboxes
Infoboxes are a type of template that create an infobox, like all the items and plants have on their individual pages. They have a lot of parameters to fill when used but the parameters don't necessarily need a value. Missing parameters will be visible in the infobox in triple curly brackets, e.g. {{{skin}}}. Unfortunately infoboxes get their title and image name from the page they are on so our example's image won't work.
An example of a filled infobox (Lynx):
{{Infobox Animal | type = Land Mammal | regions = | terrain = | weight = | speed = | movement = Walk | health = | weapon = | trap = [[Big deadfall trap]] | bait = [[Badger]] (cut), [[Squirrel]] (cut) | water = | avgProtection = | warmthProtection = | tearProtection = | edgeProtection = | squeezeProtection = | pointProtection = | bluntProtection = | butcher = 17-23 lb lynx cuts, 3 lb lynx-skin, 0.3 lb lynx fat }} |
This gives the following infobox:
Wiki editing guide | ||
---|---|---|
File:Wiki editing guide.png | ||
Basic Info | ||
Type: | Land Mammal | |
Regions: | ' | |
Terrain: | ' | |
Skin: | {{{skin}}} | |
Statistics | ||
Weight: | ' | |
Speed: | ' | |
Movement Types: | Walk | |
Health: | ' | |
Hunting Information | ||
Best Weapon: | ' | |
Trap Type: | Big deadfall trap | |
Bait: | Badger (cut), Squirrel (cut) | |
Armor Protection | ||
Average: | ' | |
Warmth: | ' | |
Tear: | ' | |
Edge: | ' | |
Squeeze: | ' | |
Point: | ' | |
Blunt: | ' | |
Butcher Yield | ||
Butcher: | 17-23 lb lynx cuts, 3 lb lynx-skin, 0.3 lb lynx fat |
Notice the title, broken image link, which can't be fixed (without tampering with the template), and the {{{skin}}}, which could be fixed by adding the line
| skin =
somewhere in the infobox template.
Deleting pages and vandalism
The amount of users who are authorized to remove pages is very limited, so it can take a while before any such person visits the wiki. If you find (or accidentally create) a page that needs to be deleted, add it to the Category:Delete so it'll be easy to find when needed. If you don't have a wiki account, or you wish to make sure spam gets removed, you can e-mail erkka at enormouselk.com. In your e-mail include a link to the spam content. Thank you!
If a page, including its title, is clearly spam or other vandalism, it should always be added to the Delete category and all its content should be removed. If spam or vandalism is found on existing wiki pages, the spam should be removed (preferably by clicking the 'undo' button in the page history). We don't want UrW wiki advertising spammers' messages.