Šablona:NK ČR/doc: Porovnání verzí

Verze z 28. 1. 2016, 16:00

Toto je dokumentační podstránka šablony Šablona:NK ČR

Obsahuje návod k použití, kategorie a další obsah, který není součástí samotné šablony.

Použití

Šablona se zadává obvykle s jediným parametrem: {{NK ČR|ID osoby}}
ID osoby – jednoznačný identifikátor, který lze získat na serveru Národní knihovny v databázi AUT (v položce Ident. číslo, zpravidla vypadá např. xx20050607123).
Volitelně lze zadat i jméno osoby, k níž se šablona vztahuje, pokud není stejná jako jméno článku {{NK ČR|ID osoby|jméno osoby}}
Šablona se používá v rámci projektu Národní knihovny České republiky.
Pokud jde o díla o věci (nikoli o díla autora), přiřaďte hodnotu parametr věc (např. věc = ano). Pokud je tato věc v množném čísle (např. „díla o zbraních hromadného ničení“), přidejte parametr množné (např. množné = ano).
Pokud má daná osoba autoritní záznam, ale seznam děl je prázdný, je vhodnější použít neviditelnou šablonu {{ID autority}}

Umístění šablony

Šablona se obvykle vkládá do sekce Odkazy (Externí odkazy, Související články), případně do jiné podobně vhodné sekce (např. Dílo – seznam děl spisovatele).

Šablona se přidává na začátek příslušné sekce.

Pokud je již podobných šablon v odkazech víc (např. {{Wikizdroje}}, {{Wikicitáty}}, {{Commons}}, {{Wikidruhy}}, {{Gutenberg autor}}) a jejich nahromadění zde by z důvodu přidávání na pravou stranu vypadalo neesteticky, je možné ji umístit i do jiné sekce.

Vkládání šablony v prostředí Visual Editor

Pokud chcete vložit tuto šablonu v prostředí Visual Editor, Postupujte následovně:

Klikněte na Vložit – Šablona, v okně Nová šablona do nabídnutého řádku napište „NK ČR“ a klikněte na Přidat šablonu.
Do políčka Identifikátor napište příslušný identifikátor autoritního záznamu NK ČR.
V případě potřeby můžete přidat i další (nepovinné) parametry.
Klikněte na Vložit šablonu.

Parametry šablony

Tato sekce obsahuje strukturovaný popis parametrů této šablony využívající rozšíření TemplateData, který umožňuje snadnější používání této šablony v prostředí VisualEditoru.

NK ČR

Slouží k vložení odkazu na seznam děl v databázi Národní knihovny České republiky, které buď napsal autor, o kterém pojednává článek, nebo které pojednávají o předmětu článku.

Parametry šablony
Tato šablona upřednostňuje parametry formátované v jediném řádku.
Parametr		Popis	Typ	Stav
Identifikátor	`1`	Identifikátor autoritního záznamu NK ČR. Tvoří jej vždy dvě až čtyři písmena následovaná čísly. Příklad jk01021023	Řetězec	povinný
Označení	`2`	Jméno autora či označení tématu použité v zobrazení. Pokud není vyplněno, přebírá se název článku.	Řetězec	nepovinný
Jedná se o věc?	`věc`	V článcích pojednávajících o věcech, tématech apod. nastavte na „ano“; v článcích pojednávajících o autorech nepoužívejte. Příklad ano	Logická hodnota	nepovinný
Množné číslo?	`množné`	Pokud je téma článku v množném čísle, nastavte na „ano“, jinak nepoužívejte. Příklad ano	Logická hodnota	nepovinný

Obdobné projekty jiných Wikipedií

de:Vorlage:DNB-Portal (německojazyčná)

@@ Řádek 1: / Řádek 1: @@
 {{Podstránka s dokumentací}}
 <!--
-     KATEGORIE a INTERWIKI prosím přidejte až na spodek této stránky
+     KATEGORIE prosím přidejte až na spodek této stránky
 -->
-==Použití==
+== Použití ==
-* Šablona se zadává obvykle s jediným parametrem: <code><nowiki>{{</nowiki>NK ČR|ID osoby<nowiki>}}</nowiki></code>
+* Šablona se zadává obvykle s jediným parametrem: <code><nowiki>{{NK ČR|ID osoby}}</nowiki></code>
-* ID osoby – jednoznačný identifikátor, který lze získat na serveru Národní knihovny v  [http://aleph.nkp.cz/F/?func=file&file_name=find-a&local_base=AUT databázi AUT] (v položce ''Ident. číslo'', zpravidla vypadá např. ''xx20050607123'').
+* ID osoby – jednoznačný identifikátor, který lze získat na serveru Národní knihovny v [http://aleph.nkp.cz/F/?func=file&file_name=find-a&local_base=AUT databázi AUT] (v položce ''Ident. číslo'', zpravidla vypadá např. ''xx20050607123'').
-* Volitelně lze zadat i jméno osoby, k níž se šablona vztahuje, pokud není stejná jako jméno článku <code><nowiki>{{</nowiki>NK ČR|ID osoby|jméno osoby<nowiki>}}</nowiki></code>
+* Volitelně lze zadat i jméno osoby, k níž se šablona vztahuje, pokud není stejná jako jméno článku <code><nowiki>{{NK ČR|ID osoby|jméno osoby}}</nowiki></code>
-* Šablona se používá v rámci [[w:Wikipedie:WikiProjekt NK ČR|projektu Národní knihovny České republiky]].
+* Šablona se používá v rámci [[Wikipedie:WikiProjekt NK ČR|projektu Národní knihovny České republiky]].
 * Pokud jde o díla o věci (nikoli o díla autora), přiřaďte hodnotu parametr <code>věc</code> (např. <code>věc = ano</code>). Pokud je tato věc v množném čísle (např. „díla o zbraních hromadného ničení“), přidejte parametr <code>množné</code> (např. <code>množné = ano</code>).
 * Pokud má daná osoba [http://autority.nkp.cz autoritní záznam], ale seznam děl je prázdný, je vhodnější použít neviditelnou šablonu {{Šablona|ID autority}}
@@ Řádek 14: / Řádek 14: @@
 Šablona se obvykle vkládá do sekce ''Odkazy'' (''Externí odkazy'', ''Související články''), případně do jiné podobně vhodné sekce (např. ''Dílo'' – seznam děl spisovatele).
-Šablona se vizuálně umístí na pravé straně stránky, proto se přidává na začátek příslušné sekce (z estetických důvodů, obsadí tak prázdné místo, které tam obvykle vznikne).
+Šablona se přidává na začátek příslušné sekce.
-Pokud je již podobných šablon v odkazech víc (např. {{Šablona|Sisterlinks}}, {{Šablona|Wikizdroje}}, {{Šablona|Wikicitáty}}, {{Šablona|Commons}}, {{Šablona|Wikidruhy}}, {{Šablona|Gutenberg autor}}) a jejich nahromadění zde by z důvodu přidávání na pravou stranu vypadalo neesteticky, je možné ji umístit i do jiné sekce.
+Pokud je již podobných šablon v odkazech víc (např. {{Šablona|Wikizdroje}}, {{Šablona|Wikicitáty}}, {{Šablona|Commons}}, {{Šablona|Wikidruhy}}, {{Šablona|Gutenberg autor}}) a jejich nahromadění zde by z důvodu přidávání na pravou stranu vypadalo neesteticky, je možné ji umístit i do jiné sekce.
+=== Vkládání šablony v prostředí Visual Editor ===
+Pokud chcete vložit tuto šablonu v prostředí Visual Editor, Postupujte následovně:
+* Klikněte na ''Vložit'' – ''Šablona'', v okně ''Nová šablona'' do nabídnutého řádku napište „NK ČR“ a klikněte na ''Přidat šablonu''.
+* Do políčka ''Identifikátor'' napište příslušný identifikátor autoritního záznamu NK ČR.
+* V případě potřeby můžete přidat i další (nepovinné) parametry.
+* Klikněte na ''Vložit šablonu''.
+== Parametry šablony ==
+{{TemplateDataHeader}}
+<templatedata>
+{
+	"description": "Slouží k vložení odkazu na seznam děl v databázi Národní knihovny České republiky, které buď napsal autor, o kterém pojednává článek, nebo které pojednávají o předmětu článku.",
+	"params": {
+		"1": {
+			"label": "Identifikátor",
+			"type": "string",
+			"required": true,
+			"description": "Identifikátor autoritního záznamu NK ČR. Tvoří jej vždy dvě až čtyři písmena následovaná čísly.",
+			"example": "jk01021023"
+		},
+		"2": {
+			"label": "Označení",
+			"type": "string",
+			"required": false,
+			"description": "Jméno autora či označení tématu použité v zobrazení. Pokud není vyplněno, přebírá se název článku."
+		},
+		"věc": {
+			"label": "Jedná se o věc?",
+			"type": "boolean",
+			"required": false,
+			"description": "V článcích pojednávajících o věcech, tématech apod. nastavte na „ano“; v článcích pojednávajících o autorech nepoužívejte.",
+			"example": "ano"
+		},
+		"množné": {
+			"label": "Množné číslo?",
+			"type": "boolean",
+			"required": false,
+			"description": "Pokud je téma článku v množném čísle, nastavte na „ano“, jinak nepoužívejte.",
+			"example": "ano"
+		}
+	},
+	"format": "inline"
+}
+</templatedata>
-<includeonly><!-- KATEGORIE a INTERWIKI zde, děkujeme -->
+== Obdobné projekty jiných Wikipedií ==
-[[Kategorie:Šablony interwiki|{{PAGENAME}}]]
+* [[:de:Vorlage:DNB-Portal]] (německojazyčná)
+<includeonly><!-- KATEGORIE zde, děkujeme -->
+[[Kategorie:Šablony:Externí odkazy|{{PAGENAME}}]]
 </includeonly>