Návod -> Beautifier Plugin
Pri písaní wiki článkov, môže nastať situácia, kedy chce autor do článku vložiť časť zdrojového kódu. Vtedy je vhodné použiť tento plugin. Jedná sa rozšírenie umožňujúce mať fragmenty zdrojových kódov automaticky sformátované a farebne zvýraznené. Používanie tohto pluginu je pomerne jednoduché. Zdrojový kód sa vloží medzi dve značky
%CODE{“jazyk“}%
....zdrojový kód....
%ENCODE%
Položka jazyk sa prepíše názvom programovacieho jazyka, v ktorom bol zdrojový kód napísaný. Nasledujúca tabuľka je zoznamom možných použiteľných programovacích jazykov v tomto plugine.
| Jazyk |
Syntax |
| Bash |
%CODE{“bash“}% ... %ENCODE% |
| C++ |
%CODE{“cpp“}% ... %ENCODE% |
| C# |
%CODE{“csharp“}% ... %ENCODE% |
| Java |
%CODE{“java“}% ... %ENCODE% |
| JavaScript |
%CODE{“javascript“}% ... %ENCODE% |
| Lua |
%CODE{“lua“}% ... %ENCODE% |
| Makefile |
%CODE{“makefile“}% ... %ENCODE% |
| Perl |
%CODE{“perl“}% ... %ENCODE% |
| PL/SQL |
%CODE{“plsql“}% ... %ENCODE% |
| Python |
%CODE{“python“}% ... %ENCODE% |
| PHP3 |
%CODE{“php3“}% ... %ENCODE% |
| Scheme |
%CODE{“scheme“}% ... %ENCODE% |
| TCL |
%CODE{“tcl“}% ... %ENCODE% |
| HTML |
%CODE{“html“}% ... %ENCODE% |
| XML |
%CODE{“xml“}% ... %ENCODE% |
| Verilog |
%CODE{“verilog“}% ... %ENCODE% |
| VHDL |
%CODE{“vhdl“}% ... %ENCODE% |
Tabuľka je flexibilná a do zoznamu môžu byť pridané ďalšie programovacie jazyky. Súbor s daným programovacím jazykom sa stiahne z oficiálnej stránky pluginu. Následne sa stiahnutý súbor skonvertuje z PHP formátu do Perl. Fragmenty zdrojových kódov sú formátované používaním CSS. Pre zmenu vzhľadu sformátovaného kódu je potrebné načítať novú verziu style.css do daného článku.
Názorný príklad ukazuje použitie Beautifier pluginu so zdrojovým kódom, ktorý je napísaný v jazyku C++. Do okna textového editora na stránke TWiki sa napíše:
%CODE{"cpp"}%
//komentár
void a() {
print("Hello.\n");
}
%ENDCODE%
Po uložení si článok môžeme pozrieť. Výsledný sformátovaný, farebný zdrojový kód:
//komentár
void a() {
print("Hello.\n");
}
Bližšie informácie na
BeautifierPlugin
--
MiroslavPorada - 18 May 2011