Extension:Page Forms/Quick start guide/cs

Takže, nainstalovali jste na svůj web veškerý potřebný software. Co teď? Teď je ta správná chvíle vytvořit sadu stránek, přes kterou budete moct spravovat, zobrazovat, přidávat a upravovat svoje data; a jejím prostřednictví bude možné velice jednoduše generovat nejrůznější wiki stránky.

Nejprve si musíte ujasnit jak jsou strukturovaná vaše data, to je prvním krok, co musíte udělat. Jaké typy stránek budou zapotřebí? Jaká data budou obsahovat? To vše lze dodatečně změnit, ale už od počátku byste měli mít nějaký výchozí plán. Jakmile je budete takový plán mít (v ideálním případě je dobré si ho někam napsat), můžete přejít k vytvoření potřebných stránek wiki. Bude potřeba založit, nebo upravit stávající stránky pro šablony a formuláře, vymyslet pro ně vhodnou kategorii a (pokud používáte sémantickou MediaWiki) i jaké budou mít vlastnosti.

Klidně si je můžete vytvořit postupně sami, ale proč byste to dělali, když máte k dispozici pomocné formuláře, které vám s vytvořením těchto stránek pomohou? Jak na to jít, záleží také na tom, jaká další rozšíření používáte:

Používáte-li rozšíření Cargo

Special:CreateClass - nejjednodušší cesta

Stránka Special:CreateClass, definovaná pomocí Page Forms, poskytuje jeden pomocný formulář pro definování všeho o datové "třídě" na jednom místě. Pokud vyplníte pole a kliknete na tlačítko "submit" (odeslat), stránka automaticky vytvoří potřebnou šablonu, formulář a stránky kategorií. Pak můžete přejít na vytvořenou stránku formuláře a začít zadávat data.

Pokud se zdá, že se nevytvářejí všechny stránky, je možné, že ve frontě úloh není dostatek paměti. Informace o přidání paměti naleznete v položce týkající se fronty úloh zde.

Komplexnější způsob

Měli byste provést následující kroky:

  • Vytvořit šablony. Šablona zajišťuje zobrazení dat na stránce, obsahuje značky pro uložení dat v Cargo tabulkách a (obvykle) také kategorizuje stránku do určité kategorie, a určuje také jakého bude typu. Pro každý typ stránky obvykle existuje pouze jedna šablona, ale některé typy stránek mohou současně používat i několik šablon. Šablonu lze také použít k agregaci, kdy se zobrazí seznam všech ostatních stránek, které mají k této stránce určitý vztah. Pro vytvoření šablony (či šablon) použijte stránku Special:CreateTemplate.
  • Vytvořit formuláře. Teď můžete vytvářet formuláře, které uživatelům umožní snadno přidávat a upravovat obsah stránek nejrůznějšího typu. Pro každý typ stránky by měl existovat pouze jeden formulář; ten vloží data jako paramtery šablony (nebo šablon), které tento typ stránky bude obsahovat. Podobně jako v předchozím případě, i pro zakládání formulářů je k dispozici speciální stránka: Special:CreateForm.
  • Vytvořit kategorie. Alespoň jedna šablona v každém formuláři by měla zajišťovat kategorizaci každého nového článku, který se přes tento formulář vytvoří. Pro každou takovou kategorii byste měli vytvořit stránku a nastavit pro ni výchozí formulář, aby bylo možné každou stránku z této kategorie možné dodatečně editovat přes formulář, který ji vytvořil. Nejjednodušší způsob, jak to udělat, je použít stránku Special:CreateCategory.
  • Povolit odkazy na formuláře. Kromě vytvoření kategorie s výchozím formulářem byste měli podniknout i další kroky, abyste uživatelům umožnili přístup k vámi vytvořeným formulářům. Patří mezi ně i přidání odkazů pro přidání dat do postranního panelu a jinam, a také použití funkcionality #formredlink, aby červené odkazy na neexistující stránky volaly odpovídající formulář pro jejich vytvoření. To vše je vysvětleno v části Propojení formulářů.
  • Přidat odkazy na postranní panel a jinam. Obsah postranního panelu (je dán obsahem stránky "MediaWiki:Sidebar") můžete upravit tak, aby obsahoval odkazy pro přidání jednotlivých typů dat. Můžete přidat také odkaz na stránku Special:Drilldown, což je stránka kterou poskytuje Cargo, která umožňuje snadné zobrazení všech údajů wiki najednou. Tyto odkazy ale můžete umístit i na hlavní stránku a jinam.
  • Přidat data. A teď můžete začít vkládat data! Stačí přejít na formulář a začít se zakládáním stránek.
  • Přizpůsobit. Jakmile už máte jednou tuhle sadu stránek vytvořenou, můžete si ji přizpůsobovat dle libosti - měnit vzhled celé wiki, různých šablon a formulářů, přidávat a měnit pole, či přidávat a upravovat dotazy.

Používáte-li rozšíření Semantic MediaWiki

Special:CreateClass - nejjednodušší cesta

Stránka Special:CreateClass, definovaná pomocí Page Forms, poskytuje jeden pomocný formulář pro definování všeho o datové "třídě" na jednom místě. Pokud vyplníte pole a kliknete na tlačítko „odeslat“, stránka automaticky vytvoří všechny potřebné stránky s vlastnostmi, šablonami, formuláři a kategoriemi. Pak můžete přejít na vytvořenou stránku formuláře a začít zadávat data.

Pokud se zdá, že se nevytvářejí všechny stránky, je možné, že ve frontě úloh není dostatek paměti. Informace o přidání paměti naleznete v položce týkající se fronty úloh zde.

Komplexnější způsob

Měli byste provést následující kroky:

  • Vytvořit vlastnosti. Základními stavebními kameny každého sémantického webu jsou propojení mezi daty, která jsou v Semantic MediaWiki známá jako vlastnosti. Vlastnost se používá k určení jedné informace o tématu této stránky. Každá vlastnost by měla být definována na vaší wiki, se stránkou v jmenném prostoru "Property:". Každou vlastnost vytvoříte na stránce Special:CreateProperty.
  • Vytvořit šablony. Šablona nastavuje zobrazení dat na stránce, uchovává značky pro převod dat na skutečné sémantické informace a (často) definuje stránku jako stránku určité kategorie, a tedy určitého typu stránky. Obecně bude pro každý typ stránky jedna šablona, ​​i když někdy jeden typ stránky může obsahovat více než jednu šablonu. Šablonu lze také použít pro agregaci, a to zobrazením seznamu všech ostatních stránek, které mají k této stránce určitý vztah (další informace naleznete v dokumentaci k inline queries). Pro vytvoření šablony (či šablon) použijte stránku Special:CreateTemplate.
  • Vytvořit formuláře. Nyní můžete vytvářet formuláře, které uživatelům umožní snadno přidávat a upravovat stránky různých typů. Pro každý typ stránky by měl existovat pouze jeden formulář; ten vloží data jako paramtery šablony (nebo šablon), které tento typ stránky bude obsahovat. Stejně jako dříve existuje speciální stránka pro vytváření nových formulářů: Special:CreateForm.
  • Vytvořit kategorie. Jedna šablona v každém formuláři by měla označit každý článek, který formulář vytvoří, jako součást určité kategorie. Pro každou takovou kategorii byste měli vytvořit stránku a zadat pro ni výchozí formulář, aby každý článek bylo možné automaticky upravovat pomocí stejného formuláře, ve kterém byl vytvořen. Nejjednodušší způsob, jak to udělat, je použít stránku Special:CreateCategory.
  • Povolit odkazy na formuláře. Kromě vytváření kategorií s výchozím formulářem existují i ​​další kroky, které byste měli podniknout, abyste uživatelům umožnili přístup k formulářům, které jste vytvořili. Patří sem přidávání odkazů pro přidání dat do postranního panelu a jinde a použití #formredlink, aby červené odkazy na neexistující stránky odkazovaly na formulář pro jejich vytvoření. Všechny tyto akce jsou vysvětleny v sekci "Propojení s formuláři".
  • Přidat odkazy na postranní panel a jinam. Postranní panel (který lze u anglicky psaných wikin upravovat na stránce "MediaWiki:Sidebar") by měl obsahovat odkazy pro přidání jednotlivých datových typů a také na kategorie pro každý z těchto datových typů. Takové odkazy můžete umístit i na hlavní stránku a jinde.
  • Přidat data. A teď můžete začít vkládat data! Stačí přejít na stránku (stránky) formuláře a začít vytvářet stránky.
  • Přizpůsobit. Jakmile je struktura nastavená, můžete si ji libovolně upravovat – měnit vzhled a dojem z celé wiki, různých šablon a formulářů, přidávat a měnit pole a přidávat a měnit vložené dotazy.

Příklad

Projděme si konkrétní příklad nastavení wiki, používající rozšíření Page Forms, a to tím "komplexnějším způsobem", tj. od základu. Řekněme, že chcete vytvořit wiki, která bude zobrazovat všechny knihy, které máte doma. Ok. Projděme si tedy postupně všechny předchozí uvedené kroky, přičemž si ukážeme, jak se budou některé části v tomto postupu lišit v závisloti na tom, zda-li použijete Cargo nebo Semantic MediaWiki.

1. Rozhodněte si jak budete mít strukturovaná data. Na své wiki chcete mít dva typy stránek: jeden bude pro knihy a druhý pro autory. Každá stránka knihy by měla obsahovat její název, jméno autora (a spoluautorů), žánr (nebo žánry), rok vydání a počet stran. Na stránce každého autora by mělo být uvedeno jeho jméno, země původu a seznam všech knih, které napsal a které vlastníte.

2. Nastavte vlastnosti.

Používáte-li rozšíření Cargo Používáte-li Semantic MediaWiki
Cargo, s vlastnostmi nepracuje. Pro knihy není pro název potřeba žádnou vlastnost dělat, protože název stránky bude stejný jako název knihy.

Zbývají čtyři pole:

  • Autoři - pomocí stránky "Create a property" (vytvořit vlastnost) (na adrese Special:CreateProperty) vytvoříte vlastnost s názvem "Napsal(a)" typu "Page" (protože každý autor bude mít svou vlastní stránku).
  • Žánr - vytvoříte vlastnost s názvem "Má žánr" typu "Text" a přiřadíte jí povolené hodnoty, například: "Umění, Kuchařka, Beletrie, Historie, Poezie, Věda".
  • Rok vydání - vytvoříte vlastnost s názvem "Rok vydání" typu "Number".
  • Počet stránek - vytvoříte vlastnost s názvem "Má počet stránek" typu "Number".

Pro stránky autora stačí vytvořit pouze jednu další vlastnost:

  • Země původu - vytvoříte vlastnost s názvem "Pochází ze země" typu "Text".

3. Vytvořte šablony. Musíte vytvořit dvě šablony, jednu pro knihy a jednu pro autory, obě na stránce "Create a template" (vytvořit šablonu) na adrese Special:CreateTemplate.

Zaprvé, knihy:

Používáte-li rozšíření Cargo Používáte-li Semantic MediaWiki
V proměnné Special:CreateTemplate nastavte název šablony na "Book" a název kategorie na "Books".

Přidáte k němu čtyři pole a pro každé pole zadáte alespoň tři hodnoty: Název pole ve zdrojovém kódu šablony, jeho popisek pro zobrazení na každé stránce a jeho typ. Můžete nastavit i několik dalších hodnot, ale pro většinu těchto polí nebudou nutné.

  1. Pro první pole nastavte název pole na "Authors", popisek na "Author(s)" a typ na "Page". Také je třeba zaškrtnout políčko, které označuje, že toto pole může obsahovat seznam hodnot (protože kniha může mít více než jednoho autora).
  2. Klikněte na Přidat pole a poté pro druhé pole zadejte tři hodnoty: "Genres" (žánry), "Genre(s)" (žánr(y)) a "String". Znovu je třeba zaškrtnout políčko, které označuje, že toto pole může obsahovat seznam hodnot. Pak byste měli specifikovat sadu povolených hodnot. To lze provést buď jako jednoduchý seznam, nebo jako hierarchii. Můžete si nastavit jednoduchý seznam jako „Umění, Kuchařka, Beletrie, Historie, Poezie, Věda“ atd.. Nebo si můžete nastavit úplnou hierarchii, která by mohla vypadat takto:
* Fiction
** Science fiction
*** Cyberpunk
** Historical fiction
...a tak dále.
3. Klikněte na Přidat pole a poté pro třetí pole nastavte hodnoty na "Year" (rok), "Year of publication" (rok vydání) a "Date" (datum) (lepší volba než "Integer").
4. Klikněte na Přidat pole a poté pro čtvrté pole nastavte hodnoty "Number of pages" (počet stránek), "Number of pages" a "Integer" (celé číslo).
5. Klikněte na tlačítko Uložit stránku.
 V proměnné Special:CreateTemplate nastavte název šablony na "Book" (kniha) a název kategorie na "Books" (knihy).

Přidáte k němu čtyři pole a pro každé pole zadáte tři hodnoty: Název pole ve zdrojovém kódu šablony, jeho popisek zobrazení na každé stránce a sémantickou vlastnost, kterou naplní.

  1. Pro první pole nastavte název pole na "Authors", popisek na "Author(s)" a sémantickou vlastnost na "Was written by" (Bylo napsáno) a zaškrtněte políčko, které označuje, že toto pole může obsahovat seznam hodnot (protože kniha může mít více než jednoho autora);
  2. Klikněte na Přidat pole a poté pro druhé pole nastavte tři hodnoty na "Genres", "Genre(s)" a "Has genre" (má žánr) a také zaškrtněte políčko pro seznam hodnot;
  3. Klikněte na Přidat pole a poté pro třetí pole nastavte hodnoty na "Year" (rok), "Year of publication" (rok vydání) a "Was published in year" (vydáno v roce);
  4. Klikněte na Přidat pole a poté pro čtvrté pole nastavte hodnoty na "Number of pages" (počet stránek), "Number of pages" (počet stránek) a "Has number of pages" (má počet stránek).
  5. Klikněte na tlačítko Vytvořit.

Dále vytvořte šablonu pro Autory – pomocí stránky "Vytvořit šablonu" vytvoříte šablonu s názvem "Author" a nastavíte ji tak, aby definovala kategorii "Authors".

Používáte-li Cargo Používáte-li Semantic MediaWiki
  1. Do této šablony stačí přidat jedno pole, pro které nastavíte tři hodnoty: "Country" (země), "Country of origin" (země původu) a "Page".
  2. Klikněte na tlačítko Uložit stránku.
  1. Do této šablony stačí přidat jedno pole, pro které nastavíte tři hodnoty: "Country" (země), "Country of origin" (země původu) a "Is from country" (pochází ze země).
  2. V této šabloně vyplníte také pole "Agregace" ve formuláři, protože chcete, aby každá stránka autora obsahovala seznam všech knih, které autor napsal. V části "Sémantická vlastnost" vyberete "Was written by" (bylo napsáno) a v části "Title for list" (název seznamu) zadáte "Books by this author" (knihy od tohoto autora).
  3. Klikněte na tlačítko Uložit stránku.

4. Vytvořte formuláře. Musíte vytvořit dva formuláře, jeden pro knihy a jeden pro autory:

  • Books (knihy) - pomocí stránky "Vytvořit formulář" (na adrese Special:CreateForm) vytvoříte formulář s názvem "Book" (kniha), vyberete šablonu "Book" a kliknete na tlačítko Přidat. Volitelně můžete také přidat sekci s dějovou linií knihy – k tomu přidejte sekci (ne šablonu) s názvem "Plot". Na tomto formuláři neprovádíte žádné další úpravy, ale po vytvoření jej pouze uložíte.
  • Authors - pomocí stránky "Vytvořit formulář" vytvoříte formulář s názvem "Author" a přidáte do něj šablonu "Author". Stejně jako dříve, neprovádíte žádné další úpravy – stránku pouze uložíte.

5. Vytvořte kategorie. Musíte vytvořit dvě kategorie, jednu pro knihy a jednu pro autory. Názvy těchto kategorií jste již dříve zadali:

  • Books - pomocí stránky "Vytvořit kategorii" (na Special:CreateCategory) vytvoříte kategorii s názvem "Books" a přiřadíte jí výchozí tvar "Book".
  • Authors - na stránce "Vytvořit kategorii" vytvoříte kategorii s názvem "Authors" a přiřadíte jí výchozí tvar "Author".

6. Povolte odkazy na formuláře.

Používáte-li rozšíření Cargo Používáte-li Semantic MediaWiki
V textu šablony knihy (v adresáři Template:Book) najděte část zobrazení obsahující značku: 
{{{Authors|}}}

Nahraďte to něčím jako:

{{#arraymap:{{{Authors|}}}|,|x|{{#formredlink:target=x|form=Author}} }}
 Text šablonu Book (v adresáři Template:Book) má s největší pravděpodobností část, která vypadá takto 
{{#arraymap:{{{Authors|}}}|,|x|[[Was written by::x]]}}

Nahraďte to něčím jako

{{#arraymap:{{{Authors|}}}|,|x|{{#formredlink:target=x|form=Author}}{{#set:Was written by=x}}}}

Díky tomu odkazy na stránky autora, které ještě neexistují, odkazují na formulář pro jejich vytvoření.

7. Přidejte data. Pomocí nového formuláře "Book" (na Form:Book) vytvoříte stránky pro některé knihy.Zkontrolujete, zda formulář i výsledné stránky vypadají v pořádku. Každá stránka knihy bude nyní mít červený odkaz na svého autora, který by měl odkazovat na formulář "Author" pro přidání daného autora (pro zobrazení správného odkazu bude možná nutné stránku aktualizovat). Pak můžete přidat několik autorů, buď prostřednictvím těchto odkazů, nebo přímo ze stránky formuláře, abyste se ujistili, že i toto nastavení funguje správně. Každá vytvořená stránka autora by měla zobrazovat seznam knih, které jste si uložili a u kterých je daná osoba uvedena jako autor.

8. Přidejte odkazy na postranní panel a jinam. Vaše struktury jsou nyní nastaveny a můžete přidat odkazy na postranní panel pro snadné přidávání a prohlížení úpravou proměnné stránky MediaWiki:Sidebar (nebo jejího ekvivalentu, pokud používáte jiný jazyk než angličtinu). Do formulářů "Book" a "Author" můžete přidat odkazy, abyste si usnadnili přidávání nových. Můžete také propojit funkci Special:Drilldown (pokud máte nainstalované Cargo) nebo Special:BrowseData (pokud máte nainstalované rozšíření Semantic Drilldown), abyste uživatelům umožnili zobrazit všechna data na první pohled.

Použití schémat stránek

Rozšíření Schémata stránek je speciálně určeno pro automatizované vytváření datových struktur, včetně formulářů. Jeho velkou výhodou oproti standardním pomocným formulářům PF je, že jej lze použít k mnohonásobnému vytváření a úpravě těchto stránek datových struktur, nikoli pouze k jejich jednorázovému vytvoření. Lze jej použít s nainstalovaným Cargo nebo Semantic MediaWiki, nebo i bez nainstalovaného žádného z nich. Pokud je nainstalován Cargo a nebo SMW, formulář Page Schemas bude obsahovat mnoho dalších polí formuláře, aby bylo možné vytvořit další potřebné tagy. Chcete-li vytvořit schéma stránky, musíte přejít na stránku kategorie (ať už byla vytvořena, nebo ne), přejít na akci Tab pro vytvoření schématu dané stránky, vyplnit formulář a poté přejít na akci Tab pro generování stránek na základě daného schématu. Více informací naleznete v dokumentaci k Page Schemas.

Stručné referenční příručky

Existují dva stručné referenční průvodci neboli "taháky" vhodné k tisku, které obsahují užitečné informace o formulářích stránek (ačkoli v obou případech se na ně stále odkazuje jako na "sémantické formuláře"), mimo jiná rozšíření:

  • Stručný průvodce knihou Cargo – ve formátech PNG a PDF
  • Stručná referenční příručka Semantic MediaWiki – naleznete zde na adrese zde ve formátech PNG (obrázek), PDF a SVG