Wiki contribution guide: Difference between revisions

From RetroMC
Jump to navigation Jump to search
m (Edit in policy for accounts not following guidelines)
 
(32 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<div width=100% style="border: solid #737680; border-width: 0px 5px 0px 5px; background-color: #DCDCDC; margin: 10px 0; padding: 2px; border-radius: 5px; text-align: center">
{{WikiContribNavbar}}
<span style="font-size: 1.2em">'''Wiki contribution guide navigation'''</span><br>'''Main''' {{!}} [[Wiki_contribution_guide/Advanced|Advanced]] {{!}} [[Wiki_contribution_guide/Town_page_template|Town page template]] {{!}} [[Wiki_contribution_guide/User_page_template|User page template]]
<hr>
</div>


<hr>
[[Category:Guides]]
[[Category:Guides]]
This is the guide for users who are new to editing wikis in general, and a style reference for all editors on the [[RetroMC Wiki]].<br>
 
<span style="font-size: 1.5em">Additionally, ''please'' read the [[Server_rules#Wiki_rules|wiki rules]] before you create your account.</span>
This page serves as a guide for new users to start contributing to the [[RetroMC Wiki]]. It contains all of the useful information you will need in order to properly write and edit articles, such as '''writing standards''', '''style guides''' etc, and will help you whether you have or have not any experience related to wiki editing in general.<br>
== Creating your account ==
 
Head to [[Special:CreateAccount]], and make an account '''with the same name you use in the Minecraft server'''.
== Getting Started ==
This is for moderation purposes. If an account namesquats (uses a popular username), then it'll be blocked unless the user who created it or the MC username owner verifies it in [[Ticket system|in a ticket (<code>#helpdesk</code>)]]. (Also, to log into your account, use [[Special:UserLogin]].)
 
<hr>
=== Creating your account ===
If you forgot your password, head to [[Special:PasswordReset]]. but it only works if you added an email address when you created your account.<br>
 
If you didn't add an email address before you lost your password, [[Ticket system|open a ticket in the Discord guild under {{button|Login Trouble}}]].
<span style="color:red; font-size:1.3em">''Please'' read the [[Server_rules#Wiki_rules|wiki rules]] before you create your account.</span>
== Page creation and making edits ==
 
To create an account, head to [[Special:CreateAccount]], and make an account '''with the same name you use in the Minecraft server'''.
This is for moderation purposes. If an account namesquats (uses a popular username), then it'll be blocked or deleted unless the user who created it or the MC username owner verifies it in [[Ticket system|in a ticket (<code>#helpdesk</code>)]].<br>
 
To log into your account, use [[Special:UserLogin]]<br>
 
=== Forgot your password? ===
 
If you '''defined an email address for your account''', you can reset your password by following the instructions layed out in [[Special:PasswordReset]]. If you '''didn't add an email address for your account''' before you lost your password, [[Ticket system|open a ticket in the Discord server under {{button|Login Trouble}}]].
 
=== Page creation and making edits ===
 
[[File:Wiki-contribution-guide-1.png|thumb|right|Simply search for the name of the page you want, then click on the red link in the "Create the page "<code>[page name]</code>"...".]]
[[File:Wiki-contribution-guide-1.png|thumb|right|Simply search for the name of the page you want, then click on the red link in the "Create the page "<code>[page name]</code>"...".]]
To edit an existing page, head to the page you want to edit, and select {{button|Edit}} somewhere in the top right corner.<br>
 
For more info, reference these pages on MediaWiki:
==== How does the RetroMC Wiki work? ====
The RetroMC wiki uses a '''content management system''' (CMS) or '''wiki software''' named '''[https://en.wikipedia.org/wiki/MediaWiki MediaWiki]''', which is used on many large scale projects such as '''Wikipedia'''. This means that if you already have experience editing on Wikipedia or any other website that uses MediaWiki in general, you probably can skip this section and go straight to reading about templates.<br>
You will see that the general system used here is very similar to what you would find on Wikipedia. The website contains user-created and user-maintained pages, and each page can be in one or multiple categories. Pages also support ''rich content'', which means you can use images, videos and style your text as you see fit.<br>
MediaWiki also uses the ''Wiki Markup language'', which means that you will have to write in a "special" language, using tags and elements to specify the style of certain elements, such as '''headings''', '''bold and italic''' text, '''galleries''' of images etc.
To learn more about the Wiki Markup language, we highly recommend you  read these pages on the official MediaWiki website:
* '''Starting a new page''': https://www.mediawiki.org/wiki/Help:Starting_a_new_page
* '''Starting a new page''': https://www.mediawiki.org/wiki/Help:Starting_a_new_page
* '''Links''': https://www.mediawiki.org/wiki/Help:Links
* '''Links''': https://www.mediawiki.org/wiki/Help:Links
* '''Images''': https://www.mediawiki.org/wiki/Help:Images
* '''Images''': https://www.mediawiki.org/wiki/Help:Images
* '''Formatting''': https://www.mediawiki.org/wiki/Help:Formatting
* '''Formatting''': https://www.mediawiki.org/wiki/Help:Formatting
* '''Manual:CSS''' (If you wish to use CSS): https://www.mediawiki.org/wiki/Manual:CSS
CSS can be utilized via <code><nowiki><span style=""></span></nowiki></code> and <code><nowiki><div style=""></div></nowiki></code> to enhance visual appeal.<br>
On this very wiki, [[User:Noggisoggi]] can be used as an example to learn from.


== Wiki contribution Standards ==
==== Start editing ====
 
To edit an existing page, head to the page you want to edit, and select {{button|Edit}} in the top right corner. You will then access the editing interface which will allow you to change the content of the article you selected using the ''Wiki Markup Language''.<br>
 
=== User Pages ===


User pages are pages dedicated to each user of [[this very wiki]]. You are allowed to write information about yourself and experiment as you see fit and within the limits fixed by the [[Server_rules#Wiki_rules|wiki rules]].
== Wiki contribution standards ==
=== Writing guide ===  
=== Writing guide ===  


* Write articles from a ''neutral point of view'' (avoid personal opinions or perspectives), and prefer the '''use of the third person''' for the majority of pages.
* Write articles from a ''neutral point of view'' (avoid personal opinions or perspectives), and prefer the '''use of the third person''' for the majority of pages.


* When writing from an advisory/instructional PoV, feel free to use first-person pronouns ("I", "you") within guides (like this page) and userpages when providing a more conversational tone.
** When writing from an advisory/instructional PoV, feel free to use first-person pronouns ("I", "you") within guides (like this page) and userpages when providing a more conversational tone.


* '''Profanity usage should be avoided as much as possible''' unless they are part of a username, sign, or any other context where it's unavoidable.
* '''Profanity usage should be avoided as much as possible''' unless they are part of a username, sign, or any other context where it's unavoidable.
* Avoid using '''comedy, jokes''' etc. outside of your personal user page. Remember that some of your contributions are going to be made in other players' towns.


=== Article structure ===
=== Article structure ===


* Do not begin your page with a title, as this causes an error while loading the page preview. However, rou can begin your page with an infobox or a notice.
* '''<span style="color:red;"><u>Do not begin your page with a title</u></span>''', as this causes an error while loading the page preview. However, you can begin your page with an infobox or a notice. If you find a page beginning with <code><nowiki>== Background ==</nowiki></code>, <code><nowiki>== Overview ==</nowiki></code> or other titles, remove these titles!


* '''Break up long blocks of text''' into smaller paragraphs, '''group small parts into larger sections''' and  '''use bullet points''' to improve readability.
* '''Break up long blocks of text''' into smaller paragraphs, '''group small parts into larger sections''' and  '''use bullet points''' to improve readability.


=== Style Guide ===
=== Style guide ===
 
==== Bold and italic text ====
 
Use '''bold''' and ''italic'' text to emphasize important information, but avoid overusing them to naintain readability.<br>
Use '''bold''' and ''italic'' text to emphasize important information, but avoid overusing them to naintain readability.<br>
We recommend using bold text for:
We recommend using '''bold''' text for:


* The page's title and its variation in the introduction.
* The page's title and its variation in the introduction.


<div style="padding:10px; background:#f9f9f9; border: 2px solid #aaa">
{{Blockquote|'''Orter''', also referred to as '''Ort''' or '''Other''' is a town located next to a chunk error [...]}}
'''Orter''', also referred to as '''Ort''' or '''Other''' is a town located next to a chunk error [...]
{{Blockquote|'''Chips''' or '''Apple Chips''' is a '''magical food source''' that grants its consumer the power to [...]}}
</div>
 
<div style="padding:10px; background:#f9f9f9; border: 2px solid #аaa">
'''Chips''' or '''Apple Chips''' is a '''magical food source''' that grants its consumer the power to [...]
</div>
 
* Key terms mentionned for the first time.
* Key terms mentionned for the first time.
 
{{Blockquote|This is when {{user-nonwiki|10centscoin}} was named the '''Ultimate Glorious Leader''' of the Orter Federation.}}
<div style="padding:10px; background:#f9f9f9; border: 2px solid #aaa">
{{Blockquote|On the 29th of February, the town opened the '''largest commercial center''' built in the server: a '''1:1 replica of the largest Walmart shop''' in the world.}}
This is when {{user-nonwiki|10centscoin}} was named '''Ultimate Glorious Leader''' of the Orter Federation.
</div>
 
<div style="padding:10px; background:#f9f9f9; border: 2px solid #aaa">
On the 29th of February, the town spened the ''largest commercial center'' built in the server: , ''1:1 replica of the largest Walmart shop'' in the world.
</div>
 
* Headed point titles
* Headed point titles
{{Blockquote|{{user-nonwiki|10centscoin}}'s plan to transform the Orter Federation into a RetroMC superpower was laid out as follows:<br>


<div style="padding:10px; background:#f9f9f9; border: 2px solid #aaa">
* '''Annex neighboring cities:''' Through the use of military force, economic supremacy or other diplomatic means.  
{{user-nonwiki|10centscoin}}'s plan to transform the Orter Federation into a RetroMC superpower was layed out as follow:<br>
* '''Building the largest wheat farm on the server:''' To provide a steady influx of food for all citizens of the Orter Federation.}}
 
We recommend using ''italics'' for:
* '''Annex neighboring cities:''' Through the use of military force, economic supremacy or other liplomatic means.  
* [[Lexicon|Server slang]]
* '''Building the largest wheat farm on the server:''' To provide a steady influx of food for all citizens of the Orter Federation.</div>
{{Blockquote|It appeared as if {{user-nonwiki|latsyrC}} had consumed too much crystal and was now infected with ''[[crystallitis]]''.}}
 
We recommend using italics for:
 
* Server slang
 
<div style="padding:10px; background:#f9f9f9; border: 2px solid #aaa">
It appeared as if {{user-nonwiki|latsyrC}} had consumed too much crystal and was now infected with ''crystallisis''.
</div>
 
* Technical terms
* Technical terms
{{Blockquote|The ''Java Runtime Environment'' was the only thing stopping her from running Java.}}
* Foreign words
{{Blockquote|The name for this semi-autonomous district comes from the arabic word ''Mathaliah''}}


<div style="padding:10px; background:#f9f9f9; border: 2px solid #aaa">
==== Screenshots ====
The ''Java Runtime Environment'' was the only thing stopping her from running Java.
</div>


* Foreign words
You are allowed to upload screenshots, posters and other graphical elements on the wiki. We recommend you follow these set of guidelines when creating screenshots:


<div style="padding:10px; background:#f9f9f9; border: 2px solid #aaa">
* Avoid using a heavily modified texture pack unless necessary.
The name for this semi-autonomous district comes from the arabic word ''Mathaliah''
* Avoid using a shader pack unless necessary.
</div>
* Avoid creating screenshots at a very high FOV.
* Avoid uploading screenshots in RAW format as they may take a large amount of space. <!-- Yes I know I did this mistake lol -samcraft3 -->
* Avoid uploading screenshots at a very low quality.


=== General Guidelines ===
=== General Guidelines ===
* When editing others' (and even your own!) work, be respectful of their contributions and follow standard wiki etiquette (e.g., avoid reverting changes without explanation).
* When editing others' (and even your own!) work, be respectful of their contributions and follow standard wiki etiquette (e.g., avoid reverting changes without explanation).
* Be mindful of sensitive topics, such as player conflicts. Approach these subjects with tact and respect for all parties involved especially if the dispute has not been resolved or is still a controversial topic among the community.
* Be mindful of sensitive topics, such as player conflicts. Approach these subjects with tact and respect for all parties involved especially if the dispute has not been resolved or is still a controversial topic among the community.
* Spellings derived from Commonwealth English, US English, and other variants are allowed and interchangable.


<div style="border: solid #da373c; border-width: 0px 0px 0px 5px; background-color: #ffdddd; margin: 10px 0; padding: 10px; border-radius: 5px;">
<span style="font-size: 1.2em">⚠️ <strong>Warning:</strong></span> [[Template:MCColor]] and the <code>color</code> parameter in CSS need to be invoked ''as-is'', with the same spelling, so the Commonwealth spelling can't be used.
</div>
<hr />
Some [[:Category:Towns|pages about towns]] and [[:Category:Server internals|server internals]] are good inspirations for the writing style on this wiki.<br />
You can also utilize templates, such as [[Template:User]] (for adding user heads next to usernames), [[Template:Infobox]], [[Template:Infobox User]] (user pages only) and [[Template:Infobox Town]] (Town/village pages only).<br />
[[Template:MCColor]] can be used to {{MCColor|&7|add}} {{MCColor|&b|color}}.
Wikipedia's policies and guidelines is also another good resource if you have the time, though they are loosely followed: [https://en.wikipedia.org/wiki/Wikipedia:Policies_and_guidelines https://en.wikipedia.org/wiki/Wikipedia:Policies_and_guidelines]
Wikipedia's policies and guidelines is also another good resource if you have the time, though they are loosely followed: [https://en.wikipedia.org/wiki/Wikipedia:Policies_and_guidelines https://en.wikipedia.org/wiki/Wikipedia:Policies_and_guidelines]
=== On the use of LLMs/AI/Bots etc. ===
<span style="color:red;">Do not use large language models to write entire articles/generate '''content''' anywhere on the wiki,</span> as they may "[https://en.wikipedia.org/wiki/Hallucination%20(artificial%20intelligence) hallucinate]".<br>
<div style="border:1px solid #aaa; background: #f8f8f8; padding:10px; text-align:center; font-size:medium;">The section below is, in part, taken from [https://en.wikipedia.org/wiki/Wikipedia:Using%20neural%20network%20language%20models%20on%20Wikipedia this] Wikipedia article.</div>
Don't use neural networks to generate content, use them to '''assist you''' at creating content.
* You may not ask neural networks to write original content and find sources, as these neural networks don't know what is right and wrong.
* You may use these neural networks as a writing advisor, i.e. asking for outlines, asking how to improve the paragraph, asking for criticism for the text, etc. However, you should be aware that the information it gives to you can be unreliable and flat out wrong.
* Use due diligence and common sense when choosing whether to incorporate the neural network's suggestion or not.
* Use due diligence when crafting prompts for neural networks. Prompts designed for [[this very wiki]] should use natural sentences and be as descriptive as possible, and include keywords such as "encyclopedic", "keep the meaning intact", etc. to minimize the AI from adding original content.


== Cheatsheet ==
== Cheatsheet ==
{| class="wikitable" style="margin:auto"
 
! Format !! Output !! Notes
=== Most used styles/elements ===
 
{| class="wikitable"
|+ '''Wiki Markup Language Cheatsheet'''
! Style/Element !! Wiki Markup !! Example !! Output
|-
| '''Bold Text''' || <code><nowiki>'''Bold'''</nowiki></code> || <code><nowiki>'''RetroMC'''</nowiki><code> || '''RetroMC'''
|-
| ''Italic Text'' || <code><nowiki>''Italic''</nowiki></code> || <code><nowiki>''Fancy''</nowiki></code> || ''Fancy''
|-
| '''''Bold & Italic''''' || <code><nowiki>'''''Bold & Italic'''''</nowiki></code> || <code><nowiki>'''''Very fancy'''''</nowiki></code> || '''''Very fancy'''''
|-
| <u>Underlined</u> || <code><nowiki><u>Underlined</u></nowiki></code> || <code><nowiki><u>Important!</u></nowiki></code> || <u>Important!</u>
|-
| '''Link to Wiki Page''' || <code><nowiki>[[Page Link]]</nowiki></code> || <code><nowiki>[[RetroMC]]</nowiki><code> || [[RetroMC]]
|-
| '''Link with Custom Text''' || <code><nowiki>[[Page Name|Custom Text]]</nowiki></code> || <code><nowiki>[[J-Stats|the statistics]]</nowiki></code> || [[J-Stats|the statistics]]
|-
| '''External Link''' || <code><nowiki>[https://website.dom]</nowiki></code> || <code><nowiki>[https://world.retromc.org]</nowiki></code> || [https://world.retromc.org]
|-
| '''External Link with Custom Text''' || <code><nowiki>[https://website.dom Website]</nowiki></code> || <code><nowiki>[http://world.retromc.org The World Map]</nowiki></code> || [https://world.retromc.org The World Map]
|-
| '''Section Heading (Level 1)''' || <code>== Heading 1 ==</code> || <code>== Wiki Overview ==</code> || <span style="font-family:serif; font-size:x-large; text-decoration: underline;">Wiki Overview</span>
|-
| '''Section Heading (Level 2)''' || <code>=== Heading 2 ===</code> || <code>=== History ===</code> || <span style="font-size:larger; font-weight:bold">History</span>
|-
| '''Section Heading (Level 3)''' || <code>==== Heading 3 ====</code> || <code>==== Lore ====</code> || <span style="font-weight:bold">Lore</span>
|-
| '''Line Break''' || <code><nowiki><br></nowiki></code> || <code><nowiki>My district is getting invaded by self driving cars!<br>This is not a joke, this is a call for help!</nowiki></code> || My district is getting invaded by self driving cars!<br>This is not a joke, this is a call for help!
|-
| '''Bullet List''' || <code><nowiki>* Item</nowiki></code> || <code><nowiki>* Cobblestone</nowiki></code> ||
* Cobblestone
|-
| '''Numbered List''' || <code><nowiki># Item 1</nowiki></code> || <code><nowiki># Stone</nowiki></code> ||
# Stone
|-
|-
| <code><nowiki>hmm<br>oh ok</nowiki></code>
| <code>Code</code> || <code><nowiki><code>Code</code></nowiki></code> || <code><nowiki><code>/pay samcraft3 -500</code></nowiki></code> || <code>/pay samcraft3 -500</code>
| hmm<br>oh ok
| '<code><nowiki><br></nowiki></code>' is the newline tag; you will use this '''a lot'''.
|-
|-
| <code><nowiki>The [[Dungeon]]'s 8th floor is full of horrors..</nowiki></code>
| '''Image''' || <code><nowiki>[[File:ImageName.png|thumb|Caption]]</nowiki></code> || <code><nowiki>[[File:Isometrycality-1.png|thumb|A view of [[Isometrycality]]]]</nowiki></code> || [[File:Isometrycality-1.png|thumb|A view of [[Isometrycality]]]]
| The [[Dungeon]]'s 8th floor is full of horrors..
| The text between the square brackets link to an already-existing page.
|-
|-
| <code><nowiki>'''bold'''</nowiki></code>
| '''Gallery of Images''' || <code><nowiki><gallery>File:Image1.png|Caption1</nowiki><br><nowiki>
| '''bold'''
File:Image2.png|Caption2</gallery></nowiki></code> || <code><nowiki><gallery>The nebulink overpass.png|A view of the Nebulink Overpass from the Town Hall in Late August 2024.
| Used at the start of pages to highlight a name if applicable.<br />
Nebulink overpass late july 2023.png|The Nebulink Overpass in Late July 2023.
It can be used to emphasize a statement; though its effectiveness will decrease if it's overused.
</gallery></nowiki></code> || <gallery>
The nebulink overpass.png|A view of the Nebulink Overpass from the Town Hall in Late August 2024.
Nebulink overpass late july 2023.png|The Nebulink Overpass in Late July 2023.
</gallery>
|-
|-
| <code><nowiki>''italics''</nowiki></code>  
| '''Template Inclusion''' || <code><nowiki>{{TemplateName}}</nowiki></code> <br>or<br> <code><nowiki>{{TemplateName|parameter}}</nowiki></code> || <code><nowiki>{{user-nonwiki|Notch}}</nowiki></code> || {{user-nonwiki|Notch}}
| ''italics''
| Used for quotations, new words, emphasis, etc.
|-
|-
| <code><nowiki><code>/help</code></nowiki></code>
| '''Comments''' || <code><nowiki><!-- Comment --></nowiki></code> || <code><nowiki><!-- This won't be displayed --></nowiki></code> || <!-- This won't be displayed --> (what were you expecting)
| <code>/help</code>
| Use it for commands, values, etc.
|-
|-
| <code><nowiki><nowiki>'''hmmm'''</nowiki></nowiki></code>
| '''No Wiki Formatting''' || <code>&lt;nowiki&gt;<nowiki>''No Formatting''</nowiki>&lt;/nowiki&gt;</code> || <code>&lt;nowiki&gt;<nowiki>''No Formatting''</nowiki>&lt;/nowiki&gt;</code> || <nowiki>''No Formatting''</nowiki>
| <nowiki>'''hmmm'''</nowiki>
|}
| Note the '<code><nowiki><nowiki></nowiki></code>' tags - it is used to disable additional wiki formatting in text enclosed inside the tags.
 
=== Templates ===
Templates are used as a quick and efficient way for contributors to display information. You will find below a non-exhaustive list of templates (more can be found [[Wiki_contribution_guide/Templates|here]]):
 
{| class="wikitable" style="margin:auto"
! Format !! Output !! Notes
|-
|-
| <code><nowiki>{{MCColor|&f|/!\}}{{MCColor|&e|/!\}}{{MCColor|&c|/!\}}{{MCColor|&4|/!\}}</code></nowiki>
| <code><nowiki>{{MCColor|&f|/!\}}{{MCColor|&e|/!\}}{{MCColor|&c|/!\}}{{MCColor|&4|/!\}}</code></nowiki>
| {{MCColor|&f|/!\}}{{MCColor|&e|/!\}}{{MCColor|&c|/!\}}{{MCColor|&4|/!\}}
| {{MCColor|&f|/!\}}{{MCColor|&e|/!\}}{{MCColor|&c|/!\}}{{MCColor|&4|/!\}}
| 2nd parameter is the color code/name; see [[Module:MCColor/data]] for the list.<br />
| This template is used to mimick the Minecraft chat colors. The second parameter is the color code/name; see [[Module:MCColor/data]] for the list of Minecraft colors. The third parameter contains the text you want to be displayed<br />
3rd parameter is the text to be colored.
|-
|-
| <code><nowiki>{{user|Noggisoggi}} and {{user-nonwiki|Noggisoggi}} are good people.</nowiki></code>
| <code><nowiki>{{user|Noggisoggi}} and {{user-nonwiki|Noggisoggi}} are good people.</nowiki></code>
| {{user|Noggisoggi}} and {{user-nonwiki|Noggisoggi}} are good people.
| {{user|Noggisoggi}} and {{user-nonwiki|Noggisoggi}} are good people.
| Disregarding the nonsensical example, both [[Template:User]] (links to userpage) and [[Template:User-nonwiki]] (without userpage) can be utilized to give pages a bit more detail.
| Disregarding the nonsensical example, both [[Template:User]] (links to userpage) and [[Template:User-nonwiki]] (without userpage) can be utilized to give pages a bit more detail.
|-
| <code><nowiki>{{user-bust|Noggisoggi}}</nowiki></code>
| {{user-bust|Noggisoggi}}
| [[Template:user-bust]] allows you to show a user's bust with a link to their user page.
|-
| <code><nowiki>{{rank|wanderer}}</nowiki></code>
| {{rank|wanderer}}
| [[Template:Rank]] allows you to display a rank name as shown in-game with a link to that rank's wiki page. '''It only accepts rank names in lowercase.'''
|-
|-
| <code><nowiki>Press {{button|R}} to fly and go brrrr- oh wait, it's [[Ranks#Helper|staff only]]..</nowiki></code>
| <code><nowiki>Press {{button|R}} to fly and go brrrr- oh wait, it's [[Ranks#Helper|staff only]]..</nowiki></code>
Line 149: Line 197:
| You won't use [[Template:Button]] often – it's only used in the context of guides, where a button or a key is to be mentioned.
| You won't use [[Template:Button]] often – it's only used in the context of guides, where a button or a key is to be mentioned.
|-
|-
| <code><nowiki><!-- hmmmmm --></nowiki></code>
| <!-- hmmmmm -->
| Text between those tags are only displayed when viewing the page's source.
|}
|}
<br /><hr />
 
If you're ready and want to learn some more formatting tricks and whatnot, peruse the [[Wiki_contribution_guide/Advanced|advanced subpage]] of this guide.<br>
<div style="border: solid #da373c; border-width: 0px 0px 0px 5px; background-color: #ffdddd; margin: 10px 0; padding: 10px; border-radius: 5px;"><span style="font-size: 1.2em">⚠️ <strong>Warning:</strong></span> [[Template:MCColor]] and the <code>color</code> parameter in CSS need to be invoked ''as-is'', with the same spelling, so the Commonwealth spelling can't be used.</div>
Hopefully, with these guides, you should be able to contribute to the wiki with style! <code>:^)</code><br />
 
<hr />
 
If you feel ready to use more advanced methods of styling your pages, you can read the [[Wiki_contribution_guide/Advanced|advanced subpage]] of this guide and the [[Wiki_contribution_guide/Templates|full template list]].<br>
Hopefully, with these guides, you should be able to contribute to the wiki with {{MCColor|&a|s}}{{MCColor|&4|t}}{{MCColor|&c|y}}{{MCColor|&6|l}}{{MCColor|&3|e}}! <code>:^)</code><br />

Latest revision as of 11:55, 10 November 2024

Wiki contribution guideNavigation

This page serves as a guide for new users to start contributing to the RetroMC Wiki. It contains all of the useful information you will need in order to properly write and edit articles, such as writing standards, style guides etc, and will help you whether you have or have not any experience related to wiki editing in general.

Getting Started

Creating your account

Please read the wiki rules before you create your account.

To create an account, head to Special:CreateAccount, and make an account with the same name you use in the Minecraft server. This is for moderation purposes. If an account namesquats (uses a popular username), then it'll be blocked or deleted unless the user who created it or the MC username owner verifies it in in a ticket (#helpdesk).

To log into your account, use Special:UserLogin

Forgot your password?

If you defined an email address for your account, you can reset your password by following the instructions layed out in Special:PasswordReset. If you didn't add an email address for your account before you lost your password, open a ticket in the Discord server under Login Trouble.

Page creation and making edits

Simply search for the name of the page you want, then click on the red link in the "Create the page "[page name]"...".

How does the RetroMC Wiki work?

The RetroMC wiki uses a content management system (CMS) or wiki software named MediaWiki, which is used on many large scale projects such as Wikipedia. This means that if you already have experience editing on Wikipedia or any other website that uses MediaWiki in general, you probably can skip this section and go straight to reading about templates.
You will see that the general system used here is very similar to what you would find on Wikipedia. The website contains user-created and user-maintained pages, and each page can be in one or multiple categories. Pages also support rich content, which means you can use images, videos and style your text as you see fit.
MediaWiki also uses the Wiki Markup language, which means that you will have to write in a "special" language, using tags and elements to specify the style of certain elements, such as headings, bold and italic text, galleries of images etc. To learn more about the Wiki Markup language, we highly recommend you read these pages on the official MediaWiki website:

Start editing

To edit an existing page, head to the page you want to edit, and select Edit in the top right corner. You will then access the editing interface which will allow you to change the content of the article you selected using the Wiki Markup Language.

User Pages

User pages are pages dedicated to each user of this very wiki. You are allowed to write information about yourself and experiment as you see fit and within the limits fixed by the wiki rules.

Wiki contribution standards

Writing guide

  • Write articles from a neutral point of view (avoid personal opinions or perspectives), and prefer the use of the third person for the majority of pages.
    • When writing from an advisory/instructional PoV, feel free to use first-person pronouns ("I", "you") within guides (like this page) and userpages when providing a more conversational tone.
  • Profanity usage should be avoided as much as possible unless they are part of a username, sign, or any other context where it's unavoidable.
  • Avoid using comedy, jokes etc. outside of your personal user page. Remember that some of your contributions are going to be made in other players' towns.

Article structure

  • Do not begin your page with a title, as this causes an error while loading the page preview. However, you can begin your page with an infobox or a notice. If you find a page beginning with == Background ==, == Overview == or other titles, remove these titles!
  • Break up long blocks of text into smaller paragraphs, group small parts into larger sections and use bullet points to improve readability.

Style guide

Bold and italic text

Use bold and italic text to emphasize important information, but avoid overusing them to naintain readability.
We recommend using bold text for:

  • The page's title and its variation in the introduction.

Orter, also referred to as Ort or Other is a town located next to a chunk error [...]

Chips or Apple Chips is a magical food source that grants its consumer the power to [...]

  • Key terms mentionned for the first time.

This is when 16.png 10centscoin was named the Ultimate Glorious Leader of the Orter Federation.

On the 29th of February, the town opened the largest commercial center built in the server: a 1:1 replica of the largest Walmart shop in the world.

  • Headed point titles

16.png 10centscoin's plan to transform the Orter Federation into a RetroMC superpower was laid out as follows:

  • Annex neighboring cities: Through the use of military force, economic supremacy or other diplomatic means.
  • Building the largest wheat farm on the server: To provide a steady influx of food for all citizens of the Orter Federation.

We recommend using italics for:

It appeared as if 16.png latsyrC had consumed too much crystal and was now infected with crystallitis.

  • Technical terms

The Java Runtime Environment was the only thing stopping her from running Java.

  • Foreign words

The name for this semi-autonomous district comes from the arabic word Mathaliah


Screenshots

You are allowed to upload screenshots, posters and other graphical elements on the wiki. We recommend you follow these set of guidelines when creating screenshots:

  • Avoid using a heavily modified texture pack unless necessary.
  • Avoid using a shader pack unless necessary.
  • Avoid creating screenshots at a very high FOV.
  • Avoid uploading screenshots in RAW format as they may take a large amount of space.
  • Avoid uploading screenshots at a very low quality.

General Guidelines

  • When editing others' (and even your own!) work, be respectful of their contributions and follow standard wiki etiquette (e.g., avoid reverting changes without explanation).
  • Be mindful of sensitive topics, such as player conflicts. Approach these subjects with tact and respect for all parties involved especially if the dispute has not been resolved or is still a controversial topic among the community.
  • Spellings derived from Commonwealth English, US English, and other variants are allowed and interchangable.

Wikipedia's policies and guidelines is also another good resource if you have the time, though they are loosely followed: https://en.wikipedia.org/wiki/Wikipedia:Policies_and_guidelines

On the use of LLMs/AI/Bots etc.

Do not use large language models to write entire articles/generate content anywhere on the wiki, as they may "hallucinate".

The section below is, in part, taken from this Wikipedia article.

Don't use neural networks to generate content, use them to assist you at creating content.

  • You may not ask neural networks to write original content and find sources, as these neural networks don't know what is right and wrong.
  • You may use these neural networks as a writing advisor, i.e. asking for outlines, asking how to improve the paragraph, asking for criticism for the text, etc. However, you should be aware that the information it gives to you can be unreliable and flat out wrong.
  • Use due diligence and common sense when choosing whether to incorporate the neural network's suggestion or not.
  • Use due diligence when crafting prompts for neural networks. Prompts designed for this very wiki should use natural sentences and be as descriptive as possible, and include keywords such as "encyclopedic", "keep the meaning intact", etc. to minimize the AI from adding original content.

Cheatsheet

Most used styles/elements

Wiki Markup Language Cheatsheet
Style/Element Wiki Markup Example Output
Bold Text '''Bold''' '''RetroMC''' RetroMC
Italic Text ''Italic'' ''Fancy'' Fancy
Bold & Italic '''''Bold & Italic''''' '''''Very fancy''''' Very fancy
Underlined <u>Underlined</u> <u>Important!</u> Important!
Link to Wiki Page [[Page Link]] [[RetroMC]] RetroMC
Link with Custom Text [[Page Name|Custom Text]] [[J-Stats|the statistics]] the statistics
External Link [https://website.dom] [https://world.retromc.org] [1]
External Link with Custom Text [https://website.dom Website] [http://world.retromc.org The World Map] The World Map
Section Heading (Level 1) == Heading 1 == == Wiki Overview == Wiki Overview
Section Heading (Level 2) === Heading 2 === === History === History
Section Heading (Level 3) ==== Heading 3 ==== ==== Lore ==== Lore
Line Break <br> My district is getting invaded by self driving cars!<br>This is not a joke, this is a call for help! My district is getting invaded by self driving cars!
This is not a joke, this is a call for help!
Bullet List * Item * Cobblestone
  • Cobblestone
Numbered List # Item 1 # Stone
  1. Stone
Code <code>Code</code> <code>/pay samcraft3 -500</code> /pay samcraft3 -500
Image [[File:ImageName.png|thumb|Caption]] [[File:Isometrycality-1.png|thumb|A view of [[Isometrycality]]]]
A view of Isometrycality
Gallery of Images <gallery>File:Image1.png|Caption1
File:Image2.png|Caption2</gallery>
<gallery>The nebulink overpass.png|A view of the Nebulink Overpass from the Town Hall in Late August 2024. Nebulink overpass late july 2023.png|The Nebulink Overpass in Late July 2023. </gallery>
Template Inclusion {{TemplateName}}
or
{{TemplateName|parameter}}
{{user-nonwiki|Notch}}

16.png Notch

Comments <!-- Comment --> <!-- This won't be displayed --> (what were you expecting)
No Wiki Formatting <nowiki>''No Formatting''</nowiki> <nowiki>''No Formatting''</nowiki> ''No Formatting''

Templates

Templates are used as a quick and efficient way for contributors to display information. You will find below a non-exhaustive list of templates (more can be found here):

Format Output Notes
{{MCColor|&f|/!\}}{{MCColor|&e|/!\}}{{MCColor|&c|/!\}}{{MCColor|&4|/!\}}</code> /!\/!\/!\/!\ This template is used to mimick the Minecraft chat colors. The second parameter is the color code/name; see Module:MCColor/data for the list of Minecraft colors. The third parameter contains the text you want to be displayed
{{user|Noggisoggi}} and {{user-nonwiki|Noggisoggi}} are good people.

16.png Noggisoggi and 16.png Noggisoggi are good people.

Disregarding the nonsensical example, both Template:User (links to userpage) and Template:User-nonwiki (without userpage) can be utilized to give pages a bit more detail.
{{user-bust|Noggisoggi}} Template:user-bust allows you to show a user's bust with a link to their user page.
{{rank|wanderer}}

[Wanderer]

Template:Rank allows you to display a rank name as shown in-game with a link to that rank's wiki page. It only accepts rank names in lowercase.
Press {{button|R}} to fly and go brrrr- oh wait, it's [[Ranks#Helper|staff only]].. Press R to fly and go brrrr- oh wait, it's staff only.. You won't use Template:Button often – it's only used in the context of guides, where a button or a key is to be mentioned.
⚠️ Warning: Template:MCColor and the color parameter in CSS need to be invoked as-is, with the same spelling, so the Commonwealth spelling can't be used.

If you feel ready to use more advanced methods of styling your pages, you can read the advanced subpage of this guide and the full template list.
Hopefully, with these guides, you should be able to contribute to the wiki with style! :^)