Názvy stránek

https://www.dokuwiki.org/pagename

Název stránky je část URL, která určuje konkrétní stránku. Například URL stránky, kterou právě čtete, je https://www.dokuwiki.org/pagename a jejím názvem je pagename.

Konvence pojmenování

Názvy stránek v DokuWiki se automaticky převádějí na malá písmena! Povolené znaky jsou písmena, číslice a - uvnitř názvů ¹⁾ - „speciální znaky“ tečka ., pomlčka - a podtržítko _. Všechny ostatní speciální znaky (tj. jiné než písmena a číslice - mezera, plus, lomítko, procento atd.) se převádějí na podtržítka ²⁾ . Dvojtečky (':') se používají k označení jmenných prostorů ³⁾.

Pokud je aktivována volba odstranění diakritiky (ve výchozím stavu zapnuto), místní a diakritická písmena se převádějí na jejich popisné ekvivalenty (např. ü na ue) nebo bez diakritiky (např. á na a).

Nepřímo je délka názvu stránky omezena funkcí zpětných odkazů - názvy musí mít alespoň 3 znaky, aby byly zahrnuty.

Většina šablon, včetně výchozí, někde zobrazuje celý název stránky a jmenné prostory v její cestě. Šablona 'dokuwiki' ho umisťuje do záložky v pravém horním rohu stránky. Například název této stránky je pagename.

Při odkazování na jiné wiki pomocí interwiki odkazů platí omezení názvů těchto wiki.

I když je povoleno CamelCase (tzv. WikiWord) pomocí nastavení CamelCase, názvy stránek zůstávají malými písmeny.

Poznámka: Všechna omezení uvedená zde pro názvy stránek platí i pro mediální soubory!

Názvy stránek a jmenné prostory

Jmenné prostory si můžete představit jako adresáře (složky) a názvy stránek jako soubory uvnitř nich.

Název stránky a:b:c si lze představit takto:

   kořenový jmenný prostor (vždy přítomen)
     │
     └── jmenný prostor 'a'
          │
          └── jmenný prostor 'b'
               │
               └── stránka 'c'

Všimněte si, že můžete mít stránku a jmenný prostor se stejným názvem současně, v rámci libovolného jmenného prostoru. Vraťme se k příkladu a:b, který si lze představit takto:

   kořenový jmenný prostor (vždy přítomen)
     │
     └── jmenný prostor 'a'
          │
          └── stránka 'b' (nezaměňovat s jmenným prostorem 'b' výše)

To nevede ke konfliktům, protože DokuWiki považuje poslední část (za poslední dvojtečkou) za název samotné stránky, zatímco všechny předchozí části jsou jmenné prostory.

V a:b:c jsou a a b jmenné prostory, zatímco c je stránka.
V a:b je a jmenný prostor a b stránka.

Více informací najdete na stránce jmenné prostory.

Úprava jádra pro názvy s velkými písmeny

Někteří uživatelé upravují jádro DokuWiki, aby mohli používat názvy s velkými písmeny. Toto se nedoporučuje, není oficiálně podporováno a může narušit funkčnost DokuWiki nepředvídatelným způsobem.

Můžete upravit kód a zakomentováním jednoho řádku v souboru wiki/inc/pageutils.php (kolem řádku 109) umožnit používání názvů jako Names_Like_This, pokud si to přejete. Najděte tento kód a zakomentujte ho:

$id = utf8_strtolower($id);

Tento hack jsem používal několik let a oznámil ho na fóru uživatelů. Zdá se, že nefunguje s verzí Anteater.
Má někdo nápad, jak to zprovoznit i tam?

Na tuto stránku jsem narazil, protože jsem potřeboval tento hack, spolu s možností povolit mezery v názvech souborů. Přidal jsem konfigurovatelný hack. Výchozí chování DokuWiki je zachováno a hack se použije pouze tehdy, pokud jsou nastaveny příslušné volby v $conf. Viz changelog na: https://github.com/ahmetsacan/dokuwiki/commit/0bd10be989c0ea582549ea26ec76f642bf12a6db Omlouvám se, nemám čas prosazovat tuto změnu formou pull-requestu. Používejte na vlastní riziko.

Viz také toto vlákno.

¹⁾

tzn. nelze jimi začínat ani končit, jinak budou odstraněny

²⁾

nebo na jiný znak podle nastavení sepchar

³⁾

Toto lze změnit na lomítka pro přirozenější zrcadlení struktury souborového systému: config:useslash