More actions
(→Mediawiki Code: Minor fix) |
(Fixes my previous spelling errors from late night editing and removes the file links as it makes them rather distracting to look at it if one decides to move their mouse over them.) |
||
(10 intermediate revisions by the same user not shown) | |||
Line 7: | Line 7: | ||
* If you're not sure how to use wiki syntax, check out the official [https://www.mediawiki.org/wiki/Help:Formatting Mediawiki Formatting] page. | * If you're not sure how to use wiki syntax, check out the official [https://www.mediawiki.org/wiki/Help:Formatting Mediawiki Formatting] page. | ||
* Check out your [[Special:Preferences | "Editing" user preferences]] and make sure you have the enhanced editing toolbar enabled, among other optional tweaks. | * Check out your [[Special:Preferences | "Editing" user preferences]] and make sure you have the enhanced editing toolbar enabled, among other optional tweaks. | ||
=Editing Standard= | |||
The editing standard of the wiki is extremely important, as the wiki is what governs how players learn the game. So it has to be legible and coherent for what it is you are trying to display/explain, whether its a mechanic or a job/caste. | |||
==Editing Philosophy== | |||
When it comes to creating a new page or editing a pre-existing page the current design philosophy on the wiki is to provide a lot of visual feedback to the reader i.e. Images and gifs displaying what X mechanic or item does and what it looks like. This is because lots and lots of text is what the reader does NOT want to have to go through in order to find out how to do X. The only exception to that rule is pages regarding lore. | |||
One of the most important goals to consider when writing or editing a wiki page is that you want the information that you are providing to be in it's most simplest form so that it is easy to understand for any and all players. Whether it is for someone who is a native english speaker or someone who is an ESL, the simplicity of the explanation is what make your edit good because it means that more people can understand it. | |||
An example of this is via teaching, if your teacher explains a topic in a convoluted and long winded manner then the likelihood of the class fully understanding said topic is very low as some students may get bored or find it hard to follow. If they explain it in a short and concise manner, then it is a lot simpler to understand. The example of teaching is because as a wiki editor you're the unseen teacher of the hundreds who play this game, so your explanations etc need to make sense and be easy to follow. | |||
'''Questions to think about when editing a page or creating a new one:''' | |||
* Have I written too much? | |||
* Could I condense this down? | |||
* Could I simplify my writing? | |||
* Could I provide visual aid to what I'm explaining? | |||
* Would a new player be able to understand this without any prior context knowledge? | |||
''If you are ever in doubt about your edit just post a preview of your edit in #wiki-work on discord for wiki contributors and the wiki maintainer to look at and provide feedback.'' | |||
Lastly, after finishing an edit, write a brief summary of what the edit is before you save page as it helps organise your edit amongst all the others so other editors can see when a certain section or topic was added to a page. Here's the summary for this section being added to give you an example of what this should look like: | |||
[[File:Page_summary.png|link=]] | |||
=Mediawiki Code= | =Mediawiki Code= | ||
Line 12: | Line 42: | ||
<tabs> | |||
<tab name="Basic Formatting Code"> | <tab name="Basic Formatting Code"> | ||
{| style="border: 2px solid black; class="mw-collapsible" | {| style="border: 2px solid black; class="mw-collapsible" | ||
! style="background-color:# | ! style="background-color:#31532f; width:150px;"|'''Action to be performed:''' | ||
! style="background-color:# | ! style="background-color:#31532f;"|<center>'''The Code:'''</center> | ||
! style="background-color:# | ! style="background-color:#31532f;"|<center>'''The Output:'''</center> | ||
|- | |- | ||
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Removes the table of contents | |style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Removes the table of contents | ||
Line 50: | Line 79: | ||
<small>''This is HTML code as mediawiki does not have a native strikethrough command.''</small></center> | <small>''This is HTML code as mediawiki does not have a native strikethrough command.''</small></center> | ||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><S>Strikethrough Text.</S></center> | |style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><S>Strikethrough Text.</S></center> | ||
|- | |||
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Making formatting Centered | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki><center>Centered Text.</center></nowiki> | |||
<small>''This is HTML code as mediawiki does not have a native center command.''</small></center> | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center>Centered Text.</center> | |||
|- | |- | ||
Line 61: | Line 98: | ||
---- | ---- | ||
Dividing Line</center> | Dividing Line</center> | ||
|- | |||
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Page headers | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | | |||
<nowiki>= Page Header One=</nowiki> | |||
* <small>''This is the same header level as the page title at the top, so normally you won't use this and instead will use header two.''</small> | |||
<nowiki>== Page Header Two==</nowiki> | |||
<nowiki>=== Page Header Three ===</nowiki> | |||
<nowiki>==== Page Header Four ====</nowiki> | |||
<nowiki>===== Page Header Five =====</nowiki> | |||
<nowiki>====== Page Header Six ======</nowiki> | |||
A way that we like to use headers is to place images{Files) in them to help them stand out visually for the reader. | |||
<small><nowiki>======[[File:Weapons_rack.png]] Marine Vendor [[File:Weapons_rack.png]] ======</nowiki></small> | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | To avoid messing up the table of contents for this page the below image will detail what this would look like. | |||
[[File:Wiki_Page_Headers.png|link=]] | |||
|- | |- | ||
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Bullet Points | |style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Bullet Points | ||
Line 100: | Line 163: | ||
<center><nowiki>[[File:Weapons_rack.png]]</nowiki> | <center><nowiki>[[File:Weapons_rack.png]]</nowiki> | ||
<nowiki>[[File:Weapons_rack.png|32px]]</nowiki> | |||
<nowiki>[[File:Weapons_rack.png|128px]]</nowiki> | |||
<small>''You can alter the display size of a file by changing the pixels as shown above.''</small> | |||
</center> | |||
---- | ---- | ||
*Most files are uploaded to be 64x64px, so please keep to this. | |||
*Remember if the image you desire is not on the wiki, please upload it [[Special:Upload | HERE.]] | *Remember if the image you desire is not on the wiki, please upload it [[Special:Upload | HERE.]] | ||
*Please be certain beforehand that it is not on the wiki first. If you're unsure ask in #wiki-work on discord.</center> | *Please be certain beforehand that it is not on the wiki first. If you're unsure ask in #wiki-work on discord.</center> | ||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center>[[File:Weapons_rack.png]]</center> | |style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center> | ||
[[File:Weapons_rack.png|link=]] | |||
[[File:Weapons_rack.png|32px|link=]] | |||
[[File:Weapons_rack.png|128px|link=]] | |||
</center> | |||
|} | |||
</tab> | |||
<tab name="Advanced Formatting Code"> | |||
{| style="border: 2px solid black; class="mw-collapsible" | |||
! style="background-color:#31532f; width:150px;"|'''Action to be performed:''' | |||
! style="background-color:#31532f;"|<center>'''The Code:'''</center> | |||
! style="background-color:#31532f;"|<center>'''The Output:'''</center> | |||
|- | |||
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Text for just the editors | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> <nowiki> | |||
<!-- The Gaps are here for readability when editing --></nowiki></center> <small>This of course will not show up in the Output section as you will only see it if you open a page to edit.</small> | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> <!-- The Gaps are here for readability when editing --></center> | |||
|- | |||
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | No wiki code | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki><nowiki>'''Bold'''</nowiki></nowiki></center> <small>This stops wikicode from functioning, highly useful when filling out a usage section on a template.</small> | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> <nowiki>'''Bold'''</nowiki></center> | |||
|} | |} | ||
</tab> | </tab> | ||
<tab name="Table Formatting Code"> | |||
{| style="border: 2px solid black; class="mw-collapsible" | |||
! style="background-color:#31532f; width:150px;"|'''Action to be performed:''' | |||
! style="background-color:#31532f;"|<center>'''The Code:'''</center> | |||
! style="background-color:#31532f;"|<center>'''The Output:'''</center> | |||
|- | |||
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Fill in | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> <nowiki>Fill in</nowiki></center> | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> Fill in</center> | |||
|- | |||
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Fill in | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki>Fill in</nowiki></center> | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> Fill in</center> | |||
|} | |||
</tab> | |||
<tab name="Advanced Table Formatting"> | |||
{| style="border: 2px solid black; class="mw-collapsible" | |||
! style="background-color:#31532f; width:150px;"|'''Action to be performed:''' | |||
! style="background-color:#31532f;"|<center>'''The Code:'''</center> | |||
! style="background-color:#31532f;"|<center>'''The Output:'''</center> | |||
|- | |||
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Fill in | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> <nowiki>Fill in</nowiki></center> | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> Fill in</center> | |||
|- | |||
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Fill in | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki>Fill in</nowiki></center> | |||
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> Fill in</center> | |||
|} | |||
</tab> | |||
</tabs> | </tabs> | ||
Line 111: | Line 249: | ||
* Place <nowiki>{{outdated}}</nowiki> at the top of a wiki page to display a banner showing that the page is outdated and needs help. [[:Category:Outdated|View all outdated pages here]] - you're welcome to help update them. | * Place <nowiki>{{outdated}}</nowiki> at the top of a wiki page to display a banner showing that the page is outdated and needs help. [[:Category:Outdated|View all outdated pages here]] - you're welcome to help update them. | ||
* [[Special:ShortPages]] might be looking for more data. | * [[Special:ShortPages]] might be looking for more data. | ||
* [[Special:WantedFiles]] are all linked images that don't have a file attached to them. In 90% of cases, you can let [https://cm-ss13.com/wiki/User:Sargeantmuffinman Sargeantmuffinman], [https://cm-ss13.com/memberlist.php?mode=viewprofile&u=239 TopHatPenguin] or | * [[Special:WantedFiles]] are all linked images that don't have a file attached to them. In 90% of cases, you can let [https://cm-ss13.com/wiki/User:Sargeantmuffinman Sargeantmuffinman], [https://cm-ss13.com/memberlist.php?mode=viewprofile&u=239 TopHatPenguin] or Harryob know about these and they can upload the correct icon directly from source files. (Combined icons won't work for this, such as a human wearing armor, clothing, and holding weapons.) | ||
* [[Special:WantedPages]] are links to pages that don't exist yet, but someone feels it's needed. | * [[Special:WantedPages]] are links to pages that don't exist yet, but someone feels it's needed. | ||
* If you [[Special:Upload | upload a file]], make sure it doesn't already exist by checking [[Special:ListFiles]]. '''It is crucial that existing files are replaced by [http://i.imgur.com/2Zj2ckj.png uploading a new version] - DO NOT upload another version of the file with a different name!''' | * If you [[Special:Upload | upload a file]], make sure it doesn't already exist by checking [[Special:ListFiles]]. '''It is crucial that existing files are replaced by [http://i.imgur.com/2Zj2ckj.png uploading a new version] - DO NOT upload another version of the file with a different name!''' |
Latest revision as of 09:11, 9 September 2023
Before you begin
- The Special:SpecialPages page is the #1 weapon against unorganized or lacking wiki pages. It can be reached from the main menu cogwheel.
- The Special:Version special page has useful information on what extensions are installed for more advanced knowledge on wiki syntax and functionality.
- If you're not sure how to use wiki syntax, check out the official Mediawiki Formatting page.
- Check out your "Editing" user preferences and make sure you have the enhanced editing toolbar enabled, among other optional tweaks.
Editing Standard
The editing standard of the wiki is extremely important, as the wiki is what governs how players learn the game. So it has to be legible and coherent for what it is you are trying to display/explain, whether its a mechanic or a job/caste.
Editing Philosophy
When it comes to creating a new page or editing a pre-existing page the current design philosophy on the wiki is to provide a lot of visual feedback to the reader i.e. Images and gifs displaying what X mechanic or item does and what it looks like. This is because lots and lots of text is what the reader does NOT want to have to go through in order to find out how to do X. The only exception to that rule is pages regarding lore.
One of the most important goals to consider when writing or editing a wiki page is that you want the information that you are providing to be in it's most simplest form so that it is easy to understand for any and all players. Whether it is for someone who is a native english speaker or someone who is an ESL, the simplicity of the explanation is what make your edit good because it means that more people can understand it.
An example of this is via teaching, if your teacher explains a topic in a convoluted and long winded manner then the likelihood of the class fully understanding said topic is very low as some students may get bored or find it hard to follow. If they explain it in a short and concise manner, then it is a lot simpler to understand. The example of teaching is because as a wiki editor you're the unseen teacher of the hundreds who play this game, so your explanations etc need to make sense and be easy to follow.
Questions to think about when editing a page or creating a new one:
- Have I written too much?
- Could I condense this down?
- Could I simplify my writing?
- Could I provide visual aid to what I'm explaining?
- Would a new player be able to understand this without any prior context knowledge?
If you are ever in doubt about your edit just post a preview of your edit in #wiki-work on discord for wiki contributors and the wiki maintainer to look at and provide feedback.
Lastly, after finishing an edit, write a brief summary of what the edit is before you save page as it helps organise your edit amongst all the others so other editors can see when a certain section or topic was added to a page. Here's the summary for this section being added to give you an example of what this should look like:
Mediawiki Code
This section is to cover the basics of mediawiki code so that new and returning wiki contributors can refresh themselves with the basic and adanced code.
Action to be performed: | ||
---|---|---|
Removes the table of contents | ||
Applying Bolding to text | ||
Applying Italics to text | ||
Applying underlines to text |
|
|
Applying strikethroughs to text |
|
|
Making formatting Centered |
|
|
Dividing line | ---- Dividing Line |
Dividing Line |
Page headers |
= Page Header One=
=== Page Header Three === ==== Page Header Four ==== ===== Page Header Five ===== ====== Page Header Six ======
|
To avoid messing up the table of contents for this page the below image will detail what this would look like.
|
Bullet Points | This is a
* Bullet Point |
This is a
|
Numbered List | This is a
# Numbered List 1 # Numbered List 2 # Numbered List 3 |
This is a
|
Linking outside the wiki | ||
Linking within the wiki |
|
|
Displaying Images |
|
|
Action to be performed: | ||
---|---|---|
Text for just the editors | ||
No wiki code |
Action to be performed: | ||
---|---|---|
Fill in | ||
Fill in |
Action to be performed: | ||
---|---|---|
Fill in | ||
Fill in |
Contributing
- Place {{outdated}} at the top of a wiki page to display a banner showing that the page is outdated and needs help. View all outdated pages here - you're welcome to help update them.
- Special:ShortPages might be looking for more data.
- Special:WantedFiles are all linked images that don't have a file attached to them. In 90% of cases, you can let Sargeantmuffinman, TopHatPenguin or Harryob know about these and they can upload the correct icon directly from source files. (Combined icons won't work for this, such as a human wearing armor, clothing, and holding weapons.)
- Special:WantedPages are links to pages that don't exist yet, but someone feels it's needed.
- If you upload a file, make sure it doesn't already exist by checking Special:ListFiles. It is crucial that existing files are replaced by uploading a new version - DO NOT upload another version of the file with a different name!
- Tables have their own markup that is clean and easy to edit. Visit the official Mediawiki Help:Tables page for more info. There are also a few 3rd-party tools to assist with formatting, such as the Mediawiki Tables Generator.
- Templates are extremely powerful wiki additions that help eliminate redundancy in markup and provide a clean, easy-to-edit layout for future contributors. Check out the templates we're using. For example, you can add {{tocright}} to any page to have the Table of Contents move to the right side of the page. Advanced templates can include ParserFunctions (using #if, #ifexp, #switch, etc) for calculation and string handling (e.g. item infoboxes that show a default "Image not found" image if one doesn't exist), leading to some very clean and professional-looking documentation.
- Some other features include Magic Words, which can be useful in templates or in special cases, such as hiding the Table of Contents (TOC).
- All other Mediawiki-specific Help pages are here if you'd like to learn more.
Cleaning
- Special:LonelyPages has a list of pages that might need to be deleted or worked on (anything deleted can be restored).
- Special:UnusedFiles might also need to be deleted (anything deleted can be restored).
- Note: normal users are unable to delete pages, but Trusted users can.