Rozdíly

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

--- informace:jak_psat [2014/11/06 21:59] – Links adapted because of a move operation 94.113.89.211
+++ informace: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 ======
-Jako všechno na vpsFree, i KB bude fungovat pouze pokud se zapojí komunita. Vše by ovšem mělo mít svůj řád a pořádek, shrneme si tedy nějaké základní pravidla, která by se měla dodržovat př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 a následně zadáme přihlašovací údaje do vpsAdminu.
-  - **Přečtěte si stránku o [[wiki:syntax|syntaxi]]**
+===== Př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še 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é]] a [[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.

Znalostní báze

Uživatelské nástroje

Nástroje pro tento web

Rozdíly

Nástroje pro stránku