Difference between revisions of "How to contribute"

From Mashinky
Jump to: navigation, search
(Added czech version of "how to contribute". Need revision and translation.)
Line 4: Line 4:
 
'''THIS PAGE IS UNDER DEVELOPMENT'''
 
'''THIS PAGE IS UNDER DEVELOPMENT'''
  
----
 
  
 +
Před první editací je dobré přečíst si následující text. Chceme aby Mashinky Wiki byl stále aktuální a přehledný zdroj informací ke hře a vše kolem ní. Proto je třeba respektovat následující pravidla.
 +
 +
Mashinky Wiki se řídí pravidly wiki, což znamená, že každý může upravit libovolnou nechráněnou stránku a okamžitě vylepšit články pro všechny čtenáře. Stačí se zaregistrovat.
 +
Existují ovšem stránky, stejně jako hlavní stránka, které jsou chráněny před úpravou. Tyto stránky poznáte tak, že místo karty <code>Edit</code> vidíte kartu <code>View&nbsp;source</code>. V případě, že potřebujete upravit některou z chráněných stránek, kontaktujte některého z [[Special:ListUsers/sysop|Administrators]].
 +
 +
V případě, že potřebujete jinou pomoc, kontaktujte některého z [[Special:ListUsers/editors|Editors]] na jejich <code>Talk</code> stránce.
 +
 +
 +
===Založení stránky===
 +
 +
Před založením stránky si vždy zkontrolujte, zda na stránkách wiki ještě není. Případně její obdoba pod jiným názvem. Dále je třeba stránku správně kategorizovat. Dále viz editace stránky.
 +
 +
===Editace stránky===
 +
 +
Úprava většiny stránek je jednoduchá. K formátování textu požíváme [https://en.wikipedia.org/wiki/Help:Wiki_markup wiki markup] (wikitext). Slouží k označení odkazů, vložení obrázků, tabulek, citací atd.
 +
Nejsnažší způsob je podívat se do již existující stránky, kde je obdobný obsah, který chcete vytvořit. Stránky by měli vypadat pokud možno jednotně.
 +
V každém případě je třeba editovat stránky tak, aby byl zachován encyklopedický styl. S nadhledem, věcně, bez osobních názorů. Pakliže používáte zdroj informací z jiného zdroje, než je samotná hra, je ideálně třeba vypsat i zdroj těchto informací, aby byly snadno dohledatelné a ověřitelné.
 +
Rozhodně doporučujeme zkopírovat původní kód stránky do externího textového editoru, nejlépe bez formátování - například do Notepadu. V případě, že se něco pokazí, můžete hned vrátit původní podobu stránky. Stejně tak je vhodné ukládat si průběžně svoje úpravy. Například při spadnutí prohlížeče vám to může zachránit hodně práce.
 +
 +
====Minor edit====
 +
Označením Minor edit se rozumí, že jste na stránce provedli jen minimální úpravy. Oprava gramatiky, změny ve formátování textu, atd. Změny, které ale nemění obsah článku. Editorům dáváte na vědomí, že tuto změnu není třeba důkladně kontrolovat. Nicméně i tyto změny jsou důležité a ceněné. Dovádějí články k lepší podobě.
 +
 +
====Major edit====
 +
Všechny ostatní úpravy, i kdyby se jednalo o jedno slovo, které mění význam článku, jsou považovány za zásadní úpravy.
 +
Nebojte se úprav, ale dobře si rozmyslete, než takovou úpravu provedete. Pakliže existuje k danému článku diskuze, je dobré zohlednit i názory ostatních uživatelů a jimi navrhované úpravy. Pamatujte na to, že větší úpravy budou zkontrolovány a reflektuje současné potřeby jak komunity, tak samotné hry. Pakliže nebudete respektovat výše zmíněná pravidla, zvýšíte tím šanci, že vaše editace bude odmítnuta, případně přepracována, aby odpovídala potřebám této wiki.
 +
 +
Před uložením stránky si zobrazte <code>Show&nbsp;preview</code> a zkontrolujte, že stránka vypadá přesně tak jak chcete. Dále vyplňte krátké shrnutí vaší editace v malém poli pod editorem. Pokud toto vše již máte hotové, klikněte na tlačítko <code>Save&nbsp;page</code>. Veškeré úpravy budou v tu chvíli viditelné pro ostatní uživatele.
 +
 +
===Přidávání odkazů===
 +
Pakliže se zmiňujete o obsahu v jiné části wiki, je dobré na tuto stránku odkázat. Více viz [https://en.wikipedia.org/wiki/Help:Wikitext#Links_and_URLs Links and URLs]
 +
 +
===Přidávání obrázků, videí a zvuků===
 +
Pokud již byl soubor na wiki vložen, můžete ho použít pomocí syntaxe: <code><nowiki>[[File:FILENAME.EXT|thumb|DESCRIPTION]]</nowiki></code>". ("<code>File:</code>" může být nahrazeno "<code>Image:</code>". Na funkčnost to nemá žádný vliv, jde jen o to, co používáte raději. Nicméně pro obrázky je vhodnější používat <code>Image:</code>).
 +
Přidat obrázek lze na stránce [[Special:Upload|Upload file]]. Opět, před přidáváním obrázku si ověřte, že obrázek na wiki nevložil již někdo před vámi.
 +
Více viz: [https://en.wikipedia.org/wiki/Help:Wikitext#Images Images]
 +
 +
===Diskusní stránky===
 +
 +
Každý článek na Wiki má stránku pro diskuzi, k níž se dostanete kliknutím na kartu <code>Talk</code> nacházející se nad nadpisem. Tam mohou uživatelé diskutovat o vylepšení článku. Pokud provedete změnu, která je vrácena, či změněna někým jiným, diskutujte o změně na stránce pro diskusi! Vždy se dá dojít ke kompromisu. Respektujte názory ostatních, buďte slušní. I ostatní mohou mít pravdu a ne vždy je vaše pravda ta nejlepší. Agresivní chování a přepisování článků proti vůli ostatních nebude tolerováno.
 +
 +
Většina ostatních typů stránek na Wiki má také přidružené diskusní stránky, včetně stránky uživatele. Pokud vás ostatní redaktoři potřebují kontaktovat, obvykle to udělají tím, že zanechají vzkaz na vaší diskusní stránce. Když vám někdo ponechal zprávu, uvidíte upozornění při dalším načtení stránky jakékoliv stránky.
 +
 +
Podepisujte své příspěvky v diskuzích pomocí čtyř tildes (<nowiki>~~~~</nowiki>). Toto vytvoří váš podpis složený z uživatelského jména a časového a datového razítka.
 +
 +
=== Resource Icon list===
  
 
Wherever you mention raw materials, products, or tokens please use relevant icons. The recommended icon size in the text is 16px.
 
Wherever you mention raw materials, products, or tokens please use relevant icons. The recommended icon size in the text is 16px.
  
 
'''Example''': 1 Coal Token ([[File:token coal.png|16px]]), 1 Timber Token ([[File:token timber.png|16px]]), 1 Iron Token ([[File:token iron.png|16px]])
 
'''Example''': 1 Coal Token ([[File:token coal.png|16px]]), 1 Timber Token ([[File:token timber.png|16px]]), 1 Iron Token ([[File:token iron.png|16px]])
 
=== Resource Icon list===
 
  
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"

Revision as of 16:02, 28 November 2017

Help page for contribution to Mashinky wiki.


THIS PAGE IS UNDER DEVELOPMENT


Před první editací je dobré přečíst si následující text. Chceme aby Mashinky Wiki byl stále aktuální a přehledný zdroj informací ke hře a vše kolem ní. Proto je třeba respektovat následující pravidla.

Mashinky Wiki se řídí pravidly wiki, což znamená, že každý může upravit libovolnou nechráněnou stránku a okamžitě vylepšit články pro všechny čtenáře. Stačí se zaregistrovat. Existují ovšem stránky, stejně jako hlavní stránka, které jsou chráněny před úpravou. Tyto stránky poznáte tak, že místo karty Edit vidíte kartu View source. V případě, že potřebujete upravit některou z chráněných stránek, kontaktujte některého z Administrators.

V případě, že potřebujete jinou pomoc, kontaktujte některého z Editors na jejich Talk stránce.


Založení stránky

Před založením stránky si vždy zkontrolujte, zda na stránkách wiki ještě není. Případně její obdoba pod jiným názvem. Dále je třeba stránku správně kategorizovat. Dále viz editace stránky.

Editace stránky

Úprava většiny stránek je jednoduchá. K formátování textu požíváme wiki markup (wikitext). Slouží k označení odkazů, vložení obrázků, tabulek, citací atd. Nejsnažší způsob je podívat se do již existující stránky, kde je obdobný obsah, který chcete vytvořit. Stránky by měli vypadat pokud možno jednotně. V každém případě je třeba editovat stránky tak, aby byl zachován encyklopedický styl. S nadhledem, věcně, bez osobních názorů. Pakliže používáte zdroj informací z jiného zdroje, než je samotná hra, je ideálně třeba vypsat i zdroj těchto informací, aby byly snadno dohledatelné a ověřitelné. Rozhodně doporučujeme zkopírovat původní kód stránky do externího textového editoru, nejlépe bez formátování - například do Notepadu. V případě, že se něco pokazí, můžete hned vrátit původní podobu stránky. Stejně tak je vhodné ukládat si průběžně svoje úpravy. Například při spadnutí prohlížeče vám to může zachránit hodně práce.

Minor edit

Označením Minor edit se rozumí, že jste na stránce provedli jen minimální úpravy. Oprava gramatiky, změny ve formátování textu, atd. Změny, které ale nemění obsah článku. Editorům dáváte na vědomí, že tuto změnu není třeba důkladně kontrolovat. Nicméně i tyto změny jsou důležité a ceněné. Dovádějí články k lepší podobě.

Major edit

Všechny ostatní úpravy, i kdyby se jednalo o jedno slovo, které mění význam článku, jsou považovány za zásadní úpravy. Nebojte se úprav, ale dobře si rozmyslete, než takovou úpravu provedete. Pakliže existuje k danému článku diskuze, je dobré zohlednit i názory ostatních uživatelů a jimi navrhované úpravy. Pamatujte na to, že větší úpravy budou zkontrolovány a reflektuje současné potřeby jak komunity, tak samotné hry. Pakliže nebudete respektovat výše zmíněná pravidla, zvýšíte tím šanci, že vaše editace bude odmítnuta, případně přepracována, aby odpovídala potřebám této wiki.

Před uložením stránky si zobrazte Show preview a zkontrolujte, že stránka vypadá přesně tak jak chcete. Dále vyplňte krátké shrnutí vaší editace v malém poli pod editorem. Pokud toto vše již máte hotové, klikněte na tlačítko Save page. Veškeré úpravy budou v tu chvíli viditelné pro ostatní uživatele.

Přidávání odkazů

Pakliže se zmiňujete o obsahu v jiné části wiki, je dobré na tuto stránku odkázat. Více viz Links and URLs

Přidávání obrázků, videí a zvuků

Pokud již byl soubor na wiki vložen, můžete ho použít pomocí syntaxe: [[File:FILENAME.EXT|thumb|DESCRIPTION]]". ("File:" může být nahrazeno "Image:". Na funkčnost to nemá žádný vliv, jde jen o to, co používáte raději. Nicméně pro obrázky je vhodnější používat Image:). Přidat obrázek lze na stránce Upload file. Opět, před přidáváním obrázku si ověřte, že obrázek na wiki nevložil již někdo před vámi. Více viz: Images

Diskusní stránky

Každý článek na Wiki má stránku pro diskuzi, k níž se dostanete kliknutím na kartu Talk nacházející se nad nadpisem. Tam mohou uživatelé diskutovat o vylepšení článku. Pokud provedete změnu, která je vrácena, či změněna někým jiným, diskutujte o změně na stránce pro diskusi! Vždy se dá dojít ke kompromisu. Respektujte názory ostatních, buďte slušní. I ostatní mohou mít pravdu a ne vždy je vaše pravda ta nejlepší. Agresivní chování a přepisování článků proti vůli ostatních nebude tolerováno.

Většina ostatních typů stránek na Wiki má také přidružené diskusní stránky, včetně stránky uživatele. Pokud vás ostatní redaktoři potřebují kontaktovat, obvykle to udělají tím, že zanechají vzkaz na vaší diskusní stránce. Když vám někdo ponechal zprávu, uvidíte upozornění při dalším načtení stránky jakékoliv stránky.

Podepisujte své příspěvky v diskuzích pomocí čtyř tildes (~~~~). Toto vytvoří váš podpis složený z uživatelského jména a časového a datového razítka.

Resource Icon list

Wherever you mention raw materials, products, or tokens please use relevant icons. The recommended icon size in the text is 16px.

Example: 1 Coal Token (Token coal.png), 1 Timber Token (Token timber.png), 1 Iron Token (Token iron.png)

Image Image name Category
Token money.png token money.png Tokens
Token timber.png token timber.png Tokens
Token coal.png token coal.png Tokens
Token iron.png token iron.png Tokens
Token diesel.png token diesel.png Tokens
Token steel.png token steel.png Tokens
Token energy.png token energy.png Tokens
Token cement.png token cement.png Tokens
Token superconductors.png token superconductors.png Tokens
Icon passengers.png icon passengers.png Cargo types
Icon mail.png icon mail.png Cargo types
Icon oil.png icon oil.png Cargo types
Icon uranium.png icon uranium.png Cargo types
Icon logs.png icon logs.png Cargo types
Icon timber.png icon timber.png Cargo types
Icon diesel.png icon diesel.png Cargo types
Icon iron ore.png icon iron ore.png Cargo types
Icon coal.png icon coal.png Cargo types
Icon cobblestone.png icon cobblestone.png Cargo types
Icon iron.png icon iron.png Cargo types
Icon steel.png icon steel.png Cargo types
Icon superconductors.png icon superconductors.png Cargo types
Icon energy.png icon energy.png Cargo types
Icon cement.png icon cement.png Cargo types
Icon cobalt.png icon cobalt.png Cargo types
Icon gold.png icon gold.png Cargo types