Šablona:Dokumentace/doc

From DCEwiki
Jump to: navigation, search

Toto je dokumentační podstránka šablony Šablona:Dokumentace.

Vedle návodu k použití obsahuje kategorie, odkazy interwiki a další obsah, který není součástí kódu šablony.
MediaWiki:Image:Information icon with gradient background.svg Tato šablona používá velmi složitou syntaxi nebo funkce parseru.

Nepokoušejte se kód měnit, nejste-li si naprosto jisti, co děláte; pokud editace způsobí nečekané následky, urychleně ji vraťte. Veškeré experimenty byste měli provádět na pískovišti nebo ve svém uživatelském prostoru a nikoli zde.

Šablona:Dokumentace je šablona určená k vkládání dokumentace k šablonám.

Tato šablona byla přenesena a upravena z české wikipedie, kde patří ke standardním dokumentačním šablonám.

Smyslem použití zvláštní dokumentační stránky (což umožňuje tato šablona) je oddělit vlastní kód šablony od dokumentace šablony. Popis a dokumentace šablony tak může být upravován bez toho, že by hrozilo zanesení chyby do kódu vlastní šablony (ten lze případně později i uzamknout).

Použití[edit]

Běžné[edit]

<noinclude>{{dokumentace}}</noinclude>

nebo

<noinclude>{{dokumentace|šablona:nějaká stránka/doc}}</noinclude>

Jednu z variant výše uvedeného kódu připojte na spodek kódu dokumentované šablony tak, aby mezi kódem šablony a připojeným kódem, začínajícím "<noinclude>", nebyla žádná mezera. Optimálně celou vaši šablonu zakončete (včetně komentáře pro jiné) touto neměnnou posloupností:

[--poslední řádek kódu vaší šablony--]<noinclude>
{{Dokumentace}}
<!-- KATEGORIE a INTERWIKI, PROSÍME, PŘIDÁVEJTE DO /doc PODSTRÁNKY. DĚKUJEME -->
</noinclude>

Pokud mezeru ponecháte, způsobí to výskyt této mezery na všech stránkách, ve kterých je vaše šablona použita.

Druhou variantu s parametrem můžete využít pro přesné určení jakékoliv dokumentační stránky namísto implicitní podstránky /doc.

Ani kategorie nebo odkazy interwiki, patřící k dokumentované šabloně, se nezapisují do stránky šablony, ale rovněž do dokumentační podstránky, mezi značky includeonly na jejím závěru.

Dokumentační příklady výpisů zdrojového kódu obalte <code>[kus kódu]</code>, tím ho typograficky odlišíte. Pokud dokumentační stránka šablony obsahuje XML značky jako např. <includeonly> nebo <noinclude> jako součást dokumentace, nahraďte znak "<" znakovou entitou "&lt;".

Úprava zobrazení[edit]

Varianta override existuje pro úpravu výstupu ve zvláštních případech:

  • {{dokumentace|heading=}}: změní text nadpisu "dokumentace". Pokud je položka ponechána prázdná, pak zmizí i celý nadpisový řádek, včetně prvního odkazu [edit].

Funkce[edit]

Pokud dokumentační podstránka či stránka šablony neexistuje, pak odkaz "editace" v první řádce dokumentace zahrne parametry preload, takže jeho prokliknutí předvyplní editační formulář základním formátem dokumentační stránky.

Účel[edit]

Tato šablona umožňuje k jakékoliv stránce (zejména šabloně) použít dokumentační stránku a umožňuje chránit takové stránky (šablony) při zachování možnosti editovat dokumentaci šablony, kategorie a odkazy interwiki. Rovněž snižuje nároky na zdroje serveru Wikipedie.


Viz rovněž[edit]

Zpětný odkaz z dokumentační podstránky na šablonu samotnou: {{Podstránka s dokumentací}}, vzájemně se doplňující šablony.

Nápověda k dodělání[edit]

Tento seznam bude upraven po vytvoření českých ekvivalentů: