Šablona:Dokumentace/doc - Historie editací

Filmedy: /* Příklad použití */

2025-09-25T15:14:38Z

Příklad použití

← Starší verze		Verze z 25. 9. 2025, 17:14
Řádek 6:		Řádek 6:
	== Styl ==		== Styl ==
	Styly jsou načítány ze stránky: '''[[Dokumentace/styles.css]]'''		Styly jsou načítány ze stránky: '''[[Dokumentace/styles.css]]'''

	~~== Příklad použití ==~~
	~~<pre>~~
	~~{{Dokumentace}}~~
	~~</pre>~~

	== Kategorie ==		== Kategorie ==
	Tato šablona je určena pro všechny šablony na Infopedii, které mají dokumentaci v podstránce.		Tato šablona je určena pro všechny šablony na Infopedii, které mají dokumentaci v podstránce.

Filmedy v 3. 5. 2025, 15:54

2025-05-03T15:54:37Z

← Starší verze		Verze z 3. 5. 2025, 17:54
Řádek 1:		Řádek 1:
	Tato šablona zajišťuje automatické ~~vkládání~~ dokumentace ~~pod šablony~~.		Tato šablona zajišťuje automatické zobrazení dokumentace šablon z podstránky `/doc`.

	== ~~Použití~~ ==		== Parametry ==
	~~Do konce šablony vložte:~~		* '''1''' – (volitelný) název stránky, ze které se má dokumentace načíst. Výchozí hodnota je ''{{PAGENAME}}/doc''.
	~~<pre>~~
	{{~~Dokumentace~~}}		== Styl ==
	</~~pre>~~		Styly jsou načítány ze stránky: '''[[Dokumentace/styles.css]]'''

	~~Dokumentace se načítá ze substránky s příponou <code>/doc</code>. Pokud chcete dokumentaci načítat z jiné stránky, můžete zadat její název jako parametr:~~		== Příklad použití ==
	<pre>		<pre>
	{{Dokumentace~~\|Název_jiné_stránky~~}}		{{Dokumentace}}
	</pre>		</pre>

	== Kategorie ==		== Kategorie ==
	~~[[Kategorie:Dokumentační~~ šablony~~\| ]]~~		Tato šablona je určena pro všechny šablony na Infopedii, které mají dokumentaci v podstránce.

Filmedy: obsah stránky nahrazen textem „Tato šablona zajišťuje automatické vkládání dokumentace pod šablony. == Použití == Do konce šablony vložte:

 {{Dokumentace}}

Dokumentace se načítá ze substránky s příponou /doc. Pokud chcete dokumentaci načítat z jiné stránky, můžete zadat její název jako parametr:

 {{Dokumentace|Název_jiné_stránky}}

== Kategorie == “

2025-05-03T15:14:12Z

obsah stránky nahrazen textem „Tato šablona zajišťuje automatické vkládání dokumentace pod šablony. == Použití == Do konce šablony vložte: <pre> {{Dokumentace}} </pre> Dokumentace se načítá ze substránky s příponou <code>/doc</code>. Pokud chcete dokumentaci načítat z jiné stránky, můžete zadat její název jako parametr: <pre> {{Dokumentace|Název_jiné_stránky}} </pre> == Kategorie == “

@@ Řádek 1: / Řádek 1: @@
-{{Podstránka s dokumentací}}<includeonly>{{Tisíckrát}}{{Složitá šablona}}{{Polozamčeno}}</includeonly><!--  KATEGORIE PROSÍM PŘIDÁVEJTE AŽ NA KONEC STRÁNKY  -->
+Tato šablona zajišťuje automatické vkládání dokumentace pod šablony.
 == Použití ==
-=== Běžné ===
+Do konce šablony vložte:
 <pre>
-&lt;noinclude&gt;{{Dokumentace}}&lt;/noinclude&gt;
+{{Dokumentace}}
 </pre>
-nebo
 <pre>
-&lt;noinclude&gt;{{Dokumentace|šablona:nějaká stránka/doc}}&lt;/noinclude&gt;
+{{Dokumentace|Název_jiné_stránky}}
 </pre>
-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 „<code>&lt;noinclude&gt;</code>“, nebyla žádná mezera. Optimálně celou vaši šablonu zakončete (včetně komentáře pro jiné) touto neměnnou posloupností:
+== Kategorie ==
+[[Kategorie:Dokumentační šablony| ]]

Filmedy: N

2025-05-01T01:27:12Z

Nová stránka

{{Podstránka s dokumentací}}<includeonly>{{Tisíckrát}}{{Složitá šablona}}{{Polozamčeno}}</includeonly>
'''Šablona:Dokumentace''' je šablona pro dokumentaci jiných šablon.

Tato šablona automaticky zobrazuje pod znázorněním šablony obdélník s dokumentací (např. takovou, jakou vidíte), jejíž obsah je přenesen z jiné stránky. Je určena pro stránky, které jsou přenášeny do ostatních stránek (tj. šablon), ať již se ve jmenném prostoru šablon nachází, nebo nikoliv.

Tato šablona je přenesena a upravena z [[:en:Template:Documentation|anglické wikipedie]].

Smyslem použití zvláštní dokumentační stránky (pomocí této šablony) je oddělit vlastní kód šablony od dokumentace šablony. Zlepšování dokumentace šablony editací se tak může dít bez ohrožování zápisu kódu vlastní šablony (ten lze případně později i uzamknout), popř. je zápis šablony aspoň jasně oddělen od dokumentace.

== Použití ==
=== Běžné ===
<pre>
<noinclude>{{Dokumentace}}</noinclude>
</pre>
nebo
<pre>
<noinclude>{{Dokumentace|šablona:nějaká stránka/doc}}</noinclude>
</pre>

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 „<code><noinclude></code>“, 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><nowiki>
{{Dokumentace}}
</noinclude></nowiki>

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.

Ani kategorie, patřící k dokumentované šabloně, se nezapisují do stránky šablony, ale až 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><code>''[kus kódu]''</code></code>, tím ho typograficky odlišíte. Pokud dokumentační stránka šablony obsahuje XML značky jako např. <code><includeonly></code> nebo <code><noinclude></code> jako součást dokumentace, nahraďte znak „<" znakovou entitou "<code>&lt;</code>“.

=== Dokumentace odjinud ===
* {{para|1|}} nepojmenovaný parametr pro výslovné určení jiné dokumentační stránky než implicitní podstránky <code>/doc</code>.
Do kódu jiné podstránky například <code><nowiki>{{Dokumentace|{{NAMESPACE}}:{{BASEPAGENAME}}/doc}}</nowiki></code>.

=== Úprava zobrazení ===
Varianta override existuje pro úpravu výstupu ve zvláštních případech:
* <nowiki>{{</nowiki>Dokumentace|'''nadpis'''=}}: 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 ==
Pokud dokumentační podstránka či stránka šablony '''neexistuje''', zobrazí se pouze hláška s odkazem na vytvoření dokumentace, který zahrnuje parametry [[mw:Manual:Creating pages with preloaded text|preload]]. Jeho prokliknutí pak při založení podstránky s dokumentací předvyplní editační formulář základním formátem dokumentační podstránky.

V případě, že k šabloně existují také podstránky '''/pískoviště''' a '''/test''', šablona v úvodu zobrazí také informaci o jejich existenci a doporučení využít je při úpravách.

== Účel ==
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, typicky kategorie. Rovněž snižuje nároky na zdroje serveru Wikipedie.

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

=== Nápověda k dodělání ===
Tento seznam bude upraven po vytvoření českých ekvivalentů:
* {{[[:en:Template:tiw]]}}, template doc (similar template with more documentation; see [[:en:User:Pathoschild/Sandbox|template comparison]])
* {{[[:en:Template:tiw]]}}, documentation subpage (replaces older {{[[:en:template:Template doc page viewed directly|Template doc page viewed directly]]}} and {{[[:en:template:Template doc page transcluded|Template doc page transcluded]]}})
* {{[[:en:Template:tim]]}}, Documentation

<includeonly>
[[Kategorie:Infopedia:Dokumentace šablon| ]]
[[Kategorie:Infopedia:Dokumentace modulů| ]]
[[Kategorie:Šablony:Dokumentační| ]]
</includeonly>