XWiki Syntaxes

Senast ändrad av Administrator den 4 april 2010 kl 18:42

Med början på XWiki enterprise version 1.7 och senare har en ny wikisyntax, kallad XWiki syntax v2.0, introducerats som efterföljare till XWiki syntax v1.0.  De huvudsakliga anledningarna för den nya syntaxen är:

  • Fixa begränsningarna och tvetydigheterna som finns i XWiki 1.0 syntaxen (som byggde både på Radeox - den underliggande renderingsmotorn - och TWiki).
    • Symbolvalen var inte bra.  Exempelvis användes en asterisk för att ange fetstil.  Detta orsakade problem då användare matade in text som innehöll asterisker eftersom texten felaktigt antogs vara fetstil.  Således används åtminstone dubbla symbolr överallt i wikisyntaxen.
    • Tvetydigheter fanns exempelvis då en rad inleddes med en asterisk.  Var det då fetstil eller en punktlista?  Detta var nödvändigt att lösa för att möjligjöra en deterministisk WYSIWYG-editor.
  • För att närma sig Creole 1.0 syntaxen vilken håller på att bli standard för wikisyntax.  Sammanslutningen bakom Creole har dessutom nogrannt analyserat alla existerande wikisyntaxer innan de valt symboler.  Symbolvalen är därför väldigt bra. 

Utöver syntaxändringarna har vi också bytt ut den underliggande renderingsmotorn (vilken tidigare var Radeox) till förmån för vår egen motor som bygger på Wikimodel och Doxia (och möjligen andra i framtiden).  Detta låter oss tillhandahålla andra syntaxer i wikin: MediaWiki, Confluence, JSPWiki, Creole, TWiki m.fl.

Anmärkningar

XWiki syntax v2.0 rättar bl.a. de fel och tvetydigheter som exemplifieras i tabellen nedan.

BeskrivningExempel på ogiltig eller tvetydig syntaxFixad XWiki syntax 2.0
Ej avslutad stil**fetstil**fetstil**
Två fristående element som ej särskiljs av två nyradstecken| tabellcell
* listelement
| tabellcell

* listelement
Två fristående element ej separerade av två nyradsteckenstycke
----
stycke
stycke

----

stycke
Nyradstecken i början av dokumentet<nyradstecken i början av dokumentet>
stycke
stycke
Ej avslutad rubriksyntax=== rubrik=== rubrik ===

Stycken

Stycken är textelement som separeras av två eller flera nyradstecken.

IconInformation

I XWiki syntax 2.0 nyradstecken är signifikanta, vilket inte är fallet i XWiki syntax 1.0 och i Creole.

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat XWiki syntax 1.0Resultat XWiki syntax 2.0
StyckeThis is a paragraphDetta är ett styckeDetta är ett styckeDetta är ett stycke
Flerradigt styckeStycke med\\
flera rader
Stycke med
flera rader
Stycke med
flera rader
Stycke med
flera rader
Två styckenStycke ett

Stycke två
Stycke ett

Stycke två
Stycke ett

Stycke två
Stycke ett

Stycke två
Parametriserade stycken<p style="text-align:center;color:blue">Centrerat stycke med blå text</p>(% style="text-align:center;color:blue" %)
Centrerat stycke med blå text

Centrerat stycke med blå text

Centrerat stycke med blå text

Rubriker

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat
Standardrubriker

1 nivå 1
1.1 nivå 2
1.1.1 nivå 3
1.1.1.1 nivå 4
1.1.1.1.1 nivå 5
1.1.1.1.1.1 nivå 6

= nivå 1 = 
== nivå 2 ==
=== nivå 3 ===
==== nivå 4 ====
===== nivå 5 =====
====== nivå 6 ======

nivå 1

 

nivå 2

nivå 3

nivå 4

nivå 5
nivå 6
Parametriserade rubriker<h1><span style="color:blue">rubrik</span></h1>(% style="color:blue" %)
= rubrik =

rubrik

Rubriker med wikisyntax1.1.1 Rubrik med *fetstil*=== Rubrik med **fetstil** ===

Rubrik med fetstil

Textformatering

IconInformation

Nytt i XWiki syntax 2.0 jämfört med XWiki syntax 1.0:

  • Blanktecken är tillåtna omedelbart efter syntaxsymbolerna (i XWiki syntax 1.0 var exempelvis * detta inte fetstil *).
  • Användning av symboldubblering där det var enkla symboler i XWiki syntax 1.0 för att minska risken att användarna av misstag lägger in textformatering.
  • Möjlighet att låta formatering sträcka sig över flera rader.
FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat
Fetstil*fetstil***fetstil**fetstil
Understruken__understruken_____understruken__understruken
Kursiv~~kursiv~~//kursiv//kursiv
Genomstruken--genomstruken----genomstruken--genomstruken
Fastbredd<tt>fastbredd</tt>##fastbredd##fastbredd
Upphöjdlite <sup>upphöjd text</sup>lite ^^upphöjd text^^lite upphöjd text
Nedsänktlite <sub>nedsänkt text</sub>lite ,,nedsänkt text,,lite nedsänkt text

Horisontell linje

IconInformationEn linje består av minst fyra bindestreck.
IconInformationNotera skillnaden mot Creole där exakt fyra bindestreck krävs.

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat
Horisontell linje  ----  ---- 

Parametriserad horisontell linje  <hr style="color:blue"/> 
(% style="color:blue" %)
----

Listor

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat
Punktlista
* element 1
** element 2
*** element 3
* element 4
* element 1
** element 2
*** element 3
* element 4
  • element 1
    • element 2
      • element 3
  • element 4
Numrerad lista
1. element 1
11. element 2
111. element 3
1. element 4
1. element 1
11. element 2
111. element 3
1. element 4
  1. element 1
    1. element 2
      1. element 3
  2. element 4
Blandad lista
1. element 1
1*. element 2
1*. element 3
1. element 4
1. element 1
1*. element 2
1*. element 3
1. element 4
  1. element 1
    • element 2
    • element 3
  2. element 4
Kvadratmarkerad lista
- element 1
- element 2
(% style="list-style-type: square" %)
* element 1
* element 2
  • element 1
  • element 2
Diskmarkerad lista

<ul style="list-style-type: disc">
  <li>element1</li>
  <li>element2</li>
</ul>

(% style="list-style-type: disc" %)
* element 1
* element 2
  • element 1
  • element 2
Alfabetisk lista av gemener
a. element 1
a. element 2
(% style="list-style-type: lower-alpha" %)
* element1
* element2
  • element1
  • element2
Alfabetisk lista av versaler
A. element 1
A. element 2
(% style="list-style-type: upper-alpha" %)
* element1
* element2
  • element1
  • element2
Romerska siffror av gemener
i. element 1
i. element 2
(% style="list-style-type: lower-roman" %)
* element1
* element2
  • element1
  • element2
Romerska siffror av versaler
I. element 1
I. element 2
(% style="list-style-type: upper-roman" %)
* element1
* element2
  • element1
  • element2
Grekiska gemener
g. element 1
g. element 2
(% style="list-style-type: lower-greek" %)
* element1
* element2
  • element1
  • element2
Grekiska versaler
G. element 1
G. element 2
(% style="list-style-type: upper-greek" %)
* element1
* element2
  • element1
  • element2
Hiragana
h. element 1
h. element 2
(% style="list-style-type: hiragana" %)
* element1
* element2
  • element1
  • element2
Hiragana iroha
H. element 1
H. element 2
(% style="list-style-type: hiragana-iroha" %)
* element1
* element2
  • element1
  • element2
Katakana
k. element 1
k. element 2
(% style="list-style-type: katakana" %)
* element1
* element2
  • element1
  • element2
Katakana iroha
K. element 1
K. element 2
(% style="list-style-type: katakana-iroha" %)
* element1
* element2
  • element1
  • element2
Armenisk lista
<ul style="list-style-type: armenian">
  <li>element1</li>
  <li>element2</li>
</ul>
(% style="list-style-type: armenian" %)
* element1
* element2
  • element1
  • element2
Hebreisk lista
j. element1
j. element2
(% style="list-style-type: hebrew" %)
* element1
* element2
  • element1
  • element2
Georgisk lista
<ul style="list-style-type: georgian">
  <li>element1</li>
  <li>element2</li>
</ul>
(% style="list-style-type: georgian" %)
* element1
* element2
  • element1
  • element2
CJK ideografisk lista
<ul style="list-style-type: cjk-ideographic">
  <li>element1</li>
  <li>element2</li>
</ul>
(% style="list-style-type: cjk-ideographic" %)
* element1
* element2
  • element1
  • element2

Definitionslistor

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat
Vanlig definition
<dl>
  <dt>term</dt>
  <dd>definition</dd>
</dl>
; term
: definition
term
definition
Nästlade definitioner
<dl>
  <dt>term1</dt>
  <dd>definition1
    <dl>
      <dt>term2</dt>
      <dd>definition2</dd>
    </dl>
  </dd>
</dl>
; term1
: definition1
:; term2
:: definition2
term1
definition1
term2
definition2
Parametriserade definitioner
<dl style="color:blue">
  <dt>term</dt>
  <dd>definition</dd>
</dl>
(% style="color:blue" %)
; term
: definition
term
definition

Radbrytning

En radbrytning tvingar fram ny rad och kan stå var som helst i en text.

IconInformation

I XWiki syntax 2.0 nyradstecken är signifikanta, vilket inte är fallet i XWiki syntax 1.0 och i Creole-syntax.

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat med XWiki syntax 1.0Resultat med XWiki syntax 2.0
RadbrytningRad\\Ny radRad\\Ny radRad
Ny rad
Rad
Ny rad
Ny radRad
Ny rad
Rad
Ny rad
Rad Ny radRad
Ny rad

Länkar

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat med XWiki syntax 1.0Resultat med XWiki syntax 2.0
Länk till sida i aktuellt rum [WebHome]  [[WebHome]]  Web Home  XWiki
Länk med etikett [etikett>WebHome]  [[etikett>>WebHome]]  etikett  etikett
Länk till en sida i specificerat rum  [Main.WebHome]  [[Main.WebHome]]  Web Home  Main
Länk till underwiki  [underwiki:Main.WebHome]  [[underwiki:Main.WebHome]]  Web Home  Main
Länk som öppnas i nytt fönster  [etikett>WebHome>_blank]  [[etikett>>WebHome||rel="__blank"]]  etikett  etikett
Länk till URL direkt i text Detta är en URL: http://xwiki.org  Detta är en URL: http://xwiki.org  Detta är en URL: http://xwiki.org  Detta är en URL: http://xwiki.org
Länk till en url URL  [http://xwiki.org]  [[http://xwiki.org]]  http://xwiki.org  http://xwiki.org
Etiketterad länk till URL [XWiki>http://xwiki.org]  [[XWiki>>http://xwiki.org]]  XWiki  XWiki
Länk till epostadress [epost>mailto:john@smith.net]  [[epost>>mailto:john@smith.net]]  epost  epost
Bildlänk  <a href="$xwiki.getURL("Rum1.Sida1")">{img.png{{{|}}}document=Rum2.Sida2}</a> 

[[image:Rum2.Sida2@img.png>>Rum1.Sida1]]
IconInformationWikisyntax kan användas i länketiketter.

 img.png  img.png
Länk till bilaga 

IconInformationSe Bilagemakrot för detaljer
{attach:text|file=img.png}

 [[text>>attach:img.png]]  text  text

XWiki syntax 1.0 Länkspecifikation

Det fullständiga formatet för en länk är (alias[|>])+(länk)(@interWikiAlias)+([|>]mål)+

  • alias: En sträng som visas som länknamn.  Kan utelämnas.  Exempel: "Min sida".
  • länk: Den fullständiga länkadressen på följande syntax: (virtualWikiAliasemoticon_smile+(rum.)+(adress)(?queryString)+(#ankare)+
  • Notera att antingen länk eller alias måste be specifiseras.
    • virtualWikiAlias: En sträng som anger namnet på en virtuell wiki.  Länken pekar på en sida inuti motsvarade virtuella wiki.  Kan utelämnas.  Exempel: "mywiki".
    • rum: Ett rumsnamn.  Om inget rum anges används aktuellt rum.  Exempel: "Main".
    • reference: Länkreferensen.  Detta kan vara antingen en URI på formen protokoll:sökväg (exempelvis: "http://xwiki.org", "mailto:sven@svensson.se") eller ett namn på en wikisida (exempel: "WebHome").
    • queryString: En query-sträng, vilken kan utelämnas.  Används för att ange parametrar till URLen.  Exempel: "mindata1=5&amp;mindata2=Hej".
    • ankare: Ett fakultativt ankarnamn som pekar på en ankardefinition på sidan som refereras av länken.  I XWiki skapas ankare automatiskt för varje rubrik bestående av bokstaven H (som i engelskans header) följt av rubriknamnet.  De svenska bokstäverna å, ä och ö utelämnas alltid ur ankarnamnet.  Detta gäller även för alla tecken som ej är bokstäver eller siffror, exempelvis blanktecken, punk och komma.  En länk till sektionen XWiki syntax 1.0 Länkspecifikation kan alltså skapas via ankaret "HXWikisyntax10Lnkspecifikation".
  • interWikiAlias: Ett fakultativt Inter-wiki-alias som är definierat i Interwikikartan.  Exempel: "wikipedia"
  • mål: En fakultativ sträng som motstvarar target-attributet för ett A-element i HTML.  Om denna utelämnas öppnas länken i aktuellt fönster eller tabb.  Exempel:  "_self", "_blank".

XWiki syntax 2.0 Länkspecification

Det fullständiga formatet för en länk är (etikett>>)?(länk)(||parametrar)*

  • etikett: länketiketten, vilken får innehålla wikisyntax
  • länk: länkmålet, dvs, dit man kommer då man klickar på länken.  Den har liknande format som XWiki syntax 1.0 och den har också två ytterligare URI-typer: mailto: och attach: vilka kan användas för att länka till epostadress respektive bilaga.
  • parametrar: Parametrar till länken.  Dessa kan utelämnas.

Tabeller

I XWiki syntax är det relativt enkelt att skapa tabeller.  Det går också att ange parametrar för enskilda celler och rader i XWiki syntax 2.0

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat
Standardtabell((( {table} Titel 1 | Titel 2 Ord 1 | Ord 2 {table} )))
|=Titel 1|=Titel 2
|Ord 1|Ord 2
Titel 1Titel 2
Ord 1Ord 2
Parametriserad tabell

<table style="background-color:red;align:center">
  <tbody>
    <tr>
      <td>Titel 1</td>
      <td style="background-color:yellow">Titel 2</td>
    </tr>
    <tr>
      <td>Ord 1</td>
      <td>Ord 2</td>
    </tr>
  </tbody>
</table>

(% style="background-color:red;align=center" %)
|=Titel 1|=(% style="background-color:yellow" %)Titel 2
|Ord 1|Ord 2
Titel 1Titel 2
Ord 1Ord 2
Filtrerbar och sorterbar tabell
$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>Titel1</th>
    <th>Titel2</th>
  </tr>
  <tr>
   <td>Cell11</td>
   <td>Cell12</td>
  </tr>
  <tr>
   <td>Cell21</td>
   <td>Cell22</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>Titel1</th> <th>Titel2</th> </tr> <tr> <td>Cell11</td> <td>Cell12</td> </tr> <tr> <td>Cell21</td> <td>Cell22</td> </tr> </table> {{/html}}

Titel1 Titel2
Cell11 Cell12
Cell21 Cell22

Bilder

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat
Bild från bilaga till aktuell sida

IconInformationSe bildmakrot för detaljer
{image:img.png}

image:img.pngimg.png
Bild från bilaga i annat dokument{image:img.png|document=Rum.Sida}image:Rum.Sida@img.pngimg.png
Bild med parametrar{image:img.png|width=25|height=25}[[image:img.png||width="25" height="25"]]img.png
Bild från URLhttp://some/url/img.pngimage:http://some/url/img.pngimg.png

Ej formaterad text

Det går att ange att text ej skall formateras av wiki syntaxen, dvs, symbolerna för wikisyntax kommer att visas istället för att texten formateras.

IconInformation

I XWiki syntax 1.0 Pre-makrot bevarar endast wiki syntax och Radeox makron.  HTML-kod och Groovy- och Velocity-skript exekveras fortfarande.

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat i XWiki syntax 1.0Resultat i XWiki syntax 2.0
Ej formaterad text inuti formaterad textLite *[ej renderat]* innehållLite {{{<strong>*<a class="wikicreatelink" href="/xwiki/bin/edit/XE/%5Bej+renderat?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">[ej renderat</span><span class="wikicreatelinkqm">?</span></a>]*</strong>}}} innehållLite <strong><a class="wikicreatelink" href="/xwiki/bin/edit/XE/ej+renderat?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">ej renderat</span><span class="wikicreatelinkqm">?</span></a></strong> innehålllite <strong>*<a class="wikicreatelink" href="/xwiki/bin/edit/XE/%5Bej+renderat?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">[ej renderat</span><span class="wikicreatelinkqm">?</span></a>]*</strong> innehåll
Block av ej formaterad text

flerradigt *ej renderat* innehåll
IconInformationMan kan även använda <a class="wikicreatelink" href="/xwiki/bin/edit/XE/%5BKodmakrot%26%2362%3B%26?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">[Kodmakrot>&</span><span class="wikicreatelinkqm">?</span></a>], me det visar sitt inehåll i en box, om inget annat anges.

{{{
flerradigt
<strong>*ej renderat*</strong>
innehåll
}}}
flerradigt
<strong>ej renderat</strong>
innehåll
flerradigt
<strong>*ej renderat*</strong>
innehåll
<p/>

Citering

<p/>

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat
Citat

<blockquote><p>Anna sade detta</p></blockquote>
Jag sade ok

> Anna sade detta
Jag sade ok

 Anna sade detta

Jag sade ok

Nestlade citat

<blockquote><p>Anna sade detta</p>
  <blockquote><p>Lina svarade detta</p></blockquote>
</blockquote>
Jag sade ok

> Anna sade detta
>> Lina svarade detta
Jag sade ok

 Anna sade detta

 Lina svarade detta

Jag sade ok

<p/>

Gruppering

<p/>
Gruppering kan användas för att infoga kompexa element i löpande text. Exempelvis för att infoga ett dokument i löpande text, eller komplexa element inuti listor eller tabellceller.  Gruppering markeras med följande syntaktiska symboler: (((...))).  En gruppering kan innehålla en annan gruppering.<p/>

XWiki syntax 1.0XWiki syntax 2.0Resultat
IconInformationXWiki syntax 1.0 saknar grupperingsmöjligheter.  Man måste använda sig av HTML för att åstadkomma motsvarande resultat.
|=Titel 1|=Titel 2|=Titel 3
|Cell ett|(((
= Inbäddat dokument<p/>
Ett inbäddat stycke<p/>
<ul class="star">
<li>listelement ett</li>
<li>listelement två<ul class="star">
<li>underelement 1</li>
<li>underelement 2</li>
</ul></li>
</ul>
))) | Cell tre<p/>
Fortsättningen på toppnivådokumentet
Titel 1Titel 2Titel 3
Cell ett

Failed to execute the [html] macro. Cause: [When using HTML content inline, you can only use inline HTML content. Block HTML content (such as tables) cannot be displayed. Try leaving an empty line before and after the macro.]. Click on this message for details.
<p/>
Ett inbäddat stycke<p/>
<ul class="star">
<li>listelement ett</li>
<li>listelement två<ul class="star">
<li>underelement 1</li>
<li>underelement 2</li>
</ul></li>
</ul>

 Cell tre<p/>
Fortsättningen på toppnivådokumentet
<p/>

Kontrollsekvenser för wikisymboler

<p/>

FormateringstypXWiki syntax 1.0XWiki syntax 2.0Resultat XWiki syntax 1.0Resultat XWiki syntax 2.0
Kontrollsekvens för enstaka teckenDetta är inte en [länk]

Detta är inte en ~<a class="wikicreatelink" href="/xwiki/bin/edit/XE/%7E%5Bl%C3%A4nk%7E?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">~[länk~</span><span class="wikicreatelinkqm">?</span></a>~]
IconInformationFör att generera ett <em>-tecken avnänd två ~-tecken: ~</em>

Detta är inte en <a class="wikicreatelink" href="/xwiki/bin/edit/XE/l%C3%A4nk?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">länk</span><span class="wikicreatelinkqm">?</span></a>Detta är inte en <a class="wikicreatelink" href="/xwiki/bin/edit/XE/%5Bl%C3%A4nk?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">[länk</span><span class="wikicreatelinkqm">?</span></a>]<p/>

Makron

<p/>
Det finns två typder av makron i XWiki syntax 1.0:
<ul class="star">
<li>Velocity-makron, vilka anropas med syntaxen #makronamn(parameter1 … parameterN.</li>
<li>Radeox-makron, vilka anropas med syntaxen {makronamn:parameter1=värde1|...|parameterN=värdeN.</li>
</ul>
Det finns även två typer av makron i XWiki syntax 2.0:
<ul class="star">
<li>Velocity-makron, vilka anropas med syntaxen #makronamn(parameter1 … parameterN) inuti XWiki-makrot "velocity".</li>
<li>XWiki-makron, vilka anropas med syntaxen {{makronamn parameter1="värde1" … parameterN="värdeN"}}.</li>
</ul>
IconInformationRadeox-makron kan ej användas i XWiki syntax 2.0 och har därför skrivits om som XWiki-makron.<p/>
IconInformationEn fullständig lista över tillgängliga makron finns på <a class="wikicreatelink" href="/xwiki/bin/edit/XE/%5Bmakroreferenssidan%26%2362%3B%26?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">[makroreferenssidan>&</span><span class="wikicreatelinkqm">?</span></a>].<p/>

FormateringstypXWiki syntax 1.0XWiki syntax 2.0
Velocity-makro
#info("Lite text")

{{velocity}}{{html}} #info("Lite text") {{/html}}{{/velocity}}
IconInformationHTML-makrot måste användas i detta exempel eftersom #info-makrot genererar innehåll på HTML-format.

IconInformation

Med början i XE 2.0 bör man istället använda <a class="wikicreatelink" href="/xwiki/bin/edit/XE/%5Bmedelandemakrot%26%2362%3B%26?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">[medelandemakrot>&</span><span class="wikicreatelinkqm">?</span></a>] för att implementera detta exempel.

Radeox-makron/XWiki-makron
<div class="code"><pre>javakod</pre></div>
{{code language="java"}}
javakod
{{/code}}
<p/>

HTML

<p/>
IconInformationI XWiki syntax 2.0 HTML eller XHTML måste anges inuti HTML-makrot.  I XWiki syntax 1.0 är det möjligt att ange HTML direkt i texten.<p/>

XWiki syntax 1.0XWiki syntax 2.0Resultat
<b>fetstil</b>{{html}}<b>fetstil</b>{{/html}}fetstil<p/>
IconInformationI XWiki syntax 2.0, tolkas wikisyntax även inuti HTML-makrot om inget annat angivits.  Ange {{html wiki="false"}} för att förhindra detta.<p/>

Velocity/Groovy-skript

<p/>
IconInformationIn XWiki syntax 1.0 är det möjligt att ange Velocity-skript var som helst på en wikisida.  Detta medför problem då en användar oavsiktligen matar in Velocity-kod.  Dessutom renderas sidor som ej innehåller Velocity-kod långsammare än nödvändigt.  Det medför även andra tekniska begränsningar.  Således måste Velocity-skript avgränsas med hjälp av velocity-makrot i XWiki syntax 2.0.  Detsamma gäller för Groovy-skript som måste anges med hjälp av groovy-makrot.<p/>

FormateringstypXWiki syntax 1.0XWiki syntax 2.0
Velocity-skript
#set ($var = "något värde")
{{velocity}}
#set ($var = "något värde")
{{/velocity}}
Groovy-skript
<%
def var = "något värde"
%>
{{groovy}}
def var = "något värde"
{{/groovy}}
<p/>

Parametrar

<p/>
Med xWiki syntax 2.0 är det möjligt att ange parametrar till syntaktiska element och textblock.  Detta används exempelvis för att ändra stil på elementen.  Det går att ange nyckel/värde-par så att XHTML-renderaren infogar motsvarande attribut i den underliggande XHTML-representationen av syntaxelementen.  I XWiki syntax 1.0 finns det ingen syntax för att ange parametrar utan XHTML-koden måste matas in direkt såsom illustreras nedan.<p/>

XWiki syntax 1.0XWiki syntax 2.0Genererad XHTML
<h1 class="myClass" style="myStyle" id="myId">rubrik</h1>
(% class="myClass" style="myStyle" id="myId" %)
= rubrik =
<h1 class="myClass" style="myStyle" id="myId">rubrik</h1>
<p/>

Andra syntaxer

<p/>
Följande syntaxer finns implementerade i XWiki enterprise 1.6 och senare:
<ul class="star">
<li><a class="wikicreatelink" href="/xwiki/bin/edit/XE/%5BJSPWiki%26%2362%3B%26?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">[JSPWiki>&</span><span class="wikicreatelinkqm">?</span></a>]</li>
<li><a class="wikicreatelink" href="/xwiki/bin/edit/XE/%5BMediaWiki%26%2362%3B%26?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">[Media Wiki>&</span><span class="wikicreatelinkqm">?</span></a>]</li>
<li><a class="wikicreatelink" href="/xwiki/bin/edit/XE/%5BConfluence%26%2362%3B%26?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">[Confluence>&</span><span class="wikicreatelinkqm">?</span></a>]</li>
<li><a class="wikicreatelink" href="/xwiki/bin/edit/XE/%5BTWiki%26%2362%3B%26?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">[TWiki>&</span><span class="wikicreatelinkqm">?</span></a>]</li>
<li><a class="wikicreatelink" href="/xwiki/bin/edit/%5BCreole+1/0%26%2362%3B%26?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">0>&</span><span class="wikicreatelinkqm">?</span></a>]</li>
<li><a class="wikicreatelink" href="/xwiki/bin/edit/%5BXHTML+1/0%26%2362%3B%26?parent=XE.XEXWikiXWikiSyntax_951530617_content_sv"><span class="wikicreatelinktext">0>&</span><span class="wikicreatelinkqm">?</span></a>]</li>
</ul>
IconWarningImplementationen för dessa syntaxer är ej kompletta ännu.  Länkar fungerar exempelvis inte alltid som förväntat.  Vi måste även bestämma om syntaxerna skall utökas för att stödja XWiki-specifik funktionalitet såsom möjligheten att länka till en annan virtuell wiki.