Help:Editing Guidelines: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Initial, still WIP)
 
m (Fix typo)
 
(19 intermediate revisions by 5 users not shown)
Line 1: Line 1:
> '''This page is work in progress (WIP)''' <
{{Important Note|This wiki is an older version ({{CURRENTVERSION}}), functionality from the [https://www.mediawiki.org Mediawiki] help pages may not always work.}}
Before you contribute to the Multi Theft Auto Wiki make sure you know/understand the basics of [http://www.mediawiki.org/wiki/Help:Contents MediaWiki]. This article is a guide on how to edit the MTA Wiki properly.


Before you contribute to the Multi Theft Auto Wiki make sure you know/understand the basics of [http://www.mediawiki.org/wiki/Help:Contents MediaWiki].
== Editing Pages ==
<div style="font-size: 85%;">''MediaWiki general help page: [http://www.mediawiki.org/wiki/Help:Editing_pages Editing Pages]''</div>
{{Note|Don't duplicate content on the wiki use [[#Templates|templates]] instead if you want to use the same content on multiple pages.}}
=== Minor Edits ===
From Wikipedia: "A check to the "minor edit" box signifies that only superficial differences exist between the version with your edit and the previous version: typo corrections, formatting and presentational changes, rearranging of text without modifying content, etc. A minor edit is a version that the editor believes requires no review and could never be the subject of a dispute. The "minor edit" option is one of several options available only to registered users."<ref>http://en.wikipedia.org/wiki/Help:Minor_edit</ref>


== Editing Pages ==
=== Editing Function/Event Pages ===
[[File:Layout function page.png|thumb|Layout Function Pages]]
[[File:Layout function page.png|thumb|Layout Function Pages]]
<div style="font-size: 85%;">''MediaWiki general help page: [http://www.mediawiki.org/wiki/Help:Editing_pages Editing Pages]''</div>


Specific information for editing the MTA Wiki.
Specific information for editing the MTA Wiki.


==== Contents of Function/Event Pages ====
===== Contents of Function/Event Pages =====
Function and event pages have a layout that is easy to identify and consistent. Before adding function and/or event pages make sure they do exist in the MTA Core!
Function and event pages have a layout that is easy to identify and consistent. Before adding function and/or event pages make sure they do exist in the MTA Core!


===== Layout Function Pages =====
====== Layout Function Pages ======
* No Table of Contents: <nowiki>__NOTOC__</nowiki>
* No Table of Contents: <nowiki>__NOTOC__</nowiki>
* Define Function Server and/or client function: <nowiki>{{Server client function}}</nowiki>
* Define if function is server and/or client: <nowiki>{{Server client function}}</nowiki>
** Server only function:  <nowiki>{{Server function}}</nowiki>
** Server only function:  <nowiki>{{Server function}}</nowiki>
** Client only function:  <nowiki>{{Client function}}</nowiki>
** Client only function:  <nowiki>{{Client function}}</nowiki>
Line 23: Line 27:
** Optional Arguments (not always necessary)
** Optional Arguments (not always necessary)
* Returns
* Returns
* Example: If the function is both client and server make sure you add at least one for the server and one for the client. Or add template <nowiki>{{Needs Example}}</nowiki> at the top of the page.
* Example
* See Also: Add the template to which function group this function belongs
* See Also: Add the template to which function group this function belongs


===== Layout Event Pages =====
====== Layout Event Pages ======
TODO
* No Table of Contents: <nowiki>__NOTOC__</nowiki>
* Define if event is server or client: <nowiki>{{server event}}</nowiki>
** Server event:  <nowiki>{{Server event}}</nowiki>
** Client event:  <nowiki>{{Client event}}</nowiki>
* Parameters
* Source: The source of the event.
* Example
* See Also
 
Events can only be server or client side not both.


===== Tips =====
===== Tips =====
* When creating a new page, you need to edit the template for 'See Also' too. If you don't add it to a function group template this page is considered orphaned and no one will find it unless they use the search function.
* When creating a new page for a function or event, you need to edit the template for 'See Also' too. If you don't add it to a function/event group template this page is orphaned.
* If you add examples to a page make sure to remove template <nowiki>{{Needs Example}}</nowiki> when necessary.  
* When you don't want to add examples, add the <nowiki>{{Needs Example}}</nowiki> template at the top of the page.
* If you added examples to a page make sure to remove template <nowiki>{{Needs Example}}</nowiki> when necessary.  
 
== Script Examples ==
{{note|When writing a script example always test and verify that your example is working, submitting not working examples is a waste of time for everyone.}}
 
* Preferably use four spaces instead of one tabulator.
* Use the syntaxhighlighting codebox provided on this wiki. (<nowiki><syntaxhighlight lang="lua">(CODE HERE)</syntaxhighlight></nowiki>)
* If the event/function is both client and server you should use the section template with server and/or client classes.
** For server side examples: <nowiki><section name="Example 1" </nowiki>'''class="server"'''<nowiki> show="true"></section></nowiki>
** For client side examples: <nowiki><section name="Example 2" </nowiki>'''class="client"'''<nowiki> show="false"></section></nowiki>
 
When an event/function is only client or server side you should only use the code box and not the section tags.
 
If there are enough scripting examples, remove the template <nowiki>{{Needs Example}}</nowiki> or the <nowiki>[[Category:Needs Example]]</nowiki> when necessary.
 
== Templates ==
<div style="font-size: 85%;">''MediaWiki general help page: [http://www.mediawiki.org/wiki/Help:Templates Templates]''</div>
Templates are a consistent set of visual styling and can be used in articles to get the reader's attention or mark a page for example as outdated. Some templates also require arguments, for more information on how to use MTA's specific wiki templates go [[Help:MTA Wiki Specific Templates|here]].
{{Tip|If you want to avoid spacing between the page title and the template itself, you should include the template before <nowiki>__NOTOC__</nowiki> other templates and/or [http://www.mediawiki.org/wiki/Help:Magic_words magic words].}}
Using templates is recommended when using the same content over a large number of pages. This will save you time when you want to change something in that content and doesn't require you to edit all the pages but just the template.
 
* [[Help:MTA Wiki Specific Templates|How to use MTA Wiki's Specific templates]]
 
== Protected Pages ==
Protected pages cannot be modified by normal users, if you want to change something on a protected page you will have to ask someone who has the right permissions to modify them.<ref>http://www.mediawiki.org/wiki/Help:Protected_pages</ref>
 
== Orphaned Pages ==
A page is considered orphaned when no other page(s) link to that page. This means no one will find it unless they use the search function.
* [[Special:LonelyPages|Orphaned pages]]
* [[Adding Pages to Categories and Templates]]
 
== Icons ==
When you want to use icons, it is recommended to use general icons this improves the consistency of the wiki.
 
* [https://commons.wikimedia.org/wiki/Tango_icons Tango Icons]
 
== Helpful links ==
* [http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet Wikipedia Cheatsheet] - Quick overview of general editing tags and functions.
* [http://www.mediawiki.org/wiki/Help:Contents MediaWiki Help] - General help for the MediaWiki software.
* [http://meta.wikimedia.org/wiki/Help:Wikitext Mediawiki Examples]
 
== References ==
<references></references>


[[Category:MTA Wiki:Editing]]
[[Category:MTA Wiki:Editing]]
[[ru:Help:Editing Guidelines]]

Latest revision as of 20:55, 22 February 2024

[[{{{image}}}|link=|]] Important Note: This wiki is an older version (1.39.3), functionality from the Mediawiki help pages may not always work.

Before you contribute to the Multi Theft Auto Wiki make sure you know/understand the basics of MediaWiki. This article is a guide on how to edit the MTA Wiki properly.

Editing Pages

MediaWiki general help page: Editing Pages
[[{{{image}}}|link=|]] Note: Don't duplicate content on the wiki use templates instead if you want to use the same content on multiple pages.

Minor Edits

From Wikipedia: "A check to the "minor edit" box signifies that only superficial differences exist between the version with your edit and the previous version: typo corrections, formatting and presentational changes, rearranging of text without modifying content, etc. A minor edit is a version that the editor believes requires no review and could never be the subject of a dispute. The "minor edit" option is one of several options available only to registered users."[1]

Editing Function/Event Pages

Layout Function Pages

Specific information for editing the MTA Wiki.

Contents of Function/Event Pages

Function and event pages have a layout that is easy to identify and consistent. Before adding function and/or event pages make sure they do exist in the MTA Core!

Layout Function Pages
  • No Table of Contents: __NOTOC__
  • Define if function is server and/or client: {{Server client function}}
    • Server only function: {{Server function}}
    • Client only function: {{Client function}}
    • Both client and server: {{Server client function}}
  • Explain the function
  • Syntax: Use <syntaxhighlight lang="lua"></syntaxhighlight>
    • Required Arguments
    • Optional Arguments (not always necessary)
  • Returns
  • Example
  • See Also: Add the template to which function group this function belongs
Layout Event Pages
  • No Table of Contents: __NOTOC__
  • Define if event is server or client: {{server event}}
    • Server event: {{Server event}}
    • Client event: {{Client event}}
  • Parameters
  • Source: The source of the event.
  • Example
  • See Also

Events can only be server or client side not both.

Tips
  • When creating a new page for a function or event, you need to edit the template for 'See Also' too. If you don't add it to a function/event group template this page is orphaned.
  • When you don't want to add examples, add the {{Needs Example}} template at the top of the page.
  • If you added examples to a page make sure to remove template {{Needs Example}} when necessary.

Script Examples

[[{{{image}}}|link=|]] Note: When writing a script example always test and verify that your example is working, submitting not working examples is a waste of time for everyone.
  • Preferably use four spaces instead of one tabulator.
  • Use the syntaxhighlighting codebox provided on this wiki. (<syntaxhighlight lang="lua">(CODE HERE)</syntaxhighlight>)
  • If the event/function is both client and server you should use the section template with server and/or client classes.
    • For server side examples: <section name="Example 1" class="server" show="true"></section>
    • For client side examples: <section name="Example 2" class="client" show="false"></section>

When an event/function is only client or server side you should only use the code box and not the section tags.

If there are enough scripting examples, remove the template {{Needs Example}} or the [[Category:Needs Example]] when necessary.

Templates

MediaWiki general help page: Templates

Templates are a consistent set of visual styling and can be used in articles to get the reader's attention or mark a page for example as outdated. Some templates also require arguments, for more information on how to use MTA's specific wiki templates go here.

[[{{{image}}}|link=|]] Tip: If you want to avoid spacing between the page title and the template itself, you should include the template before __NOTOC__ other templates and/or magic words.

Using templates is recommended when using the same content over a large number of pages. This will save you time when you want to change something in that content and doesn't require you to edit all the pages but just the template.

Protected Pages

Protected pages cannot be modified by normal users, if you want to change something on a protected page you will have to ask someone who has the right permissions to modify them.[2]

Orphaned Pages

A page is considered orphaned when no other page(s) link to that page. This means no one will find it unless they use the search function.

Icons

When you want to use icons, it is recommended to use general icons this improves the consistency of the wiki.

Helpful links

References