La syntaxe minimale consiste simplement à ajouter deux lignes autour de vos informations et à saisir votre saut de colonnes.

<columns 100% 50% - ->

First column text (50% width).

<newcolumn>

Second column text.

<newcolumn>

Third column text.

</columns>

Le premier attribut de la balise <columns> est la largeur de l'ensemble de colonnes. Les attributs suivants concernent les colonnes. Si vous ne souhaitez pas spécifier de valeur pour la largeur du tableau ou de la colonne, utilisez plutôt « - ».

Les sauts de colonne sont spécifiés avec la balise <newcolumn>, qui peut également prendre des attributs facultatifs décrits ci-dessous. Dans le plug-in d'origine, les sauts étaient spécifiés avec ~~NEWCOL~~ et pour des raisons de compatibilité, il est toujours possible de configurer le plug-in pour utiliser cette balise, mais certaines des nouvelles fonctionnalités seront désactivées.

Outre la largeur, chaque colonne peut avoir un certain nombre d'attributs supplémentaires qui spécifient le formatage du contenu de la colonne. Ces attributs doivent être spécifiés devant la largeur de la colonne :

<columns 100% first column attributes 50% second column attributes ->

First column text.

<newcolumn>

Second column text.

</columns>

Avec ces attributs supplémentaires, la déclaration des colonnes devient de plus en plus encombrée. Pour éviter cela, vous pouvez spécifier les attributs de colonne dans la balise <newcolumn>. Dans ce cas, l'ordre des attributs et la largeur de la colonne n'ont pas d'importance :

<columns 100% first column attributes 50%>

First column text.

<newcolumn second column 25% attributes>

Second column text.

<newcolumn>

Third column text.

</columns>

Par défaut, le texte dans les colonnes est justifié, mais l'alignement de chaque colonne peut être spécifié explicitement. Il existe plusieurs façons de procéder. La plus simple consiste à ajouter des astérisques de chaque côté de la spécification de largeur de colonne. L'astérisque indique le côté non justifié du bloc de texte. Pour obtenir un alignement à gauche, ajoutez donc l'astérisque sur le côté droit.

<columns 100% 25% 25%* *-* *->

First column with justified text.

<newcolumn>

Second column is aligned on the left side.

<newcolumn>

Third column is center-aligned.

<newcolumn>

Fourth column is aligned on the right side.

</columns>

L'alignement peut également être spécifié avec des attributs séparés. Cette approche permet de définir à la fois l'alignement horizontal et l'alignement vertical. Il existe quatre attributs pour l'alignement horizontal (gauche, centre, droite et justifier) ​​et trois pour l'alignement vertical (haut, milieu et bas). Il peut y avoir plusieurs attributs d'alignement par colonne :

<columns 100% left 50% right bottom ->

First column is aligned on the left side.

<newcolumn>

La deuxième colonne est alignée sur le coin inférieur droit.

</columns>

Tous les attributs peuvent être abrégés jusqu'à la première lettre, les attributs à lettre unique peuvent être fusionnés ensemble :

<columns 100% l 50%>
La première colonne est alignée sur le côté gauche.

<newcolumn rb>

La deuxième colonne est alignée sur le coin inférieur droit.

<newcolumn m *-*>

La syntaxe d'alignement simple est toujours prise en charge.
Le contenu de la troisième colonne est centré dans les deux sens.

</columns>

Les titres dans les ensembles de colonnes sont spécifiés à l'aide de la syntaxe standard DokuWiki :

<columns 100% 50% ->

===== Titre =====

Contenu de la première colonne.

</columns>

Contenu de la deuxième colonne.

</code>

Par défaut, le plugin place le contenu dans une colonne sans spécifier explicitement le niveau de section. Cela fonctionne bien lorsque l'ensemble de colonnes appartient à une seule section, mais peut produire des résultats inattendus lorsque les titres sont utilisés dans l'ensemble :

====== Titre de niveau 1 ======

<columns 100% 50% ->

Contenu implicite de niveau 1.

===== Titre 1 niveau 2 =====

Contenu de niveau 2.

<newcolumn>

Contenu implicite de niveau 1 qui devrait figurer dans la section de niveau 2.

===== Titre 2 de niveau 2 =====

Contenu de niveau 2.

</columns>

Vous pouvez forcer le début de la deuxième colonne à être au niveau 2 en spécifiant l'attribut continue (ou le raccourci ...) :

====== Titre de niveau 1 ======

<columns 100% 50% ->
Contenu implicite de niveau 1.

===== Titre 1 niveau 2 =====
Contenu de niveau 2.

<newcolumn continue>


Contenu de niveau 2.

===== Titre 2 de niveau 2 =====

Contenu de niveau 2.

</columns>