From 1531b43c241cd0f46fbe62fbd0481fef959f83bb Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Thu, 14 Oct 2010 13:38:13 +0200 Subject: Sync with ikiwiki 3.20100926. --- ikiwiki/directive.mdwn | 43 ++++++++++++++++ ikiwiki/formatting.mdwn | 104 ++++++++++++++++++++++++++++++++++++++ ikiwiki/markdown.mdwn | 11 ++++ ikiwiki/openid.mdwn | 28 ++++++++++ ikiwiki/pagespec.mdwn | 86 +++++++++++++++++++++++++++++++ ikiwiki/pagespec/attachment.mdwn | 36 +++++++++++++ ikiwiki/pagespec/po.mdwn | 22 ++++++++ ikiwiki/searching.mdwn | 19 +++++++ ikiwiki/subpage.mdwn | 14 +++++ ikiwiki/subpage/linkingrules.mdwn | 35 +++++++++++++ ikiwiki/wikilink.mdwn | 31 ++++++++++++ 11 files changed, 429 insertions(+) create mode 100644 ikiwiki/directive.mdwn create mode 100644 ikiwiki/formatting.mdwn create mode 100644 ikiwiki/markdown.mdwn create mode 100644 ikiwiki/openid.mdwn create mode 100644 ikiwiki/pagespec.mdwn create mode 100644 ikiwiki/pagespec/attachment.mdwn create mode 100644 ikiwiki/pagespec/po.mdwn create mode 100644 ikiwiki/searching.mdwn create mode 100644 ikiwiki/subpage.mdwn create mode 100644 ikiwiki/subpage/linkingrules.mdwn create mode 100644 ikiwiki/wikilink.mdwn (limited to 'ikiwiki') diff --git a/ikiwiki/directive.mdwn b/ikiwiki/directive.mdwn new file mode 100644 index 0000000..8d3f075 --- /dev/null +++ b/ikiwiki/directive.mdwn @@ -0,0 +1,43 @@ +[[!meta robots="noindex, follow"]] +Direktivy se podobají [[wiki odkazům|ikiwiki/WikiLink]], až na to, že +začínají vykřičníkem a mohou obsahovat parametry. Obecný formát vypadá +následovně: + + \[[!direktiva param="hodnota" param="hodnota"]] + +Direktivy se aplikují před zpracováním zbytku stránky a mohou stránku +nejrůznějším způsobem měnit. + +Uvozovky okolo hodnot mohou být vynechány v případě, že je hodnotou jediné +slovo. Některé direktivy mohou používat parametry bez hodnot. Například: + + \[[!tag foo]] + +Direktiva nemusí být zapsána celá na jednom řádku. Pokud je to čitelnější, +můžete ji roztáhnout přes více řádků: + + \[[!direktiva foo="baldersnatch" + bar="supercalifragilisticexpialidocious" baz=11]] + +Více řádků *uvozeného* textu lze použít i v hodnotě. Chcete-li v uvozeném +textu použít (anglické) uvozovky, obklopte text trojitými uvozovkami: + + \[[!direktiva text=""" + 1. "něco" + 2. "cosi" + 3. "cokoliv" + """]] + +ikiwiki podporuje i starší zápis direktiv, který vyžaduje, aby se v +direktivě nacházela mezera, což ji odliší od [[wiki +odkazů|ikiwiki/wikilink]]. Tento zápis má několik nevýhod: vyžaduje za +direktivou bez parametrů mezeru (například `\[[pagecount ]]`) a naopak +neumožňuje mezery ve [[wiki odkazech|ikiwiki/wikilink]]. Zápis direktiv s +`!` na začátku je v ikiwiki výchozí, ale chcete-li použít starší způsob +zápisu, stačí vypnout volbu `prefix_directives`. + +[[!if test="enabled(listdirectives)" then=""" +Následuje seznam direktiv povolených v této wiki: + +[[!listdirectives ]] +"""]] diff --git a/ikiwiki/formatting.mdwn b/ikiwiki/formatting.mdwn new file mode 100644 index 0000000..c35cbf9 --- /dev/null +++ b/ikiwiki/formatting.mdwn @@ -0,0 +1,104 @@ +[[!meta title="Formátování wiki stránek"]] +[[!meta robots="noindex, follow"]] + +Text na této wiki je psán hodně podobně tomu, jak byste mohli psát +email. Tento styl formátování se nazývá [[Markdown]] a používá se +následovně: + +Odstavce oddělujte prázdnými řádky. + +Text můžete *\*zvýraznit\** nebo **\*\*silně zdůraznit\*\*** uzavřením mezi +jedny nebo dvoje hvězdičky. + +Pro vytvoření seznamu začněte každý řádek hvězdičkou: + +* "* toto je můj seznam" +* "* další položka" + +Pro vytvoření číslovaného seznamu začněte každý řádek číslem (libovolným) +následovaným tečkou: + +1. "1. první řádek" +2. "2. druhý řádek" +2. "2. třetí řádek" + +Pro vytvoření nadpisu začněte řádek jedním nebo více znaky `#`, mezerou a +textem nadpisu. Počet znaků `#` určuje velikost nadpisu: + +# # h1 +## ## h2 +### ### h3 +#### #### h4 +##### ##### h5 +###### ###### h6 + +Pro vytvoření horizontální čáry napište na samostatný řádek alespoň tři +pomlčky nebo hvězdičky: + +---- + +Chcete-li někoho citovat, uvoďte citaci znakem „>“: + +> Být či nebýt, +> toť oč tu běží. + +Pro zápis bloku kódu odsaďte každý řádek tabulátorem nebo čtyřmi mezerami: + + 10 PRINT "Hello, world!" + 20 GOTO 10 + +Pro vytvoření odkazu na url nebo emailovou adresu můžete jednoduše uzavřít url do špičatých závorek: <>, nebo použít formu \[text odkazu\]\(url\) + +---- + +Kromě základního html formátování pomocí [[MarkDown]]u vám tato wiki dává k +dispozici následující vylepšení: + +* Odkaz na jinou stránku ve wiki vytvoříte tak, že jméno stránky uzavřete do + dvojice hranatých závorek. Pro odkaz na stránku [[WikiLink]] byste použili + `\[[WikiLink]]`. + +[[!if test="enabled(smiley) and smileys" then=""" +* Vkládání [[smajlíků|smileys]] a několika dalších užitečných symbolů. :-) +"""]] + +[[!if test="enabled(shortcut) and shortcuts" then=""" +* Použití [[zkratek|shortcuts]] pro odkazy na běžné zdroje. + + \[[!wikipedia War\_of\_1812]] +"""]] + +[[!if test="enabled(template) and templates" then=""" +* Vytváření a používání [[šablon|templates]] pro opakované kusy + parameterizovaného wiki textu. +"""]] + +* Vkládání různých [[direktiv|directive]], které mohou provádět užitečné + akce. +[[!if test="enabled(toc) or enabled(meta) or enabled(inline)" then=""" + Například můžete: +"""]] + +[[!if test="enabled(toc)" then=""" + * Přidat do stránky obsah: + + \[[!toc]] +"""]] + + +[[!if test="enabled(meta)" then=""" + * Změnit název stránky: + + \[[!meta title="Kompletní název stránky"]] +"""]] + +[[!if test="enabled(inline)" then=""" + * Vytvořit blog vložením množiny stránek: + + \[[!inline pages="blog/*"]] +"""]] + +[[!if test="enabled(listdirectives)" then=""" + Úplný seznam [[direktiv|directive]] povolených v této wiki: + [[!listdirectives ]] +"""]] diff --git a/ikiwiki/markdown.mdwn b/ikiwiki/markdown.mdwn new file mode 100644 index 0000000..35cc003 --- /dev/null +++ b/ikiwiki/markdown.mdwn @@ -0,0 +1,11 @@ +[[!meta robots="noindex, follow"]] +[Markdown](http://daringfireball.net/projects/markdown/) je minimální +značkovací jazyk, který připomíná prostý text používaný v emailové +korespondeci. Tento značkovací jazyk je v této wiki používaný jako výchozí. + +Popis syntaxe naleznete na stránkách [[formátování|formatting]] a [Markdown: +syntax](http://daringfireball.net/projects/markdown/syntax). + +Poznamenejme, že [[wiki odkazy|WikiLink]] a [[direktivy|directive]] nejsou +součástí syntaxe Markdownu a jsou jediné části značkování, které si tato +wiki řeší interně. diff --git a/ikiwiki/openid.mdwn b/ikiwiki/openid.mdwn new file mode 100644 index 0000000..d2b0da2 --- /dev/null +++ b/ikiwiki/openid.mdwn @@ -0,0 +1,28 @@ +[[!meta title="OpenID"]] +[[!meta robots="noindex, follow"]] + +[[!if test="enabled(openid)" + then="Tato wiki má OpenID **povolené**." + else="Tato wiki má OpenID **vypnuté**."]] + +[OpenID](http://openid.net) je decentralizovaný authentizační systém, který +vám umožňuje mít jedno přihlášení, které můžete použít na stále rostoucím +počtu webů. + +If you have an account with some of the larger web service providers, you +might already have an OpenID. [Directory of OpenID +providers](http://openiddirectory.com/openid-providers-c-1.html) + +[[!if test="enabled(openid)" then=""" +Pro přihlášení do této wiki pomocí OpenID jednoduše zadejte své OpenID do +pole pro přihlášení přes OpenID. Při používání OpenID se u této wiki +nemusíte registrovat ani zadávat žádné heslo. +"""]] + +--- + +Dokonce je možné vytvořit wiki stránku, která bude sloužit jako OpenID +url. Tato stránka bude delegovat požadavky na OpenID server. Příklad: + + \[[!meta openid="http://vase-id.myopenid.com/" + server="http://www.myopenid.com/server"]] diff --git a/ikiwiki/pagespec.mdwn b/ikiwiki/pagespec.mdwn new file mode 100644 index 0000000..7d21911 --- /dev/null +++ b/ikiwiki/pagespec.mdwn @@ -0,0 +1,86 @@ +[[!meta robots="noindex, follow"]] +Pro výběr množiny stránek (jako jsou například zamknuté stránky, stránky, u +nichž chcete dostávat maily se změnami nebo třeba stránky, které chcete +zkombinovat do blogu) používá wiki něco s názvem PageSpec. PageSpec je +výraz, který se shoduje s množinou stránek. + +Nejjednodušší PageSpec je jednoduchý seznam stránek. Například následující +se shoduje s libovolnou ze tří zmíněných stránek: + + stránka1 or stránka2 or stránka3 + +Mnohem častěji budete chtít vybrat stránky, které obsahují ve svém názvu +konkrétní řetězec. K tomu můžete použít tzv. vzor, který může obsahovat +zástupné znaky. „`*`“ znamená libovolnou část názvu stránky, „`?`“ zastupuje +jedno písmeno názvu stránky. Následující příklad vybere všechny stránky o +hudbě a všechny [[podstránky|SubPage]] [[pískoviště|SandBox]] (ve wiki +uložené jako SandBox), ale ne pískoviště samotné: + + *music* or SandBox/* + +Výraz můžete uvodit znakem „`!`“ a negovat tak jeho význam, tj. přeskočit +dané stránky. Například chcete-li vybrat všechny stránky ve wiki kromě +diskuzí (uložené jako Discussion) a pískoviště (SandBox), použijte: + + * and !SandBox and !*/Discussion + +S komplikovanějšími výběry mohou pomoci následující funkce: + +* "`glob(someglob)`" - matches pages and other files that match the given glob. + Just writing the glob by itself is actually a shorthand for this function. +* "`page(glob)`" - like `glob()`, but only matches pages, not other files +* "`link(page)`" - matches only pages that link to a given page (or glob) +* "`tagged(tag)`" - matches pages that are tagged or link to the given tag (or + tags matched by a glob) +* "`backlink(page)`" - matches only pages that a given page links to +* "`creation_month(month)`" - matches only files created on the given month +* "`creation_day(mday)`" - or day of the month +* "`creation_year(year)`" - or year +* "`created_after(page)`" - matches only files created after the given page + was created +* "`created_before(page)`" - matches only files created before the given page + was created +* "`internal(glob)`" - like `glob()`, but matches even internal-use + pages that globs do not usually match. +* "`title(glob)`", "`author(glob)`", "`authorurl(glob)`", + "`license(glob)`", "`copyright(glob)`", "`guid(glob)`" + - match pages that have the given metadata, matching the specified glob. +* "`user(username)`" - tests whether a modification is being made by a + user with the specified username. If openid is enabled, an openid can also + be put here. Glob patterns can be used in the username. For example, + to match all openid users, use `user(*://*)` +* "`admin()`" - tests whether a modification is being made by one of the + wiki admins. +* "`ip(address)`" - tests whether a modification is being made from the + specified IP address. +* "`comment(glob)`" - matches comments to a page matching the glob. +* "`comment_pending(glob)`" - matches unmoderated, pending comments. +* "`postcomment(glob)`" - matches only when comments are being + posted to a page matching the specified glob + +Například pro výběr všech stránek v blogu, které se odkazují na stránku o +hudbě a byly napsány v roce 2005: + + blog/* and link(music) and creation_year(2005) + +Povšimněte si použití „and“ v předchozím příkladu. Znamená to, že se vyberou +pouze stránky, které splňují všechny tři podmínky zároveň. Pokud by stačilo, +aby byla platná alespoň jedna ze zadaných podmínek, použijte „or“. Poznámka: +výraz „index and SandBox“ nikdy nevrátí žádnou stránku, protože není možné, +aby nějaká stránka splňovala obě podmínky zároveň. + +Při vytváření komplexnějších výrazů můžete použít závorky. Například pro +výběr stránek v blogu, které mají alespoň jeden ze dvou štítků, můžete +použít: + + blog/* and (tagged(štítek1) or tagged(štítek2)) + +Jména stránek v PageSpec se porovnávají vůči absolutním jménům souborů wiki +stránek, takže PageSpec „něco“ použité na stránce „a/b“ nenajde „a/něco“ ani +„a/b/něco“. Chcete-li vyhledávat relativně k adresáři stránky, která +obsahuje PageSpec, můžete použít „./“. To znamená, že „./něco“ na stránce +„a/b“ najde stránku „a/něco“. + +To indicate the name of the page the PageSpec is used in, you can use a +single dot. For example, `link(.)` matches all the pages linking to the page +containing the PageSpec. diff --git a/ikiwiki/pagespec/attachment.mdwn b/ikiwiki/pagespec/attachment.mdwn new file mode 100644 index 0000000..80aee21 --- /dev/null +++ b/ikiwiki/pagespec/attachment.mdwn @@ -0,0 +1,36 @@ +[[!meta robots="noindex, follow"]] +[[!if test="enabled(attachment)" + then="Tato wiki má přílohy **povolené**." + else="Tato wiki má přílohy **vypnuté**."]] + +Pokud jsou přílohy povoleny, může správce wiki pomocí volby +`allowed_attachments` určovat, které typy příloh budou povoleny. + +For example, to limit most users to uploading small images, and nothing +else, while allowing larger mp3 files to be uploaded by joey into a specific +directory, and check all attachments for viruses, something like this could +be used: + + virusfree() and ((user(joey) and podcast/*.mp3 and mimetype(audio/mpeg) and maxsize(15mb)) or (mimetype(image/*) and maxsize(50kb))) + +Běžná syntaxe [[ikiwiki/PageSpec]] je rozšířena o následující testy: + +* „`maxsize(velikost)`“ - testuje, zda není příloha větší než zadaná + velikost. Velikost je standardně uváděna v bajtech, ale můžete použít i + jiné jednotky, když za velikost připojíte „kb“, „mb“, „gb“ apod. + +* „`minsize(velikost)`“ - testuje, zda není příloha menší než zadaná + velikost. + +* „`ispage()`“ - testuje, zda bude ikiwiki přílohu chápat jako wiki stránku + (tzn. zda má příloha příponu „.mdwn“, nebo příponu některého jiného + podporovaného formátu). + + Pokud nechcete umožnit nahrávání wiki stránek jako příloh, použijte + `!ispage()`. Analogicky, chcete-li umožnit nahrávání pouze wiki stránek, + použijte `ispage()`. + +* „`mimetype(něco/cosi)`“ - zkontroluje MIME typ přílohy. Můžete použít i + zástupné znaky, například `mimetype(image/*)`. + +* „`virusfree()`“ - zkontroluje přílohu antivirovým programem. diff --git a/ikiwiki/pagespec/po.mdwn b/ikiwiki/pagespec/po.mdwn new file mode 100644 index 0000000..ec9ae6d --- /dev/null +++ b/ikiwiki/pagespec/po.mdwn @@ -0,0 +1,22 @@ +[[!if test="enabled(po)" + then="Tato wiki má podporu překladů **povolenou**." + else="Tato wiki má podporu překladů **vypnutou**."]] + +Pokud je povolený modul [[!iki plugins/po desc=po]], je standardní syntaxe +[[ikiwiki/PageSpec]] rozšířena o následující testy, které lze použít pro +zlepšení navigace ve vícejazyčné wiki: + +* „`lang(LL)`“ - testuje, zda je stránka napsána v jazyce zadaném + dvoupísmenným kódem jazyka dle normy ISO639-1. +* „`currentlang()`“ - testuje, zda je stránka napsána ve stejném jazyce jako + aktuální stránka. +* "`needstranslation()`" - tests whether a page needs translation work. Only + slave pages match this PageSpec. A minimum target translation percentage + can optionally be passed as an integer parameter: "`needstranslation(50)`" + matches only pages less than 50% translated. + +O každé stránce, která nepoužívá „po“ překlad, se předpokládá, že je napsaná +v jazyce zadaném proměnnou `po_master_language` v konfiguračním souboru +ikiwiki. + +[[!meta robots="noindex, follow"]] diff --git a/ikiwiki/searching.mdwn b/ikiwiki/searching.mdwn new file mode 100644 index 0000000..d6fde69 --- /dev/null +++ b/ikiwiki/searching.mdwn @@ -0,0 +1,19 @@ +[[!meta robots="noindex, follow"]] + +[[!if test="enabled(search)" + then="Tato wiki má hledání **povolené**." + else="Tato wiki má hledání **vypnuté**."]] + +Pokud je hledání povoleno, můžete ve wiki vyhledávat prostřednictvím +vyhledávacího pole. Pro získání přesnějších výsledků existuje několik tipů: + +* Pro vyhledání celé fráze ji uzavřete do uvozovek. +* Pro vyhledání dokumentů obsahujících dva výrazy je možno použít „AND“. +* Pro vyhledání dokumentů obsahujících libovolný ze dvou výrazů je možno + použít „OR“. +* Komplikovanější dotazy lze sestavit pomocí uzávorkování. Například „(něco + AND cosi) or (já AND ty)“. +* Pokud nechcete, aby se zadaný výraz objevoval ve výsledcích hledání, + napište před něj „-“. Například „-diskuze“ vynechá "diskuze". +* Pro vyhledání stránky se zadaným názvem použijte „title:něco“. +* Pro vyhledání stránek obsahujících odkaz „cosi“ použijte „link:cosi“. diff --git a/ikiwiki/subpage.mdwn b/ikiwiki/subpage.mdwn new file mode 100644 index 0000000..48b108b --- /dev/null +++ b/ikiwiki/subpage.mdwn @@ -0,0 +1,14 @@ +[[!meta robots="noindex, follow"]] +ikiwiki podporuje ukládání stránek do adresářové hierarchie. Například tato +stránka, [[SubPage]], má pod sebou umístěno několik příbuzných stránek, jako +je [[SubPage/LinkingRules]]. Adresářová hierarchie je vhodným nástrojem pro +zavedení pořádku ve wiki - určitě to je lepší, než mít jeden adresář plný +stránek. + +To add a SubPage, just make a subdirectory and put pages in it. For example, +this page is subpage.mdwn in this wiki's source, and there is also a subpage +subdirectory, which contains subpage/linkingrules.mdwn. Subpages can be +nested as deeply as you'd like. + +Vytváření odkazů na podstránky je vysvětleno v [[pravidlech vytváření +odkazů|LinkingRules]]. diff --git a/ikiwiki/subpage/linkingrules.mdwn b/ikiwiki/subpage/linkingrules.mdwn new file mode 100644 index 0000000..e9ebd53 --- /dev/null +++ b/ikiwiki/subpage/linkingrules.mdwn @@ -0,0 +1,35 @@ +[[!meta robots="noindex, follow"]] +Pro vytvoření odkazu z/na [[podstránku|SubPage]] můžete použít běžný [[wiki +odkaz|WikiLink]], který neobsahuje název rodičovského adresáře +[[podstránky|SubPage]]. Ikiwiki postupuje hierarchií adresářů a hledá +stránku, která odpovídá zadanému odkazu. + +Například pokud stránka Cokoliv/Podstránka odkazuje na „JináStránka“, bude +ikiwiki preferovat odkaz na Cokoliv/Podstránka/JináStránka (pokud existuje), +potom Cokoliv/JináStránka a na závěr odkaz na JináStránka v kořenu wiki. + +To mimo jiné znamená, že pokud odkaz „JináStránka“ na stránce +Cokoliv/NějakáStránka momentálně odkazuje na stránku JináStránka v kořenu +wiki a někdo vytvoří stránku Cokoliv/JináStránka, odkaz se _změní_ a začne +ukazovat na Cokoliv/JináStránka. Na druhou stranu odkaz z DalšíStránka na +JináStránka by vytvořením [[podstránky|SubPage]] v adresáři Cokoliv zůstal +nezměněn. + +Pro přesnější určení, kam má odkaz ukazovat, je možné zadat odkaz včetně +jména adresáře, např. „Cokoliv/JináStránka“. Toto je jediný způsob, jak se +odkazovat na nesouvisející [[podstránku|SubPage]]. + +Můžete tak odkazovat například ze stránky DalšíStránka na +„Cokoliv/Podstránka“, nebo z DalšíStránka/Podstránka na +„Cokoliv/Podstránka“. + +Pokud ve wiki existuje několik stránek se stejnými názvy a odkaz se vytváří +na nesprávnou stránku, můžete na začátku odkazu použít „/“ a zapsat +absolutní cestu ke stránce. Například odkaz z „Cosi/Podstránka“ na +„/JináStránka“ se bude odkazovat na stránku v kořenu wiki i v případě, že +existuje „Cosi/JináStránka“. + +Pokud je wiki nastavena s volbou „userdir“, můžete se odkazovat na stránky +uvnitř uživatelského adresáře bez nutnosti zadávání cesty. To umožňuje +jednoduché odkazování na uživatelovu stránku, podepsání komentáře. Tyto +odkazy jsou kontrolovány jako poslední. diff --git a/ikiwiki/wikilink.mdwn b/ikiwiki/wikilink.mdwn new file mode 100644 index 0000000..b63e1e8 --- /dev/null +++ b/ikiwiki/wikilink.mdwn @@ -0,0 +1,31 @@ +[[!meta robots="noindex, follow"]] +Wiki odkazy poskytují jednoduchý způsob vytváření odkazů mezi stránkami ve +wiki. Pro vytvoření [[wiki odkazu|WikiLink]] jednoduše umístěte jméno +stránky, na kterou se chcete odkázat, do dvojitých hranatých +závorek. Například `\[[WikiLink]]`. + +Pokud byste někdy potřebovali napsat něco jako `\[[WikiLink]]` bez vytvoření +wiki odkazu, jednoduše před první závorku napište `\` jako zde: +`\\[[WikiLink]]`. + +Při odkazování mezi [[podstránkami|SubPage]] platí speciální [[pravidla +vytváření odkazů|SubPage/LinkingRules]]. + +Wiki odkazy ignorují rozdíly mezi malými a velkými písmeny, takže se +nemusíte starat o to, jaký zápis jste použili při vytváření stránky. Můžete +tak v odkazech na začátcích vět použít velká písmena a podobně. + +Také je možné vytvořit wiki odkaz, který používá jiný text odkazu, než je +název odkazované stránky (čehož zhusta využíváme v českém +překladu). Například `\[[pískoviště|SandBox]]` odkazuje na stránku SandBox, +ale odkaz bude vypadat takto: [[pískoviště|SandBox]]. + +Pro odkaz na kotvu uvnitř stránky použijte něco jako `\[[WikiLink#kotva]]`. + +If the file linked to by a WikiLink looks like an image, it will be +displayed inline on the page. + +--- + +You can also put an url in a WikiLink, to link to an external page. Email +addresses can also be used to generate a mailto link. -- cgit v1.2.3