View source for Seznam Cargo šablon

V Cargo šablonách a dalších Cargo věcech už se těžko sám vyznám, tudíž je potřeba si to sepsat...

== Jmenné prostory ==

Všechny ''Cargo položky'' (odkazy, výročí, osoby, knihy, vazby mezi nimi...) by měly být v namespace <code>Data:</code>.

* [https://www.franklinova-expedice.cz/w/Speci%C3%A1ln%C3%AD:V%C5%A1echny_str%C3%A1nky?from=&to=&namespace=3002 Výpis všech stránek v namespace Data]

Tyto "stránky" by se '''nikdy''' neměly používat napřímo (jen přes šablony) a odkazovat!!!

== Kategorie ==

Jednotlivé stránky z namespace <code>Data:</code> jsou kategorizovány do kategorií podle typu obsahu. Všechny tyto "Cargo kategorie" pak patří do "sběrné" <code>Kategorie:Data</code>.

* [[:Kategorie:Data]] – sběrná kategorie pro Cargo kategorie
** [[:Kategorie:Books]] – knihy
** [[:Kategorie:Events]] – události (výročí)
** [[:Kategorie:Links]] – odkazy
** [[:Kategorie:RelationsPersons]] – příbuzenské vztahy mezi osobami
** [[:Kategorie:Persons]] – osoby

== Šablony ==

V pojmenovávání šablon panuje nejednotnost, protože jsem si nějaká pravidla stanovil až dodatečně. Vzhledem k tomu, že ty "špatně" pojmenované šablony jsou na bambilionu stránek, tak se mi to nechce teď nahonem měnit, to je námět pro nějaké hypotetické spolupracovníky... :-)

=== Události - výročí ===
* [[:Šablona:Event]] – definiční tabulka, definuje strukturu dat pro Cargo tabulku [https://www.franklinova-expedice.cz/w/Speci%C3%A1ln%C3%AD:CargoTables/Events Events]
* [[:Šablona:DataCalendarFullTmpl]] – výpis celého kalendáře na stránce [[Kalendárium]]. Tato šablona pouze vybírá políčko <code>year</code> z tabulky <code>Events</code> a jako template volá [[:Šablona:DataCalendarYearTmpl]]
* [[:Šablona:DataCalendarYearTmpl]] – Tato šablona vybírá na základě předaného parametru (= <code>year</code>) z tabulky <code>Events</code> políčka popisující výročí pro daný rok a seřazené podle měsíce a dne je předává do template [[:Šablona:DataCalendarEventTmpl]]
* [[:Šablona:DataCalendarEventTmpl]] – Tato šablona přebírá pojmenované parametry popisující jednu událost/výročí a zobrazuje je.
* [[:Šablona:DataCalendarOTMTmpl]] – Tato šablona (použitá na [[Hlavní_strana]]) vybírá z tabulky <code>Events</code> políčka popisující výročí (která mají zaškrtnuto, že se mají zobrazovat jako výročí) odpovídající měsíci, který dostane jako parametr (<nowiki>{{CURRENTMONTH1}}</nowiki>) seřazené podle dne a roku je předává šabloně [[:Šablona:DataCalendarEventTmpl]]
* [[:Šablona:DataCalendarPageTmpl]] – Tato šablona slouží k použití na jednotlivých stránkách (např. [[HMS Erebus]]) a vybírá výročí, kde je v políčku <code>page</code> obsažen název stránky (<nowiki>{{FULLPAGENAME}}</nowiki>). K zobrazení je předává šabloně [[:Šablona:DataCalendarEventPageTmpl]]
* [[:Šablona:DataCalendarEventPageTmpl]] – Tato šablona přebírá pojmenované parametry popisující jednu událost/výročí a zobrazuje je. Od [[:Šablona:DataCalendarEventTmpl]] se liší tím, že jako název události přednostně používá políčko <code>tit_top</code>, které obsahuje název "smysluplnější" z hlediska použití na stránce věnované danému tématu (= např. neopakuje pořád název daného tématu).

=== Odkazy ===
* [[:Šablona:Link]] – definiční tabulka, definuje strukturu dat pro Cargo tabulku [https://www.franklinova-expedice.cz/w/Speci%C3%A1ln%C3%AD:CargoTables/Links Links]
* [[:Šablona:DataLinksPage]] – Šablona vybírá políčka popisující odkaz z [[Speciální:CargoTables/Links|tabulky Links]] pro ty odkazy, kde název stránky (<nowiki>{{FULLPAGENAME}}</nowiki>), na níž je šablona vložena, je obsažen v políčku <code>page</code>. Odkazy seřazené abecedně podle názvu předává k zobrazení šabloně [[:Šablona:DataLinkTmpl]]. Využití na řadě tematických stránek, např. [[HMS Erebus]].
* [[:Šablona:DataLinkTmpl]] – Šablona přebírá pojmenované parametry (= políčka) popisující jeden odkaz a zobrazuje je.
* [[:Šablona:DataLinksCategoryTmpl]] – Šablona vybírá z tabulky <code>Links</code> českojazyčná políčka pro odkazy, které odpovídají zadaným parametrům pro kategorii odkaz (např. ''blog'', ''odborný článek''...), jazyk a případně téma (stránku). Odkazy seřazené podle data publikace a názvu předává k zobrazení šabloně [[:Šablona:DataLinkTmpl]]. Využití na [[Informační zdroje]].
* [[:Šablona:DataLinksCategoryEnTmpl]] – Totéž jako [[:Šablona:DataLinksCategoryTmpl]], ale vybírá anglickojazyčná políčka. Využití na [[eng:Main Page]].
* [[:Šablona:DataLinksLatestTmpl]] – Šablona vybírá z tabulky <code>Links</code> českojazyčná políčka pro N (jediný parametr šablony; defaultní hodnota 5) posledních (nejnověji vložených) odkazů. Odkazy seřazené podle data přidání předává k zobrazení šabloně [[:Šablona:DataLinkTmpl]]. Využití na [[Úvodní stránka]].
* [[:Šablona:DataLinksBook]] – Šablona vybírá políčka popisující odkaz z [[Speciální:CargoTables/Links|tabulky Links]] pro ty odkazy, kde název stránky (<nowiki>{{FULLPAGENAME}}</nowiki>), na níž je šablona vložena, je obsažen v políčku <code>page</code>. Odkazy seřazené abecedně podle názvu předává k zobrazení šabloně [[:Šablona:DataLinkBookTmpl]]. Využití na stránkách knih v namespace <code>Knihy:</code>.
* [[:Šablona:DataLinkBookTmpl]] – TO DO

=== Osoby ===
* [[:Šablona:Person]] – definiční tabulka, definuje strukturu dat pro Cargo tabulku [https://www.franklinova-expedice.cz/w/Speci%C3%A1ln%C3%AD:CargoTables/Persons Persons]
* [[:Šablona:RelationsPersons]] – definiční tabulka, definuje strukturu dat pro Cargo tabulku [https://www.franklinova-expedice.cz/w/Speci%C3%A1ln%C3%AD:CargoTables/Persons Persons] (příbuzenské vztahy mezi osobami)
* [[:Šablona:CargoPersonDetail]] – Šablona vybírá políčka s informacemi o osobě z tabulky <code>Persons</code>. Konkrétní osoba je určena parametrem (a fallback je název stránky). Políčka jsou k zobrazení předávána šabloně [[:Šablona:CargoPersonItem]]. Využití např. na stránce [[John Franklin]].
* [[:Šablona:CargoPersonItem]] – Šablona zobrazuje předané parametry (= políčka) s informacemi o osobě + dotazuje se do [https://www.franklinova-expedice.cz/w/Speci%C3%A1ln%C3%AD:CargoTables/RelationsPersons RelationsPersons], aby získala informace o příbuzných dané osoby. Informace o příbuzných předává k zobrazení šabloně [[:Šablona:CargoPersonItemRelative]].
* [[:Šablona:CargoPersonItemRelative]] – Šablona vypisuje předané parametry (= políčka) s informacemi o příbuzných osoby.

=== Knihy ===
Pozor: Na rozdíl od ostatních kategorií Cargo dat nejsou ''Books'' ještě nikde reálně využívány.

* [[:Šablona:Book]] – definiční tabulka, definuje strukturu dat pro Cargo tabulku [https://www.franklinova-expedice.cz/w/Speci%C3%A1ln%C3%AD:CargoTables/Books Books] 
* [[:Šablona:CargoBookDetail]] – Šablona vybírá z Cargo tabulky <code>Books</code> políčka popisující knihu, jejíž název je určen parametrem (a fallback je název stránky). Vybraná políčka předává k zobrazené šabloně [[Šablona:CargoBookItemDetailItem]]. Předpokládané využití je na stránce jednotlivé knihy (tj. nikoli ve výpisu knih).
* [[:Šablona:CargoBookItemDetailItem]] – Tabulkový výpis detailu knihy z parametrů (políček) předaných šabloně.
* [[:Šablona:CargoBookList]] – Nedokončená šablona pro výběrpolíček z tabulky <code>Books</code> pro knihy vyšlé (v prvním vydání) mezi zadanými roky. Políčka vybraných knih předává k zobrazení šabloně [[:Šablona:CargoBookItem]]. Určeno pro výpis knih v přehledu všech knih.
* [[:Šablona:CargoBookItem]] – Šablona vypisuje předané parametry (= políčka) o knize jako položku seznamu.




[[Kategorie:Projekt:Správa]]