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.mdwn | 17 +++++++ 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 ++++++++++++ index.mdwn | 7 +++ recentchanges.mdwn | 7 +++ sandbox.mdwn | 33 ++++++++++++ shortcuts.mdwn | 84 ++++++++++++++++++++++++++++++ templates.mdwn | 80 +++++++++++++++++++++++++++++ 17 files changed, 657 insertions(+) create mode 100644 ikiwiki.mdwn 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 create mode 100644 index.mdwn create mode 100644 recentchanges.mdwn create mode 100644 sandbox.mdwn create mode 100644 shortcuts.mdwn create mode 100644 templates.mdwn diff --git a/ikiwiki.mdwn b/ikiwiki.mdwn new file mode 100644 index 0000000..ab41bfa --- /dev/null +++ b/ikiwiki.mdwn @@ -0,0 +1,17 @@ +[[!meta robots="noindex, follow"]] +Tato wiki běží na [ikiwiki](http://ikiwiki.info/). +[[!if test="enabled(version)" + then="(Momentálně na verzi [[!version ]].)" +]] + +Základní dokumentace o používání ikiwiki: + +* [[formátování|ikiwiki/formatting]] +* [[wiki_odkazy|ikiwiki/wikilink]] +* [[podstránky|ikiwiki/subpage]] +* [[výběr_stránek|ikiwiki/pagespec]] +* [[direktivy|ikiwiki/directive]] +* [[ikiwiki/markdown]] +* [[ikiwiki/openid]] +* [[vyhledávání|ikiwiki/searching]] +* [[templates]] 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. diff --git a/index.mdwn b/index.mdwn new file mode 100644 index 0000000..484ca89 --- /dev/null +++ b/index.mdwn @@ -0,0 +1,7 @@ +Vítejte ve své nové wiki. + +Všechny wiki by měly mít [[pískoviště|SandBox]] a tato není výjimkou. + +---- + +Tato wiki běží na [[ikiwiki]]. diff --git a/recentchanges.mdwn b/recentchanges.mdwn new file mode 100644 index 0000000..91e64c1 --- /dev/null +++ b/recentchanges.mdwn @@ -0,0 +1,7 @@ +[[!if test="enabled(meta)" then=""" +[[!meta title="Nedávné změny"]] +"""]] +Nedávné změny v této wiki: + +[[!inline pages="internal(recentchanges/change_*) and !*/Discussion" +template=recentchanges show=0]] diff --git a/sandbox.mdwn b/sandbox.mdwn new file mode 100644 index 0000000..73a4784 --- /dev/null +++ b/sandbox.mdwn @@ -0,0 +1,33 @@ +Toto je pískoviště, stránka, kterou může upravovat kdokoliv, aby se naučil +používat wiki. + +---- + +Tady máme odstavec. + +A tady máme další se *zvýrazněným* textem. + +# Nadpis + +## Podnadpis + +> Toto je citace. +> +> Toto je první úroveň citace. +> +> > Toto je vnořená citace. +> +> Zpět na první úroveň. + +Číslovaný seznam + +1. První položka. +1. Další. +1. A další... + +Odrážkový seznam + +* *položka* +* položka + +[[wiki_odkaz|ikiwiki/WikiLink]] diff --git a/shortcuts.mdwn b/shortcuts.mdwn new file mode 100644 index 0000000..9687aca --- /dev/null +++ b/shortcuts.mdwn @@ -0,0 +1,84 @@ +[[!if test="enabled(shortcut)" + then="Tato wiki má zkratky **povolené**." + else="Tato wiki má zkratky **vypnuté**."]] + +Příklady použití některých zkratek: + + \[[!google foo]] + \[[!wikipedia War_of_1812]] + \[[!debbug 12345]] + Zkontrolujte \[[!cia ikiwiki desc="CIA stránku %s"]]. + +Tato stránka určuje, které zkratky bude wiki podporovat. + +* [[!shortcut name=google url="https://encrypted.google.com/search?q=%s"]] +* [[!shortcut name=archive url="http://web.archive.org/*/%S"]] +* [[!shortcut name=gmap url="http://maps.google.com/maps?q=%s"]] +* [[!shortcut name=gmsg url="http://groups.google.com/groups?selm=%s"]] +* [[!shortcut name=wikipedia + url="https://secure.wikimedia.org/wikipedia/en/wiki/%s"]] +* [[!shortcut name=wikitravel url="https://wikitravel.org/en/%s"]] +* [[!shortcut name=wiktionary + url="https://secure.wikimedia.org/wiktionary/en/wiki/%s"]] +* [[!shortcut name=debbug url="http://bugs.debian.org/%S" desc="Debian bug + #%s"]] +* [[!shortcut name=deblist url="http://lists.debian.org/debian-%s" + desc="debian-%s@lists.debian.org"]] +* [[!shortcut name=debpkg url="http://packages.debian.org/%s"]] +* [[!shortcut name=debpkgsid url="http://packages.debian.org/sid/%s"]] +* [[!shortcut name=debpts url="http://packages.qa.debian.org/%s"]] +* [[!shortcut name=debmsg url="http://lists.debian.org/msgid-search/%s"]] +* [[!shortcut name=debrt + url="https://rt.debian.org/Ticket/Display.html?id=%s"]] +* [[!shortcut name=debss url="http://snapshot.debian.net/package/%s"]] + * Usage: `\[[!debss package]]`, `\[[!debss package#version]]`, or `\[[!debss package/version]]`. See http://snapshot.debian.net for details. +* [[!shortcut name=debwiki url="http://wiki.debian.org/%s"]] +* [[!shortcut name=fdobug url="https://bugs.freedesktop.org/show_bug.cgi?id=%s" desc="freedesktop.org bug #%s"]] +* [[!shortcut name=fdolist url="http://lists.freedesktop.org/mailman/listinfo/%s" desc="%s@lists.freedesktop.org"]] +* [[!shortcut name=gnomebug url="http://bugzilla.gnome.org/show_bug.cgi?id=%s" desc="GNOME bug #%s"]] +* [[!shortcut name=linuxbug url="http://bugzilla.kernel.org/show_bug.cgi?id=%s" desc="Linux bug #%s"]] +* [[!shortcut name=mozbug url="https://bugzilla.mozilla.org/show_bug.cgi?id=%s" desc="Mozilla bug #%s"]] +* [[!shortcut name=gnulist url="http://lists.gnu.org/mailman/listinfo/%s" desc="%s@gnu.org"]] +* [[!shortcut name=marcmsg url="http://marc.info/?i=%s"]] +* [[!shortcut name=marclist url="http://marc.info/?l=%s"]] +* [[!shortcut name=gmane url="http://dir.gmane.org/gmane.%s" desc="gmane.%s"]] +* [[!shortcut name=gmanemsg url="http://mid.gmane.org/%s"]] +* [[!shortcut name=cpan url="http://search.cpan.org/search?mode=dist&query=%s"]] +* [[!shortcut name=ctan url="http://tug.ctan.org/cgi-bin/ctanPackageInformation.py?id=%s"]] +* [[!shortcut name=hoogle url="http://haskell.org/hoogle/?q=%s"]] +* [[!shortcut name=iki url="http://ikiwiki.info/%S/"]] +* [[!shortcut name=ljuser url="http://%s.livejournal.com/"]] +* [[!shortcut name=rfc url="http://www.ietf.org/rfc/rfc%s.txt" desc="RFC %s"]] +* [[!shortcut name=c2 url="http://c2.com/cgi/wiki?%s"]] +* [[!shortcut name=meatballwiki url="http://www.usemod.com/cgi-bin/mb.pl?%s"]] +* [[!shortcut name=emacswiki url="http://www.emacswiki.org/cgi-bin/wiki/%s"]] +* [[!shortcut name=haskellwiki url="http://haskell.org/haskellwiki/%s"]] +* [[!shortcut name=dict url="http://www.dict.org/bin/Dict?Form=Dict1&Strategy=*&Database=*&Query=%s"]] +* [[!shortcut name=imdb url="http://imdb.com/find?q=%s"]] +* [[!shortcut name=gpg url="http://pgpkeys.mit.edu:11371/pks/lookup?op=vindex&exact=on&search=0x%s"]] +* [[!shortcut name=perldoc url="http://perldoc.perl.org/search.html?q=%s"]] +* [[!shortcut name=whois url="http://reports.internic.net/cgi/whois?whois_nic=%s&type=domain"]] +* [[!shortcut name=cve url="http://cve.mitre.org/cgi-bin/cvename.cgi?name=%s"]] +* [[!shortcut name=cia url="http://cia.vc/stats/project/%s"]] +* [[!shortcut name=ciauser url="http://cia.vc/stats/user/%s"]] +* [[!shortcut name=flickr url="http://www.flickr.com/photos/%s"]] +* [[!shortcut name=man url="http://linux.die.net/man/%s"]] +* [[!shortcut name=ohloh url="http://www.ohloh.net/projects/%s"]] +* [[!shortcut name=cpanrt url="https://rt.cpan.org/Ticket/Display.html?id=%s" desc="CPAN RT#%s"]] +* [[!shortcut name=novellbug url="https://bugzilla.novell.com/show_bug.cgi?id=%s" desc="bug %s"]] + +Pro přidání nové zkratky použijte [[direktivu|ikiwiki/directive]] +`shortcut`. Řetězec „%s“ je v adrese nahrazen textem předaným dané +zkratce. Tento text je automaticky zakódován ([[!wikipedia url_encoding]]) +do podoby vhodné pro url. Nechcete-li text kódovat, použijte „%S“. Volitelný +parametr `desc` dovoluje změnit popis odkazu. + +Mějte na paměti, že jméno, které dáte zkratce pomocí parametru `name`, se +stane novou [[direktivou|ikiwiki/directive]]. Vyhněte se tedy jménům, která +kolidují s existujícími direktivami. Tyto direktivy podporují parametr +`desc`, který má přednost před popisem zadaným při definici zkratky. + +Pokud jste přišli na nějakou zkratku, o které si myslíte, že by byla +užitečná i pro ostatní, zkuste ji přidat do [seznamu zkratek ve wiki +ikiwiki](http://ikiwiki.info/shortcuts/), aby ji budoucí verze ikiwiki +obsahovaly rovnou ve standardní výbavě. diff --git a/templates.mdwn b/templates.mdwn new file mode 100644 index 0000000..ae4012b --- /dev/null +++ b/templates.mdwn @@ -0,0 +1,80 @@ +[[Ikiwiki]] uses many templates for many purposes. By editing its templates, +you can fully customise this site. + +Templates are located in `/usr/share/ikiwiki/templates` by default; the +`templatedir` setting can be used to make another directory be searched +first. Customised templates can also be placed inside the "templates/" +directory in your wiki's source. + +Ikiwiki uses the HTML::Template module as its template engine. This supports +things like conditionals and loops in templates and is pretty easy to +learn. All you really need to know to modify templates is this: + +* To insert the value of a template variable, use ``. +* To make a block of text conditional on a variable being set use `text`. +* To use one block of text if a variable is set and a second if it's not, + use `textother text` + +[[!if test="enabled(template)" then=""" +## template pages + +The [[!iki ikiwiki/directive/template desc="template directive"]] allows +wiki pages to be used as templates, filled out and inserted into other pages +in the wiki. +"""]] + +[[!if test="enabled(edittemplate)" then=""" +## default content for new pages + +The [[!iki ikiwiki/directive/edittemplate desc="edittemplate directive"]] +can be used to make new pages default to containing text from a template +page, which can be filled out as the page is edited. +"""]] + +[[!if test="(enabled(template) or enabled(edittemplate)) +and enabled(inline)" then=""" +[[!inline pages="templates/* and !*.tmpl and !templates/*/* and !*/discussion" +feeds=no archive=yes sort=title template=titlepage +rootpage=templates postformtext="Add a new template named:"]] +"""]] + +## wiki templates + +These templates are used to build the wiki. The aim is to keep almost all +html out of ikiwiki and in the templates. + +* `page.tmpl` - Used for displaying all regular wiki pages. This is the key + template to customise. [[!if test="enabled(pagetemplate)" then=""" + (The [[!iki ikiwiki/directive/pagetemplate desc="pagetemplate directive"]] + can be used to make a page use a different template than `page.tmpl`.)"""]] +* `rsspage.tmpl` - Used for generating rss feeds for blogs. +* `rssitem.tmpl` - Used for generating individual items on rss feeds. +* `atompage.tmpl` - Used for generating atom feeds for blogs. +* `atomitem.tmpl` - Used for generating individual items on atom feeds. +* `inlinepage.tmpl` - Used for displaying a post in a blog. +* `archivepage.tmpl` - Used for listing a page in a blog archive page. +* `titlepage.tmpl` - Used for listing a page by title in a blog archive page. +* `microblog.tmpl` - Used for showing a microblogging post inline. +* `blogpost.tmpl` - Used for a form to add a post to a blog (and rss/atom links) +* `feedlink.tmpl` - Used to add rss/atom links if `blogpost.tmpl` is not used. +* `aggregatepost.tmpl` - Used by the aggregate plugin to create + a page for a post. +* `searchform.tmpl`, `googleform.tmpl` - Used by the search plugin + and google plugin to add search forms to wiki pages. +* `searchquery.tmpl` - This is a Omega template, used by the + search plugin. +* `comment.tmpl` - Used by the comments plugin to display a comment. +* `change.tmpl` - Used to create a page describing a change made to the wiki. +* `recentchanges.tmpl` - Used for listing a change on the RecentChanges page. +* `autoindex.tmpl` - Filled in by the autoindex plugin to make index pages. +* `autotag.tmpl` - Filled in by the tag plugin to make tag pages. +* `calendarmonth.tmpl`, `calendaryear.tmpl` - Used by ikiwiki-calendar to + make calendar archive pages. +* `editpage.tmpl`, `editconflict.tmpl`, `editcreationconflict.tmpl`, + `editfailedsave.tmpl`, `editpagegone.tmpl`, `pocreatepage.tmpl`, + `editcomment.tmpl` `commentmoderation.tmpl`, `renamesummary.tmpl`, + `passwordmail.tmpl`, `openid-selector.tmpl` - Parts of ikiwiki's user + interface; do not normally need to be customised. + +[[!meta robots="noindex, follow"]] -- cgit v1.2.3