Za tajemstvím Xoops kódů
Datum 12. 10. 2008 v 14:30 | Rubrika: Zápisník pojídačky koláčů pro Xoops
| Redakční systém Xoops dovede formátovat text pomocí speciálních Xoops kódů. Ty jsou podobné značkám HTML, ale jsou jednodušší a část parametrů si Xoops doplní sám.
Xoops kódů existuje několik druhů a je jich relativně málo, což usnadňuje jejich použití při formátování textu.
Xoops kódy mají dvě možnosti zápisu. Všechny jsou ale párové, čili každý kód musí být ukončený. Pokud se dvojice neukončí, může zobrazení stránky dopadnou všelijak.
Nejjednodušší je zápis [xoopscode]text[/xoopscode]. Tento zápis se používá pro kódy bez předávání dalších parametrů. Pokud je potřeba předat další parametry, zapisuje se kód takto [xoopscode=hodnota]text[/xoopscode]. Ovšem ne všechny kódy podporují předání parametru. Které kódy parametry podporují a které ne, vyplyne z dalšího textu.
Xoops kódy v dalším textu jsou zapisované takto [ kód ] text [ /kód ].
Pro jejich použití je nutné mezery před a za kódem vymazat.
Formátování textuKaždý text se dá upravit pomocí Xoops kódů, pro text jich je také nejvíce.
Změna velikosti textu - [ size=velikost ][ /size ]
Kód [ size=xx-small ]nejmenší[ /size ] se zobrazí jako písmo Nejmenší.
Kód [ size=x-small ]hodně malé[ /size ] se zobrazí jako písmo hodně malé.
Kód [ size=small ]malé[ /size ] se zobrazí jako písmo malé.
Kód [ size=medium ]střední[ /size ] se zobrazí jako písmo střední.
Kód [ size=large ]velká[ /size ] se zobrazí jako písmo velké.
Kód [ size=x-large ]hodně velké[ /size ] se zobrazí jako písmo hodně velké.
Kód [ size=xx-large ]největší[ /size ] se zobrazí jako písmo největší.
Změna barvy textu - [ color=barva ][ /color ]
Kód [ color=0000FF ]text[ /font ] se zobrazí jako písmo psané modrou barvou.
Kód [ color=00FF00 ]text[ /font ] se zobrazí jako písmo psané zelenou barvou.
Kód [ color=FF0000 ]text[ /font ] se zobrazí jako písmo psané červenou barvou.
Kód [ color=CC5500 ]text[ /font ] se zobrazí jako písmo psané hnědou barvou.
Kód [ color=333333 ]text[ /font ] se zobrazí jako písmo psané tmavě šedou barvou.
Barva se zadává jako tři hexadecimální slabiky. Pořadí je červená zelená modrá.
Změna fontu textu - [ font=font ][ /font ]
Kód [ font=Arial ]text[ /font ] se zobrazí jako písmo psané Arialem.
Kód [ font=Courier ]text[ /font ] se zobrazí jako písmo psané Courierem.
Kód [ font=Georgia ]text[ /font ] se zobrazí jako písmo psané Georgií.
Kód [ font=Helvetica ]text[ /font ] se zobrazí jako písmo psané Helveticou.
Kód [ font=Impact ]text[ /font ] se zobrazí jako písmo psané Impactem.
Kód [ font=Verdana ]text[ /font ] se zobrazí jako písmo psané Verdanou.
Změna řezu písma - [ b ][ /b ], [ u ][ /u ], [ i ][ /i ], [ d ][ /d ]
Kód [ b ] text [ /b ] se zobrazí jako písmo tučné.
Kód [ i ] text [ /i ] se zobrazí jako písmo kurzivou.
Kód [ u ] text [ /u ] se zobrazí jako písmo podtržené.
Kód [ d ] text [ /d ] se zobrazí jako písmo přeškrtnuté.
Citace textu - [ quote ] text [ /quote ]
Kód [ quote] text [/quote] se zobrazí jako:
Citát: Tento text je označený jako citace nějakého jiného textu.
I v citaci se dají používat Xoops kódy i HTML.
Odkazy:Odkaz může být buď na jinou stránku, na stránku uvnitř vlastního webu nebo poštovní. Odkaz na jinou stránku se otevře v novém okně či panelu.
Externí odkaz - [ url=vzdálená URL ]
Kód [ url=www.hw.cz ] vytvoří externí odkaz na server www.hw.cz.
Externí odkaz se vždy otevře v novém okně.
Zadává se bez http://, protože to vloží sám Xoops.
Vnitřní odkaz - [ siteurl = vnitřní URL ]
Kód [ siteurl=modules/lexikon/ ] vytvoří vnitřní odkaz na Lexikon.
Vnitřní odkaz se zadává trochu jinak než externí.
Xoops sám před adresu vloží obsah konstanty XOOPS_ROOT_PATH a lomítko.
Poštovní odkaz - [ email ] adresa [/ email ]
Kód [ email ]jmeno@server.cz[ /email ] vytvoří poštovní odkaz jmeno@server.cz.
Po kliknutí na poštovní odkaz se spustí výchozí poštovní program a začne se vytvářet nová zpráva.
ObrázkyObrázky se dají vložit bez zadaného zarovnání a nebo sním.
Bez parametrů - [ img ]http://www.zirafoviny.cz/obr.jpg[ /img ]
Zarovnání doleva - [ img align=left ]http://www.zirafoviny.cz/obr.jpg[ /img ]
Zarovnání na střed - [ img align=center ]http://www.zirafoviny.cz/obr.jpg[ /img ]
Zarovnání doleva - [ img align=right ]http://www.zirafoviny.cz/obr.jpg[ /img ]
Nejlépe to ukáží následující ukázky. Pokud se vloží neznámá hodnota zarovnání, systém celý příkaz ignoruje a zobrazí jej jako normální text.
Normálně vložený obrázek bez nastaveného zarovnání:
 Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Morbi nec ante ut velit porta posuere. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Quisque rutrum elit eu mauris. Aliquam bibendum adipiscing magna. Proin rutrum aliquet elit. Quisque et justo. Maecenas auctor lorem eu tellus. Praesent ac lorem. Aenean sit amet magna. Donec tincidunt neque vel mauris malesuada congue. In a nisi ac dui dignissim ultricies. Quisque aliquet iaculis velit. Vestibulum semper nisi eget nulla. Sed vitae velit.
Obrázek zarovnaný doleva:
Donec bibendum. Maecenas nunc mi, placerat ut, eleifend sit amet, rutrum at, nulla. Quisque in mauris. Proin pretium mauris quis orci. Curabitur ac mi quis nibh ultricies molestie. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Suspendisse imperdiet vestibulum lorem. Curabitur venenatis gravida mauris. Ut interdum. Ut id lacus.
Obrázek zarovnaný na střed:
Suspendisse consequat hendrerit est. Mauris tortor sapien, suscipit sed, semper ac, congue ac, nulla. Curabitur at est eu turpis ullamcorper posuere. Duis ornare. Aenean molestie tellus et eros. Vestibulum cursus, nulla sit amet pulvinar fermentum, nibh leo venenatis sem, a fermentum ante arcu ut lectus. Suspendisse vehicula magna ac mi. In eget tellus. Etiam ac ipsum. Praesent porta orci vel urna. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Fusce sit amet orci id dui dignissim interdum. Cras ligula eros, faucibus ut, rutrum ut, ultricies eu, ante.
Obrázek zarovnaný doprava:
Etiam enim dui, adipiscing nec, pellentesque in, ornare non, ligula. Integer sed risus. Proin gravida, lacus vitae consectetuer pulvinar, metus mauris facilisis quam, vel tempor est tellus et sapien. Praesent lorem. Nullam enim est, commodo vel, congue at, bibendum non, urna. Duis lacus nunc, tempus et, aliquam non, tempor nec, lorem. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Nam eu neque sed nunc gravida volutpat. Vestibulum a nulla. Suspendisse pellentesque rhoncus erat. Aenean magna ipsum, consequat adipiscing, facilisis eu, tincidunt quis, libero. Vestibulum pulvinar, risus id tempus sodales, arcu libero ullamcorper diam, id tincidunt magna turpis sed nisi. Sed nec magna facilisis nisi sollicitudin semper. Suspendisse potenti. Nam congue urna non magna. Donec id elit quis purus sagittis vehicula. Aenean rhoncus. Aliquam blandit ante a purus.
Tento článek popisuje Xoops kódy použitelné pro verzi Xoops 2.0.18 a nižší. Ve vyšších verzích je lze použít také, tam jsou však ještě i některé další. O těch zase někdy příště.
Použité zdroje:
Informace na oficiálních stránkách systému.
Článek XOOPS Codes Explained na webu Marka Boydena
Vlastní zkoumání systému Xoops a hlavně souboru module.textsanitizer.php.
|
|