Projekt: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 Data:.

• 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 Data: jsou kategorizovány do kategorií podle typu obsahu. Všechny tyto "Cargo kategorie" pak patří do "sběrné" Kategorie:Data.

• 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 Events
• Šablona:DataCalendarFullTmpl – výpis celého kalendáře na stránce Kalendárium. Tato šablona pouze vybírá políčko year z tabulky Events a jako template volá Šablona:DataCalendarYearTmpl
• Šablona:DataCalendarYearTmpl – Tato šablona vybírá na základě předaného parametru (= year) z tabulky Events 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 Events 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 ({{CURRENTMONTH1}}) 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 page obsažen název stránky ({{FULLPAGENAME}}). 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 tit_top, 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 Links
• Šablona:DataLinksPage – Šablona vybírá políčka popisující odkaz z tabulky Links pro ty odkazy, kde název stránky ({{FULLPAGENAME}}), na níž je šablona vložena, je obsažen v políčku page. 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 Links č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 Links č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.

Osoby

• Šablona:Person – definiční tabulka, definuje strukturu dat pro Cargo tabulku Persons
• Šablona:RelationsPersons – definiční tabulka, definuje strukturu dat pro Cargo tabulku Persons (příbuzenské vztahy mezi osobami)
• Šablona:CargoPersonDetail – Šablona vybírá políčka s informacemi o osobě z tabulky Persons. 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 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 Books
• Šablona:CargoBookDetail – Šablona vybírá z Cargo tabulky Books 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 Books 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.