MediaWiki - dynamicky generované stánky

2.4.2015 15:48 | Přečteno: 1768× | Za vším hledej Linux | | poslední úprava: 2.4.2015 16:13

Většina následujícího textu byla původně součástí nápovědy k dynamicky generovaným stránkám v mé wiki, ale pro běžné použití už mám k dispozici univerzální parametrizovanou šablonu, takže není důvod děsit uživatele víc než je nutné. Bylo mi však líto již napsaný kus textu zahodit - obzvláště, když se jím může inspirovat někdo jiný. A tak vzniknul tenhle blogpost.

Jeho cílem není rozebírat jak psát ve wiki texty pro dynamicky generované stránky - to si ostatně můžete přečíst v odkazované nápovědě, ale ukázat jak lze - takovou věc jako je sloupek - implementovat do wiki.

Typický sloupek se zobrazuje jako součást jiné stránky, ale proč by měl tuhle stránku editovat i ten kdo chce jen čas od času napsat pouze aktuální glosu? S využitím rozšíření DynamicPageList (third party) je to jednoduché. Jako obsah sloupku můžeme zobrazovat poslední editovanou stránku přiřazenou do příslušné kategorie. Sloupkařů, tj. lidí co budou psát obsah, může být klidně o více a nepotřebují vůbec editovat obsah stránky, kde se bude jejich text zobrazovat.

Jak na to?

Nejprve se musíte rozhodnout do jaké kategorie budou sloupkaři své texty kategorizovat. Pokud používáte rozšíření Translate, tak můžete obsah sloupku také překládat. V takovém případě ale doporučuji, aby kategorizace byla součástí překladu. Pro každou jazykovou verzi sloupku se pak v překladu použije kategorie pro sloupky v příslušném jazyce.

Text sloupku může být zařazen i do několika kategorií najednou.

Jak už bylo zmíněno, o vkládání obsahu sloupku do stránky se stará rozšíření DynamicPageList (third party). To má širokou škálu nastavení. Manuál s příklady je docela rozsáhlý. Následující příklad tady pouze ilustruje praktické použití, kdy chceme z kategorie "Novinky" zobrazovat pouze ten poslední editovaný článek.

<DPL>
  category = Novinky
  ordermethod = lastedit
  order = descending
  include = *
  count = 1
</DPL>

Výše uvedný kód můžeme vložit přímo do stránky na které se bude zobrazovat obsah, ale mnohem lepší je použít šablonu. Šablonu lze totiž parametrizovat a stejný kód tak opakovaně používat i na jiných stránkách a pro jiné kategorie. V šabloně se ovšem musí použít aternativní zápis, který dovoluje předat proměnnou:

{{#dpl:category={{{1}}}
  |ordermethod=lastedit
  |order=descending
  |include=*
  |count=1
}}

Příspěvky lze sbírat i z několika kategorií najednou:

<DPL>
  category = Novinky|Glosy|Aktuality
  ordermethod = lastedit
  order = descending
  include = *
  count = 1
</DPL>

Při použití v šabloně je třeba mít na paměti, že znak roury '''|''' funguje jako oddělovač předávaných proměnných, proto musí být nahrazen speciální šablonou {{!}} nebo znakem přerušené roury ¦. Zápis předchozího kódu by pak vypadal takto...

{{#dpl:category=Novinky{{!}}Glosy{{!}}Aktuality
  |ordermethod=lastedit
  |order=descending
  |include=*
  |count=1
}}

Případně takto...

{{#dpl:category=Novinky¦Glosy¦Aktuality
  |ordermethod=lastedit
  |order=descending
  |include=*
  |count=1
}}

Pro sofistikovaněji parametrizovanou šablonu se hodí rozšíření Variables, které dovoluje v šablonách definovat a používat vlastní proměnné. A rozšíření Loops, díky kterému lze zpracovávat předávané parametry ve smyčce.

U multijazyčné wiki se může hodit ještě jedna finta. Pokud byl výše uvedený kód parametrizované šablony umístěn do šablony s názvem sloupek, je na stránce, kde se zobrazuje text umístěn následující kód:

{{sloupek|Sloupek-test}}

Parametrem je jméno kategorie. Pokud chceme podporovat více jazykových verzí na jedné stránce, vytvoříme systémovou zprávu MediaWiki:test-news, kterou lze rovněž překládat s využitím rozšíření Translate a pro každou z existujících jazykových verzí zde umístíme název kategorie odpovídající jazyku. Pro českou verzi to může být kategorie "Novinky", pro anglickou "News" a pro polskou třeba "Aktualności". V kódu stránky využijeme překlad systémových zpráv:

{{sloupek|{{int:test-news}}}}

Obsah sloupku se pak bude měnit, podle toho jaký jazyk rozhraní bude mít zvolen uživatel přistupující na stránku.

Dříve vyšlo..

• MediaWiki - rozšíření Translate - kromě rozšíření Translate zde padla zmínka také o rozšíření AccessControl.
• Čuňačíme v MediaWiki - příklad využití rozšíření ExternalRedirect.
• Čuňačíme v MediaWiki dál - popisuje, jak v prostředí MediaWiki modifikovat textové zprávy k rozšíření ConfirmAccount.
• Od čuňáren ke korektnímu obsahu MediaWiki - popisuje jak u multijazyčné wiki využívat možnosti rozšíření ParserFunctions
• Čuňačíme v MediaWiki - opět - popisuje jak využít možností rozšíření ParserFunctions MyVariables k modifikaci nabízeného obsahu wiki na základě autentifikace.

       

Komentáře

[:)]

ked uz s to tu vola kennyho stesky - aspon 1 komentar na to rozjímanie :)