Vypíše náhledy článků v tématických skupinách (rubrikách) (verze => 1.0)
Funkce articlepreview vypíše náhledy (popř. seznam odkazů) na poslední články z jednotlivých témat/rubrik (popř. jejich skupin). Funkce má tedy využití k výpisu posledních novinek, novinových článků v jednotlivých rubrikách popř. se uplatní u stránek typu „blog“.
Proměnná count definuje styl výpisu, proměnná group systému řekne, jaké články se mají zobrazit, uselanguage umožňuje omezit výpis na konkrétní jazyk.
Parametry funkce
| Proměnná | Popis | Výchozí |
|---|---|---|
|
group (text) |
Jméno (resp. přesněji alias) tématu/rubriky (popř. skupiny témat), které se má vypsat. Skupiny témat umožňují seskupovat více témat do vyšších tématických celků (např. na blogu je možno vytvořit skupinu články, která bude obsahovat články v kategoriích počítače, fotky a práce a pomocí této funkce je potom možné vytvořit stránku obsahující přehled posledních článků ve všech třech kategoriích). Proměnná group je povinná. | nenastavena |
| annotationlength (int) | Maximální délka anotace (zobrazeno pomocí druhého argumentu v proměnné count). 0 znamená bez omezení. | 0 |
| count (array) | Definuje formát výstupu. Je nastavit pouze 1, 2 nebo všechny tři proměnné. První hodnota nastavuje počet článků, které se vypíší celé (po zalomení stránky - page - nebo po příkaz previewend), druhá hodnota nastavuje počet článků, které se zobrazí jako anotace, třetí hodnota nastavuje počet článků, které se zobrazí jako textový seznam (ul, li). | (10,0,0) |
| uselanguage |
Jazyk, na který se má omezit výpis v archivu: all - vypíše se archiv ve všech jazycích konkrétní kód jazyka (např. cs, en apod.) - použije se přesně tento konkrétní jazyk bez ohledu na jazykové nastavení dokumentu (od verze 1.2) |
auto |
Příklad
articlepreview("group=clanky|count=2,5,20|uselanguage=all")
// Funkce vypíše náhled posledních 27 článků v rubrice clanky
// 2 články budou vypsány celé, 5 jako anotace, zbylých 20 bude v textovém seznamu
// Vypíší se všechny články bez ohledu na konkrétní jazykovou verzi