⋮ Obsah

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ů 1) - „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 2) . Dvojtečky (':') se používají k označení jmenných prostorů 3).

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í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.

1)
tzn. nelze jimi začínat ani končit, jinak budou odstraněny
2)
nebo na jiný znak podle nastavení sepchar
3)
Toto lze změnit na lomítka pro přirozenější zrcadlení struktury souborového systému: config:useslash