Uživatelské nástroje

Nástroje pro tento web


informace:jak_psat

Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

Odkaz na výstup diff

Obě strany předchozí revizePředchozí verze
Následující verze
Předchozí verze
informace:jak_psat [2014/11/06 21:59] – Links adapted because of a move operation 94.113.89.211informace:jak_psat [2024/01/01 12:47] (aktuální) – page id aither
Řádek 1: Řádek 1:
 +<page>information:kb</page>
 ====== Jak přispívat do Znalostní Báze ====== ====== Jak přispívat do Znalostní Báze ======
-Jako všechno na vpsFree, i KB bude fungovat pouze pokud se zapojí komunitaVše by ovšem mělo mít svůj řád pořádek, shrneme si tedy nějaké základní pravidla, která by se měla dodržovat i přispívání.+Do znalostní báze může pṙispět kterýkoliv člen vpsFree.cz. Pod přihlašovacím formulářem je "Přihlásit se pomocí jiných služeb", tam klikneme na vpsAdmin následně zadáme ihlašovací údaje do vpsAdminu.
  
-  - **Přečtěte si stránku o [[wiki:syntax|syntaxi]]** +===== eklady a prolinkování stránek ===== 
-  - dodržovat [[https://www.dokuwiki.org/cs:namespaces|Jmenné prostory]]  (Jmenné prostory(sekce) jsou vidět v navigaci.) +NašKB zatím existuje ve dvou jazykových verzích, 
-  - Řídit se referenční stránkou o [[navody:server:SSH]] (Později bude dostupná i šablona) +[[https://kb.vpsfree.org|anglické]] [[https://kb.vpsfree.cz|české]]. 
-  - psát jako člověk, tedy s diakritikou a bez pravopisných chyb +Pro prolinkování stejných stránek v různých jazycích máme vlastní 
-  - správně [[https://www.dokuwiki.org/cs:wiki:syntax|formátovat text]] a dodržovat strukturu nadpisů tak, aby následně vygenerovaná navigace dávala smysl +[[https://github.com/vpsfreecz/dokuwiki-plugin-mlfarm|plugin]]. 
-  - u příkladů konfigurací uvádět pro jakou distribuci jsou psané, například Apache má jinou strukturu konfiguračních souboru v debian-based distrech než v RHEL-based +Ten umožnuje stránky označit pomocí tagu ''%%<page>nazev stranky</page>%%''. 
-  - pokud děláte větší úpravy v článku, který jste nepsali vy, je vhodné předem kontaktovat původního autora +Stránky se stejným jménem jsou pak navzájem propojeny. Jména stránek se řídí 
-  - pokud chcete o něčem psát napište mi(Kontakt je níže)+podle [[https://kb.vpsfree.org|anglické KB]].
  
 +Například, pokud je v anglické KB stránka
 +[[https://kb.vpsfree.org/information/association|information:association]] a
 +chceme ji propojit s českou stránkou
 +[[https://kb.vpsfree.cz/informace/sdruzeni|informace:sdruzeni]], přidáme
 +kdekoli do české stránky následující tag:
  
 +<code>
 +<page>information:association</page>
  
 +... text stránky ...
 +</code>
 +
 +Pro přehlednost přidávejte tag prosím vždy na první řádek. Anglická KB se
 +považuje za hlavní, takže tam se tento tag nikde psát nemusí.
 +
 +===== Média =====
 +Všechny obrázky a jiné datové soubory jsou sdílené pro obě KB. Jinými slovy,
 +nahrajeme-li soubor do jedné KB, objeví se i ve všech ostatních překladech KB.
 +Pokud je potřeba mít pro různé jazykové verze jiné média (zejména obrázky),
 +umístěte je do adresáře pojmenovaného kódem jazyka, tj. např. ''en'', ''cs'', apod.
 +
 +===== Maintaineři =====
 +Každá stránka může mít přiřazeno jednoho čí více maintainerů. Maintainer je
 +člověk, který se stará o to, že je obsah na dané stránce aktuální a jsou tam
 +ověřené informace.
 +
 +V KB mají maintaineří pouze informační hodnotu, tzn. na koho se obrátit v
 +případě dotazu či nápadu na vylepšení. Drobné změny, opravy či přidávání dalších
 +informací můžete samozřejmě provádět přímo. Pokud sem napíšeš nějaký návod a měl bys
 +čas se o něj starat, zapiš se u něj prosím jako maintainer.
 +
 +Náš IRC [[informace:chat#bot|bot]] pravidelně kontroluje změny v KB a informuje o
 +nich na IRC. Pokud má maintainer v KB vyplněn nick na IRC, bot ho při změně
 +stránky na IRC pingne.
 +
 +Na stránce se maintaineři nastavují pomocí tagu ''%%<maintainers>%%'':
 +
 +<code>
 +<maintainers>
 +aither
 +nick2 (prvni sekce)
 +nick3 (druha sekce)
 +</maintainers>
 +</code>
 +
 +První slovo na každém řádku je nick maintainera, z kterého se udělá odkaz na stránku
 +''uzivatele:<nick>''. Tu si musí každý maintainer sám vytvořit. Na těchto
 +stránkách jsou uloženy profily maintainerů, specifikují se tagem
 +''%%<maintainer>%%'':
 +
 +<code>
 +<maintainer name="Moje Jmeno">
 +irc nick_na_irc
 +mail nekdo@domena.tld
 +</maintainer>
 +</code>
 +''irc'' i ''mail'' jsou nepovinné.
 +Z tohoto profilu si IRC bot vytáhne nick maintainera na IRC a pingne ho při
 +změně nějaké z jeho stránek.
 +
 +<maintainers hidden>
 +aither
 +krcmar
 +kerrycze
 +</maintainers>
  
-O tuto KB se stará psjb. V případě jakýchkoliv návrhů, nápadů se mi nebojte dát vědět. [[jaroslav.shejbal@vpsfree.cz]] 
-Pozn.: KB má stejnou databázi uživatelů jako vpsAdmin. Registrace jsou zablokovány. 
informace/jak_psat.1415311174.txt.gz · Poslední úprava: 2014/11/06 21:59 autor: 94.113.89.211