summaryrefslogtreecommitdiff
path: root/ikiwiki
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki')
-rw-r--r--ikiwiki/directive.mdwn43
-rw-r--r--ikiwiki/formatting.mdwn104
-rw-r--r--ikiwiki/markdown.mdwn11
-rw-r--r--ikiwiki/openid.mdwn28
-rw-r--r--ikiwiki/pagespec.mdwn86
-rw-r--r--ikiwiki/pagespec/attachment.mdwn36
-rw-r--r--ikiwiki/pagespec/po.mdwn22
-rw-r--r--ikiwiki/searching.mdwn19
-rw-r--r--ikiwiki/subpage.mdwn14
-rw-r--r--ikiwiki/subpage/linkingrules.mdwn35
-rw-r--r--ikiwiki/wikilink.mdwn31
11 files changed, 429 insertions, 0 deletions
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: <<http://ikiwiki.info>>, 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.