Vispārīgas darbības
Pieteikties
Reģistrēties
Viki: Main wiki ▼: Dokumentu saraksts
»
Vieta: XWiki ▼: Dokumentu rādītājs
»
Lapa: XWikiSyntax
Meklēt
default lv sv de it
Lapas darbības:
Eksports ▼: Eksportēt kā PDF Eksportēt kā RTF Eksportēt kā HTML
Pārējās darbības ▼: Priekšskatīt Skatīt pirmkodu
Viki sākuma lapa » XWiki vieta » XWiki Syntaxes

# XWiki Syntaxes

Pēdējais mainījis Administrator 2012/03/21 17:40
Komentāri (0) · Anotācijas (0) · Pielikumi (1) · Vēsture · Informācija
Saturs

- Versiju izmaiņas
- Vispārīgas piezīmes
- Rindkopas
- Virsraksti
- Teksta noformējums
- Horizontāla līnija
- Saraksti
- Definīciju saraksts
- Pārnesumi jaunā rindā
- Saites
- Tabulas
- Attēli
- Precīza teksta kopija
- Citāti
- Grupas
- Rakstzīmju ekranēšana
- Makrosi
- HTML
- Velocity/Groovy skripti
- Parametri
- Citas sintakses

# Versiju izmaiņas

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

XWiki 2.0 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.0 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 ===`

# Rindkopas

Rindkopas tiek atdalītas ar vienu vai vairāk tukšām rindām.

XWiki 2.0 sintaksē viens rindas pārnesums tiek ņemts vērā, bet XWiki 1.0 sintaksē tas netika ņemts vērā.

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts XWiki 1.0 sintaksē | Rezultāts XWiki Syntax 1.2
--- | --- | --- | --- | ---
Vienkārša rindkopa | Šī ir rindkopa | Šī ir rindkopa | Šī ir rindkopa | Šī ir rindkopa
Rindkopa vairākām rindām | Rindkopa ar\\ vairākām rindām | Rindkopa ar vairākām rindām | Rindkopa ar vairākām rindām | Rindkopa ar vairākām rindām
Divas rindkopas | 1. rindkopa 2. rindkopa | 1. rindkopa 2. rindkopa | 1. rindkopa 2. rindkopa | 1. rindkopa 2. rindkopa
Rindkopa ar parametriem | <p style="text-align:center;color:blue">Centrēta rindkopa ar zilu tekstu</p> | `(% style="text-align:center;color:blue" %)` Centrēta rindkopa ar zilu tekstu | Centrēta rindkopa ar zilu tekstu | Centrēta rindkopa ar zilu tekstu

# Virsraksti

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts
--- | --- | --- | ---
Parasti virsraksti | 1 1. līmenis 1.1 2. līmenis 1.1.1 3. līmenis 1.1.1.1 4. līmenis 1.1.1.1.1 5. līmenis 1.1.1.1.1.1 6. līmenis |
    = 1. līmenis =
    == 2. līmenis ==
    === 3. līmenis ===
    ==== 4. līmenis ====
    ===== 5. līmenis =====
    ====== 6. līmenis ======
| # 1. līmenis ## 2. līmenis ### 3. līmenis #### 4. līmenis ##### 5. līmenis ###### 6. līmenis
Virsraksts ar parametriem | <h1><span style="color:blue">virsraksts</span></h1> | `(% style="color:blue" %)` = virsraksts = | # virsraksts
Virsraksts ar viki sintaksi | 1.1.1 Virsraksts ar *treknrakstu* | `=== Virsraksts ar **treknrakstu** ===` | ### Virsraksts ar treknrakstu

# Teksta noformējums

XWiki 2.0 sintakses izmaiņas attiecībā pret XWiki 1.0 sintaksi:

- Pēc noformējuma simboliem ir atļauti tukšumi (piemēram, XWiki 1.0 sintaksē, šis teksts nebija * treknrakstā *).
- Noformējumam tiek izmantoti dubulti simboli, līdz ar to ir samazināta iespēja, ka tie tiek izmantoti kļūdaini.
- Iespēja turpināt sākto noformējumu vairākās rindās, kas nebija iespējams 1.0 sintaksē.

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts
--- | --- | --- | ---
Treknraksts | `*treknraksts*` | `**treknraksts**` | treknraksts
Pasvītrojums | `__pasvītrojums___` | `__pasvītrojums__` | pasvītrojums
Slīpraksts | `~~slīpraksts~~` | `//slīpraksts//` | ~slīpraksts~
Nosvītrojums | `--nosvītrojums--` | `--nosvītrojums--` | nosvītrojums
Vienādplatuma | `vienādplatuma` | `##vienādplatuma##` | `vienādplatuma`
Augšraksts | `teksts un <sup>augšraksts</sup>` | `teksts un ^^augšraksts^^` | teksts un augšraksts
Apakšraksts | `teksts un <sub>apakšraksts</sub>` | `teksts un ,,apakšraksts,,` | teksts un apakšraksts

# Horizontāla līnija

2.0 sintaksē 4 vai vairāk mīnusa zīmes.
1.0 sintaksē ir nepieciešamas tieši 4 mīnusa zīmes.

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts
--- | --- | --- | ---
Vienkārša horizontāla līnija | `----` | `----` |
Horizontāla līnija ar parametriem | <hr style="color:blue"/> |
    (% style="color:blue" %)
    ----

# Saraksti

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts
--- | --- | --- | ---
Aizzīmēts saraksts |
    * punkts 1
    ** punkts 2
    *** punkts 3
    * punkts 4
    * punkts 1
    ** punkts 2
    *** punkts 3
    * punkts 4
| punkts 1 punkts 2 punkts 3 punkts 4
Numurēts saraksts |
    1. punkts 1
    11. punkts 2
    111. punkts 3
    1. punkts 4
    1. punkts 1
    11. punkts 2
    111. punkts 3
    1. punkts 4
| punkts 1 punkts 2 punkts 3 punkts 4
Jaukti saraksti |
    1. punkts 1
    1*. punkts 2
    1*. punkts 3
    1. punkts 4
    1. punkts 1
    1*. punkts 2
    1*. punkts 3
    1. punkts 4
| punkts 1 punkts 2 punkts 3 punkts 4
Saraksts ar kvadrātiem |
    - punkts 1
    - punkts 2
    (% style="list-style-type: square" %)
    * punkts 1
    * punkts 2
| punkts 1 punkts 2
Saraksts ar aplīšiem |
    <ul style="list-style-type: disc">
    <li>punkts 1</li>
    <li>punkts 2</li>
    </ul>
    (% style="list-style-type: disc" %)
    * punkts 1
    * punkts 2
| punkts 1 punkts 2
Saraksts ar mazajiem burtiem |
    a. punkts 1
    a. punkts 2
    (% style="list-style-type: lower-alpha" %)
    * punkts 1
    * punkts 2
| punkts 1 punkts 2
Saraksts ar lielajiem burtiem |
    A. punkts 1
    A. punkts 2
    (% style="list-style-type: upper-alpha" %)
    * punkts 1
    * punkts 2
| punkts 1 punkts 2
Saraksts ar maziem romiešu cipariem |
    i. punkts 1
    i. punkts 2
    (% style="list-style-type: lower-roman" %)
    * punkts 1
    * punkts 2
| punkts 1 punkts 2
Saraksts ar lieliem romiešu cipariem |
    I. punkts 1
    I. punkts 2
    (% style="list-style-type: upper-roman" %)
    * punkts 1
    * punkts 2
| punkts 1 punkts 2
Saraksts ar maziem grieķu burtiem |
    g. punkts 1
    g. punkts 2
    (% style="list-style-type: lower-greek" %)
    * punkts 1
    * punkts 2
| punkts 1 punkts 2

# Definīciju saraksts

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts
--- | --- | --- | ---
Parasta definīcija |
    <dl>
    <dt>termins</dt>
    <dd>definīcija</dd>
    </dl>
    ; termins
    : definīcija
| termins definīcija
Iegultas definīcijas |
    <dl>
    <dt>1. termins</dt>
    <dd>1. definīcija
    <dl>
    <dt>2. termins</dt>
    <dd>2. definīcija</dd>
    </dl>
    </dd>
    </dl>
    ; 1. termins
    : 1. definīcija
    :; 2. termins
    :: 2. definīcija
| 1. termins 1. definīcija 2. termins 2. definīcija
Definīcija ar parametriem |
    <dl style="color:blue">
    <dt>termins</dt>
    <dd>definīcija</dd>
    </dl>
    (% style="color:blue" %)
    ; termins
    : definīcija
| termins definīcija

# Pārnesumi jaunā rindā

Pārnesumu jaunā rindā veido ar jaunas rindas simbolu (Enter taustiņu), rindas aplaušanu ievada ar kontroles simboliem.

XWiki 2.0 sintaksē pārnesumi jaunā rindā tiek ņemti vērā, bet XWiki 1.0 sintaksē tie netiek ņemti vērā.

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts XWiki 1.0 sintaksē | Rezultāts XWiki 2.0 sintaksē
--- | --- | --- | --- | ---
Rindas aplaušana | `Rinda\\Jauna rinda` | `Rinda\\Jauna rinda` | Rinda Jauna rinda | Rinda Jauna rinda
Rindas pārnesums | Rinda Jauna rinda | Rinda Jauna rinda | Rinda Jauna rinda | Rinda Jauna rinda

# Saites

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts XWiki 1.0 sintaksē | Rezultāts XWiki 2.0 sintaksē
--- | --- | --- | --- | ---
Saite uz lapu tekošajā vietā | `[WebHome]` | `[[WebHome]]` | Web Home | WebHome
Saite ar nosaukumu | `[nosaukums>WebHome]` | `[[nosaukums>>WebHome]]` | nosaukums | nosaukums
Saite uz lapu norādītā vietā | `[Main.WebHome]` | `[[Main.WebHome]]` | Web Home | WebHome
Saite uz subviki | `[subwiki:Main.WebHome]` | `[[subwiki:Main.WebHome]]` | Web Home | WebHome
Saite, kas atveras jaunā lapā | `[nosaukums>WebHome>_blank]` | `[[nosaukums>>WebHome||rel="__blank"]]` | nosaukums | nosaukums
Saite uz URL atklātā tekstā | `Šis ir URL: http://xwiki.org` | `Šis ir URL: http://xwiki.org` | Šis ir URL: http://xwiki.org | Šis ir URL: http://xwiki.org
Saite uz URL | `[http://xwiki.org]` | `[[http://xwiki.org]]` | http://xwiki.org | http://xwiki.org
Saite uz URL ar nosaukumu | `[XWiki>http://xwiki.org]` | `[[XWiki>>http://xwiki.org]]` | XWiki | XWiki
Saite uz e-pastu | `[janis@test.lv>mailto:janis@test.lv]` | `[[janis@test.lv>>mailto:janis@test.lv]]` | janis@test.lv | janis@test.lv
Saite ar attēlu | `<a href="$xwiki.getURL("Vieta1.Lapa1")">{image:attels.png|document=Vieta2.Lapa2}</a>` |
    [[image:Vieta2.Lapa2@attels.png>>Vieta1.Lapa1]]
Saišu nosaukumos ir atļauta viki sintakse |  |
Saite uz pielikumu | Skatīt papildu informāciju par Attach makrosu. `{attach:pielikums|file=attels.png`} | `[[pielikums>>attach:attels.png]]` | pielikums | pielikums

## XWiki 1.0 saišu sintakse

Pilnais saites formāts ir: `(nosaukums[|&gt;])+(saite)(@citaVikiAliase)+([|&gt;]mērķis)+`

- `nosaukums`: neobligāts saites nosaukums, kas tiek parādīts lietotājam gala tekstā, piemēram, "Mana lapa".
- `saite`: Saite, kas tiek norādīta sekojošā veidā: `(virtuālāVikiAliase+(vieta.)+(reference)(?pieprasījums)+(#enkurs)+`
- Ņemiet vērā, ka `saite` vai `nosaukums` ir jānorāda obligāti.
  - `virtuālāVikiAliase`: neobligāts virtuālā viki nosaukums (ja tiek izmantoti virtuālie viki). Saite norādīs uz norādīto virtuālo viki, piemēram, "mansviki".
  - `vieta`: Neobligāts viki vietas nosaukums. Ja vietu nenorāda, tiek izmantota tekošā vieta. Piemērs: "Main".
  - `reference`: Saites reference. Tā var būt URI formā ``protokols:ceļš`` (piemēram: `"http://xwiki.org"`, `"mailto:john@smith.com"`) vai arī viki lapas nosaukums(piemēram: "WebHome").
  - `pieprasījums`: Neobligāts vietrāža (URL) pieprasījums aiz jautājuma zīmes. Piemēram: `"?parametrs_1=5&amp;parametrs_2=Sveiki"`.
  - `enkurs`: Neobligāts vietas nosaukums mērķa lapā (enkurs). Ņemiet vērā, ka XWiki automatiski izveido enkurus priekš virsrakstiem. Piemēram: "TableOfContentAnchor".
- `citaVikiAliase`: Neobligāta cita viki aliase, kas definēta InterWiki sarakstā (skatiet Administratora rokasgrāmatu). Piemēram: "vikipēdija"
- `mērķis`: Neobligāts HTML `mērķa` atribūts ko izmanto HTML saites `a` elementā. Šo parametru izmanto, apstrādājot saiti. Pēc noklusēšanas to atver tekošajā logā. Piemēri: "_self", "_blank"

## XWiki 2.0 saišu sintakse

Pilnais saites formāts ir: `(nosaukums>>)?(saite)(||parametri)*`

- `nosaukums`: saites nosaukums. Var saturēt viki sintaksi
- `saite`: saites mērķis, t.i. vieta, kas tiks atvērta, kad uz saites uzklikšķina. Tās sintakse ir līdzīga XWiki 1.0 sintaksei, un tā var būt arī norāde uz `mailto:` un `attach:`, lai attiecīgi norādītu uz e-pasta adresi vai lapas pielikumu.
- `parametri`: Neobligāts vietrāža (URL) pieprasījums aiz jautājuma zīmes. Piemēram: `"parametrs_1=5&amp;parametrs_2=Sveiki"`.

# Tabulas

Viki tabulas ļauj vienkāršā veidā attēlot saturu tabulas formā. Tiek atbalstīti arī tabulu parametri, row or cell in XWiki 2.0 sintakse.

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts
--- | --- | --- | ---
Parasta tabula | `((( {table} 1. Virsraksts | 2. Virsraksts 1. vārds | 2. vārds {table} )))` |
    |=1. Virsraksts|=2. Virsraksts
    |1. vārds|2. vārds
1. Virsraksts | 2. Virsraksts
--- | ---
1. vārds | 2. vārds
Tabula ar parametriem |
    <table style="background-color:red;align:center">
    <tbody>
    <tr>
    <td>1. Virsraksts</td>
    <td style="background-color:yellow">2. Virsraksts</td>
    </tr>
    <tr>
    <td>1. vārds</td>
    <td>2. vārds</td>
    </tr>
    </tbody>
    </table>
    (% style="background-color:red;align=center" %)
    |=1. Virsraksts|=(% style="background-color:yellow" %)2. Virsraksts
    |1. vārds|2. vārds
1. Virsraksts | 2. Virsraksts
--- | ---
1. vārds | 2. vārds
Filtrējama un kārtojama tabula |
    $xwiki.ssfx.use("js/xwiki/table/table.css")
    $xwiki.jsfx.use("js/xwiki/table/tablefilterNsort.js", true)
    <table id="tableid" class="grid sortable filterable doOddEven">
    <tr class="sortHeader">
    <th>1. virsraksts</th>
    <th>2. virsraksts</th>
    </tr>
    <tr>
    <td>Šūna 11</td>
    <td>Šūna 12</td>
    </tr>
    <tr>
    <td>Šūna 21</td>
    <td>Šūna 22</td>
    </tr>
    </table>
    {{velocity}}
    $xwiki.ssfx.use("js/xwiki/table/table.css")
    $xwiki.jsfx.use("js/xwiki/table/tablefilterNsort.js", true)
    {{/velocity}}

    {{html}}
    <table id="tableid" class="grid sortable filterable doOddEven">
    <tr class="sortHeader">
    <th>1. virsraksts</th>
    <th>2. virsraksts</th>
    </tr>
    <tr>
    <td>Šūna 11</td>
    <td>Šūna 12</td>
    </tr>
    <tr>
    <td>Šūna 21</td>
    <td>Šūna 22</td>
    </tr>
    </table>
    {{/html}}
1. virsraksts | 2. virsraksts
--- | ---
Šūna 11 | Šūna 12
Šūna 21 | Šūna 22

# Attēli

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts
--- | --- | --- | ---
Attēls no pielikuma tekošajā lapā | Papildu informācijai skatīt Image makrosa aprakstu. `{image:attels.png`} | `image:attels.png` |
Attēls no pielikuma citā lapā | `{image:attels.png|document=Vieta.Lapa`} | `image:Vieta.Lapa@attels.png` |
Attēls ar parametriem | `{image:attels.png|width=25|height=25`} | `[[image:attels.png||width="25" height="25"]]` |
Attēls ar URL atrašanās vietuImages located at URL | `http://some/url/attels.png` | `image:http://some/url/attels.png` |

# Precīza teksta kopija

Precīza teksta kopijas iezīme ļauj attēlot tekstu tieši tādu, kāds tas ir ievadīts (citiem vārdiem sakot, šim tekstam netiek izpildīta viki sintakse).

XWiki 1.0 sintaksē pre makross novērš tikai viki un Radeox makrosu izpildi, tomēr HTML kods un Groovy vai Velocity skripti tiek izpildīti.

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts XWiki 1.0 sintaksē | Rezultāts XWiki 2.0 sintaksē
--- | --- | --- | --- | ---
Precīzi attēlots teksts rindā | `Teksts, kam {pre}*[netiek izpildīta]*{/pre} sintakse` | `Teksts, kam {{{*[netiek izpildīta]*}}} sintakse` | Teksts, kam `*[netiek izpildīta]*` sintakse | Teksts, kam `*[netiek izpildīta]*` sintakse
Precīzi attēlots teksts rāmī |
    {pre}
    Daudzu rindu
    *precīzi*
    attēlots teksts
    {/pre}
Precīczu teksta kpoju var attēlot, arī izmantojot code makrosu, bet tas uzreiz pēc noklusējuma tekstu attēlo rāmī. |
    {{{
    Daudzu rindu
    *precīzi*
    attēlots teksts
    }}}
    Daudzu rindu
    *precīzi*
    attēlots teksts
    Daudzu rindu
    *precīzi*
    attēlots teksts

# Citāti

Citāti ļauj ievietot īpaši noformētus citātus (teksta kopijas, uz ko atsaukties).

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts
--- | --- | --- | ---
Vienkāršs citāts | <blockquote><p>Līzbete teica "pats sevi zārkā neredzēs"</p></blockquote> Paulīne teica "tu saki?" |
    > Līzbete teica "pats sevi zārkā neredzēs"
    Paulīne teica "tu saki?"
| Līzbete teica "pats sevi zārkā neredzēs" Paulīne teica "tu saki?"
Nested quotes | <blockquote><p>Līzbete teica "pats sevi zārkā neredzēs"</p> <blockquote><p>Paulīne teica "tu saki?"</p></blockquote> </blockquote> tā lūk |
    > Līzbete teica "pats sevi zārkā neredzēs"
    >> Paulīne teica "tu saki?"
    tā lūk
| Līzbete teica "pats sevi zārkā neredzēs" Paulīne teica "tu saki?" tā lūk

# Grupas

Grupas var izmantot, lai ievietotu citu dokumentu iekļautu tekošajā dokumentā. Piemēram, grupas ļauj iekļaut sarežģītus teksta elementus tabulas šūnā vai aizzīmēta saraksta ierakstā. Grupas atdala ar sekojošiem atdalītājiem: ``(((...)))``. Vienā grupā var ievietot citu grupu un grupu iekļaušanas dziļums nav limitēts.

XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts
--- | --- | ---
XWiki 1.0 sintaksē šāda iespēja nepastāv. Lai iegūtu sarežģītu iegultu tekstu, jāizmanto HTML iespējas. |
    |=1. Virsraksts|=2. Virsraksts|=3. Virsraksts
    |1. šūna|(((
    = Iegults dokuments

    Iegulta teksta rindkopa.

    * saraksta 1. punkts
    * saraksta 2. punkts
    ** saraksta 1. apakšpunkts
    ** saraksta 2. apakšpunkts
    ))) | 3. šūna

    Nākošā rindkopa augšējā līmeņa dokumentā
1. Virsraksts | 2. Virsraksts | 3. Virsraksts
--- | --- | ---
1. šūna | # Iegults dokuments Iegulta teksta rindkopa. saraksta 1. punkts saraksta 2. punkts saraksta 1. apakšpunkts saraksta 2. apakšpunkts | 3. šūna
Nākošā rindkopa augšējā līmeņa dokumentā

# Rakstzīmju ekranēšana

Viki tekstā iespējams atcelt (ekranēt) atsevišķas rakstzīmes, kuras normālā gadījumā tiek uzskatītas par kontroles simboliem, kas pārveido teksta stilu, izveido saiti u.tml.

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts XWiki 1.0 sintaksē | Rezultāts XWiki 2.0 sintaksē
--- | --- | --- | --- | ---
Atcelt sekojošās rakstzīmes darbību | `Sekojošā nav \[saite\]` Lai parādītu \ rakstzīmi, to ievada kā HTML izņēmuma rakstzīmju virkni: &#92; |
    Sekojošā nav ~[~[saite~]~]
Lai parādītu ~ rakstzīmi, to ievada 2 reizes kā ~~ | `Sekojošā nav [saite]` | `Sekojošā nav [[saite]]`

# Makrosi

XWiki 1.0 sintaksē var iekļaut divu veidu makrosus (izpildāmas komandas):

- Velocity makrosus (izsauc ar komandu `#makrosa_nosaukums(parametrs1 … parametrsN)`)
- Radeox makrosus (izsauc ar komandu `{makrosa_nosaukums:parametrs1=vērtība1|...|parametrsN=vērtībaN}`)

Arī XWiki 2.0 sintaksē var iekļaut divu veidu makrosus:

- Velocity makrosus (izsauc ar komandu `#makrosa_nosaukums(parametrs1 … parametrsN)`)
- XWiki macros (called using the ``{{makrosa_nosaukums parametrs1="vērtība1" … parametrsN="vērtībaN"`}}`)

XWiki 2.0 sintaksē nevar izmantot Radeox makrosus, tāpēc tie ir pārrakstīti kā XWiki makrosi.
Papildu informācijai par pieejamajiem makrosiem skatiet makrosu dokumentāciju.

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse
--- | --- | ---
Velocity makross |
    #info("Kāds teksts")
    {{velocity}}{{html}}
    #info("Kāds teksts")
    {{/html}}{{/velocity}}
`#info` makross tiek iekļauts html makrosā, jo info makross atgriež HTML saturu. Sākot ar Xwiki 2.0 versiju, lai parāditu ziņojuma rāmi, ieteicams izmantot message makrosu.
Radeox makross/XWiki makross |
    {code:java}
    java kods
    {code}
    {{code language="java"}}
    java kods
    {{/code}}

# HTML

XWiki 2.0 sintaksē HTML vai XHTML elementi ir jāievada, iekļauti html makrosā, bet XWiki 1.0 sintaksē HTML elementus var iekļaut tieši viki dokumenta tekstā.

XWiki 1.0 sintakse | XWiki 2.0 sintakse | Rezultāts
--- | --- | ---
<b>bold</b> | `{{html}}<b>treknraksts</b>{{/html`}} | treknraksts

XWiki 2.0 sintakse pēc noklusēšanas html makrosā netiek izpildīta viki sintakse (un netiek pildīti arī citi makrosi, jo tie arī ir viki sintakses elementi). Lai to mainītu, html makrosam ir jānorāda papildu parametrs: `{{html wiki="true"`}}.

# Velocity/Groovy skripti

XWiki 1.0 sintaksē Velocity skriptus varēja izsaukt jebkurā viki dokumenta vietā. Tā rezultātā gadījās, ka lietotāji negribot ievadīja tekstu, kas tika izpildīts kā Velocity skripts. Tas arī palēnināja lapu parādīšanu pat tajos gadījumos, ja lapā nebija Velocity skriptu, un radīja arī citas tehniskas problēmas. Tāpēc XWiki 2.0 sintaksē Velocity skripti ir jāiekļauj, izmantojot tieši norādītu `velocity` makrosu. Tieši tas pats attiecas arī uz Groovy skriptiem.

Piemērs | XWiki 1.0 sintakse | XWiki 2.0 sintakse
--- | --- | ---
Velocity skripts |
    #set ($mainigais = "vērtība")
    {{velocity}}
    #set ($mainigais = "vērtība")
    {{/velocity}}
Groovy skripts |
    <%
    def mainigais = "vērtība"
    %>
    {{groovy}}
    def mainigais = "vērtība"
    {{/groovy}}

# Parametri

XWiki 2.0 sintaksē iespējams norādīt parametrus, dažādiem sintakses elementiem un teksta daļām. Piemēram, ar parametriem var mainīt teksta stilu (noformējumu). Iespējams norādīt jebkuru parametru nosaukuma un vērtības pāri. Šie parametri un to vērtības tiek nodoti XHTML dzinējam, kas no tiem izveidos atbilstošus XHTML atribūtus, kas, ievērojot norādīto stilu, tiks ņemti vērā pārlūkprogrammā. XWiki 1.0 sintaksē īpaša parametru norādīšanas veida nebija, un priekš tam bija jāizmanto tieši norādīts HTML saturs.

XWiki 1.0 sintakse | XWiki 2.0 sintakse | Izveidotais XHTML
--- | --- | ---
    <h1 class="manaKlase" style="mansStils" id="mansId">header</h1>
    (% class="manaKlase" style="mansStils" id="mansId" %)
    = header =
    <h1 class="manaKlase" style="mansStils" id="mansId">header</h1>

# Citas sintakses

Sākot ar XWiki Enterprise 1.6 ir atbalstītas arī sekojošas sintakses:

- JSPWiki
- Media Wiki
- Confluence
- TWiki
- Creole 1.0
- XHTML 1.0

Šīs sintakses pilnībā vēl netiek atbalstītas. Piemēram, pilnībā nestrādā hipersaites. Mums arī ir nepieciešams vienoties, vai mēs vēlamies šajās sintaksēs atbalstīt Xwiki specifiskās lietas, piemēram, saiti uz citu subviki.
Tagi:
Izveidojis Administrator 2008/02/20 11:36
Uz lv tulkojis Administrator 2008/02/20 11:36

- Komentāri (0)
- Anotācijas (0)
- Pielikumi (1)
- Vēsture
- Informācija

Copyright 2004-2026 XWiki
4.0-milestone-1