XWiki sintakses ceļvedis
Pēdējais mainījis superadmin 2017/11/28 14:52
XWiki sintakse 2.1 » General
XWiki sintakse 2.1: General
Ievads
2.1 Introduction
Sākot ar XWiki Enterprise versiju 1.7 ir ieviesta jauna viki sintakse. Līdz ar to, vecā viki sintakse tiek saukta par XWiki 1.0 sintaksi, bet jaunā par XWiki 2.0 sintaksi. Galvenie jaunās sintakses ieviešanas cēloņi bija:
- Novērst 1.0 versijas ierobežojumus un nenoteiktību (kuru cēlonis bija līdz tam izmantotais Radeox sintakses izpildes dzinējs un TWiki sintakse).
- Neoptimāls kontroles simbolu pielietojums. Piemēram zvaigznītes simbols, kas tika izmantots trenknraksta apzīmēšanai. Bieži vien lietotāji ievietoja viki lapās gatavu tekstu ar zvaigznītēm un tāpēc vietām teksts tika parādīts treknrakstā, lai gan lietotāji to nevēlējās. Tāpēc, lai minimizētu ievietota teksta izskata salaušanu, jaunajā sintaksē visi kontroles simboli ir vismaz dubultā.
- Nenoteiktība. Atkal kā piemēru var minēt zvaigznītes, kas apzīmē gan treknrakstu, gan aizzīmētu sarakstu. Nenoteiktības bija nepieciešams novērst, lai varētu izstrādāt noformējuma redaktoru, kas darbojas stingri determinēti.
- Nepieciešamība tuvināties Creole 1.0 sintaksei, kas iedibinās par standarta viki sistēmu sintaksi. Creole izstrādes komūna ir veikusi visu vadošo viki sistēmu sintaksi analīzi un salīdzināšanu, izvēloties ērtākos un izplatītākos apzīmējumus. Mūsu 1.0 versijā ieviestā sintakse ne visur bija tāda.
Papildus šīm divām XWiki sintaksēm mēs bijušā Radeox dzinēja vietā esam ieviesuši īpašu sintakses apstrādes infrastruktūru, kas apstrādā Wikimodel, Doxia un nākotnē iespējams arī citus modeļus. Tas mums ļauj izmantot arī citas viki sintakses kā MediaWiki, Confluence, JSPWiki, Creole, TWiki un citas.
Vispārīgas piezīmes
2.0 General Remarks
XWiki 2.1 sintakse automātiski izlabo dažas aizmāršības kļūdas, ko nevarēja izdarīt izmantojot 1.0 sintaksi, piemēram:
| Apraksts | Nepareizas 2.1 sintakses piemērs | Tiek izlabots uz sekojošu |
|---|---|---|
| Neaizvērts treknraksts | **treknraksts | **treknraksts** |
| Divi atsevišķi elementi, kas nav atdalīti ar tukšu rindu | | tabulas šūna * aizzīmēts saraksts | | tabulas šūna * aizzīmēts saraksts |
| Divi atsevišķi elementi, kas nav atdalīti ar tukšu rindu | rindkopa ---- rindkopa | rindkopa ---- rindkopa |
| Saturs sākas ar tukšu rindu | <tukša rinda dokumenta sākumā> rindkopa | rindkopa |
| Neaizvērts virsraksts | === virsraksts | === virsraksts === |
Citas sintakses
1.0 Other Syntaxes
Sākot ar XWiki Enterprise 1.6 ir atbalstītas arī sekojošas sintakses: