====== 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 [[page|stránek]] v [[dokuwiki|DokuWiki]] se automaticky převádějí na malá písmena! Povolené znaky jsou písmena, číslice a - uvnitř názvů ((tzn. nelze jimi začínat ani končit, jinak budou odstraněny)) - „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 ((nebo na jiný znak podle nastavení [[doku>config:sepchar|sepchar]])) . Dvojtečky (':') se používají k označení [[namespaces|jmenných prostorů]] ((Toto lze změnit na lomítka pro přirozenější zrcadlení struktury souborového systému: [[doku>config:useslash]])).

Pokud je aktivována volba [[doku>config:deaccent|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í [[backlinks|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 [[namespaces|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í [[doku>interwiki]] odkazů platí omezení názvů těchto wiki.

I když je povoleno [[wp>CamelCase]] (tzv. WikiWord) pomocí nastavení [[doku>config:camelcase|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:

<file>

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

</file>

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:

<file>

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

</file>

To nevede ke konfliktům, protože DokuWiki považuje poslední část (za poslední dvojtečkou) za název samotné [[page|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 [[namespaces|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:

<code php>
$id = utf8_strtolower($id);
</code>

:!: 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é [[https://forum.dokuwiki.org/d/5417|toto vlákno]].