Syntaxe de mise en forme

DokuWiki supporte un langage de balisage simple, qui tente de rendre les fichiers de données aussi lisibles que possible. Cette page contient toutes les syntaxes possibles que vous pouvez utiliser lors de l'édition des pages. Il suffit de consulter la source de cette page en cliquant sur “Editer cette page”. Si vous voulez essayer quelque chose, il suffit d'utiliser la page playground page. Le balisage plus simple est facilement accessible via quickbuttons, également.

DokuWiki supporte bold, italic, underlined and monospaced des textes de qualité. Bien entendu, vous pouvez combiner tous ces éléments.

DokuWiki supporte **bold**, //italique//, __underlined__ and ''monospaced'' des textes de qualité.
Bien entendu, vous pouvez **__//''combiner''//__** tous ces éléments.

Vous pouvez utiliser _{souscrire à} et ^superscriptégalement.

Vous pouvez utiliser <sub>subscript</sub> et <sup>superscript</sup>également.

Vous pouvez marquer quelque chose comme supprimé de la même manière.

Vous pouvez marquer quelque chose comme <del>supprimé</del> de la même manière.

Les paragraphes sont créés à partir de lignes vierges. Si vous voulez forcer une nouvelle ligne sans paragraphe, vous pouvez utiliser deux barres obliques inverses suivies d'un espace blanc ou de la fin de la ligne.

Voici un texte avec quelques sauts de ligne.
Notez que les deux anti-slashs ne sont reconnus qu'à la fin d'une ligne
ou suivies d'un
un espace blanc \\ceci se produit sans cela.

Voici un peu de texte avec quelques ruptures de lignes\\ Notez que les
deux anti-slashs ne sont reconnus qu'à la fin d'une ligne\\
ou suivies d'un\\ un espace blanc \\ceci se produit sans cela.

Vous ne devriez utiliser des lignes de caractères forcées que si c'est vraiment nécessaire.

DokuWiki supporte plusieurs façons de créer des liens.

Les liens externes sont reconnus automatiquement : http://www.google.com or simply www.google.com - Vous pouvez également définir le texte du lien : This Points de liaison avec google. Les adresses e-mail comme celle-ci : andi@splitbrain.org sont reconnus, également.

DokuWiki supporte plusieurs façons de créer des liens. Les liens externes sont reconnus
de manière automatique : http://www.google.com or simply www.google.com - You can set
texte de lien aussi : [[http://www.google.com|This Link points to google]]. Email
Les adresses comme celle-ci : <[email protected]> sont reconnues, elles aussi.

Les liens internes sont créés à l'aide de brackets carrés. Vous pouvez soit simplement donner un pagename soit utiliser un lien supplémentaire. link text.

Les liens internes sont créés à l'aide de brackets carrés. Vous pouvez soit simplement donner
a [[wiki:pagename]] or use an additional [[wiki:pagename|link text]].

Les pagenames Wiki sont automatiquement convertis en lowercase, les caractères spéciaux ne sont pas autorisés.

Vous pouvez utiliser namespaces en utilisant une colonne dans le nom de pagen.

You can use [[some:namespaces]] by using a colon in the pagename.

Pour plus de détails sur les espaces de noms, voir namespaces .

Le lien vers une section spécifique est également possible. Il suffit d'ajouter le nom de la section derrière un caractère de hachage comme on le connaît en HTML. Ce lien vers cette section.

Ce lien vers [[wiki:syntax#internal|cette section]].

Notes :

• Les liens vers pages existantes sont affichés dans un style différent de nonexisting ones.
• DokuWiki n'utilise pas CamelCase pour créer automatiquement des liens par défaut, mais ce comportement peut être activé dans le fichier config . Hint : Si DokuWiki est un lien, alors il est activé.
• Quand le titre d'une section est modifié, son signet change aussi. Ne vous fiez donc pas trop aux liens de section.

DokuWiki supporte Interwiki liens. Ce sont des liens rapides vers d'autres wikis. Par exemple, ceci est un lien vers la page de Wikipedia sur les wikis : Wiki .

DokuWiki supporte [[doku>Interwiki]] liens. Ce sont des liens rapides vers d'autres wikis.
Par exemple, ceci est un lien vers la page about Wikis de Wikipedia : [[wp>Wiki]] .

Les partages Windows comme ce sont reconnues, elles aussi. Veuillez noter que cela n'a de sens que dans un groupe d'utilisateurs homogène comme une entreprise Intranet .

Les partages Windows comme [[\\server\share|]] sont reconnues, elles aussi.

Notes :

• Pour des raisons de sécurité, la navigation directe des partages de fenêtres ne fonctionne que dans Microsoft Internet Explorer par défaut (et uniquement dans la “zone locale”).
• Pour Mozilla et Firefox, elle peut être activée par le biais de différentes solutions de contournement mentionnées dans la Mozilla Base de connaissances. Toutefois, il y aura toujours un avertissement JavaScript concernant l'ouverture d'un partage Windows. Pour supprimer ce message d'avertissement (pour tous les utilisateurs), insérez la ligne suivante dans le fichier conf/lang/en/lang.php (plus de détails sur localization) :

  conf/lang/en/lang.php

  <?php
  /**
   * Customization of the english language file
   * Copy only the strings that needs to be modified
   */
  $lang['js']['nosmblinks'] = '';

Vous pouvez également utiliser une image pour faire un lien vers une autre page interne ou externe en combinant la syntaxe pour les liens et les images (voir ci-dessous) comme ceci :

[[http://php.net|{{wiki:dokuwiki-128.png}}]]

Remarque : Le formatage de l'image est la seule syntaxe de formatage acceptée dans les noms de liens.

L'ensemble des image et link syntaxe est supportée (y compris le redimensionnement d'image, les images internes et externes et les URL et liens interwiki).

Vous pouvez ajouter des notes de bas de page ¹⁾ en utilisant des doubles parenthèses.

Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en utilisant des doubles parenthèses.

Vous pouvez utiliser jusqu'à cinq niveaux différents d'en-têtes pour structurer votre contenu. Si vous avez plus de trois en-têtes, une table des matières est automatiquement générée – cela peut être désactivé en incluant la chaîne de caractères ~~NOTOC~~ dans le document.

==== Tête de ligne niveau 3 ====
=== Tête de ligne niveau 4 ===
== Tête de ligne niveau 5 ==

En utilisant quatre ou plus de couches, vous pouvez créer une ligne horizontale :

Vous pouvez inclure des fichiers externes et internes images, vidéos et fichiers audio avec des brackets curly. En option, vous pouvez spécifier leur taille.

Taille réelle :

Redimensionner à la largeur donnée :

Resize to given width and height²⁾ :

Image externe redimensionnée :

Taille réelle : {{wiki:dokuwiki-128.png}}
Redimensionner à une largeur donnée : {{wiki:dokuwiki-128.png?50}}
Resize to given width and height : {{wiki:dokuwiki-128.png?200x50}}
Image externe redimensionnée : {{https://www.php.net/images/php.gif?200x50}}

En utilisant des espaces blancs à gauche ou à droite, vous pouvez choisir l'alignement.

Of course, you can add a title (displayed as a tooltip by most browsers), too.

{{ wiki:dokuwiki-128.png |This is the caption}}

Pour lier une image à une autre page, voir Image Links ci-dessus.

DokuWiki peut intégrer directement les formats de médias suivants.

Si vous spécifiez un nom de fichier qui n'est pas un format média supporté, il sera affiché comme un lien à la place.

En ajoutant ?linkonly vous fournissez un lien vers le média sans l'afficher en ligne.

dokuwiki-128.png

dokuwiki-128.png Il s'agit simplement d'un lien vers l'image.

Malheureusement, tous les navigateurs ne comprennent pas tous les formats vidéo et audio. Pour remédier à ce problème, tu peux télécharger ton fichier dans différents formats pour une compatibilité maximale avec le navigateur.

Par exemple, considérez cette vidéo mp4 intégrée :

{{wiki:video.mp4|Une vidéo amusante}}

Lorsque vous téléchargez un video.webm et video.ogv à côté de la vidéo référencée video.mp4DokuWiki les ajoutera automatiquement comme alternatives pour que l'un des trois fichiers soit compris par votre navigateur.

De plus, DokuWiki supporte une image “poster” qui sera affichée avant que la vidéo ne commence. Cette image doit avoir le même nom de fichier que la vidéo et être un fichier jpg ou png. Dans l'exemple ci-dessus, un video.jpg fonctionnerait.

Dokuwiki supporte les listes ordonnées et non ordonnées. Pour créer un élément de liste, indiquez votre texte par deux espaces et utilisez un * pour les listes non ordonnées ou un - pour les listes ordonnées.

• This is a list
• The second item
  • Vous pouvez avoir des niveaux différents
• Un autre objet

1. La même liste mais arrangée
2. Un autre objet
   1. Il suffit d'utiliser l'indention pour les niveaux inférieurs
3. C'est ça

  * This is a list
  * The second item
    * You may have different levels
  * Another item

  - The same list but ordered
  - Another item
    - Just use indention for deeper levels
  - That's it

Aussi, consultez la FAQ sur la liste des articles.

DokuWiki peut convertir certains caractères ou chaînes prédéfinis en images ou autres textes ou HTML.

La conversion texte-image se fait principalement pour les smileys. Et la conversion texte vers HTML est utilisée pour les remplacements de typographie, mais peut être configurée pour utiliser d'autres HTML également.

DokuWiki convertit des emoticon s couramment utilisés en leurs équivalents graphiques. Ces Smileys et autres images peuvent être configurées et étendues. Voici un aperçu des smileys inclus dans DokuWiki :

• 8-)
• 8-O
• :-(
• :-)
• =)
• :-/
• :-\
• :-?
• :-D
• :-P
• :-O
• :-X
• :-|
• ;-)
• ^_^
• m(
• :?:
• :!:
• LOL
• FIXME
• DELETEME

Typographie : DokuWiki peut convertir de simples caractères de texte en leurs entités typographiquement correctes. Voici un exemple de caractères reconnus.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “He thought 'It's a man's world'…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

La même chose peut être faite pour produire n'importe quel type de HTML, il suffit de l'ajouter au fichier fichier modèle.

Il y a trois exceptions qui ne proviennent pas de ce fichier modèle : l'entité de multiplication (640×480), les 'citations simples' et les 'citations doubles'. Elles peuvent être désactivées par l'intermédiaire de l'option option de configuration.

Parfois, vous voulez marquer un texte pour indiquer qu'il s'agit d'une réponse ou d'un commentaire. Vous pouvez utiliser la syntaxe suivante :

I think we should do it

> No we shouldn't

>> Well, I say we should

> Really?

>> Yes!

>>> Then lets do it!

Je pense que nous devrions le faire

No we shouldn't

Eh bien, je dis que nous devrions

Really ?

Yes !

Then lets do it !

DokuWiki supporte une syntaxe simple pour créer des tables.

Les rangées de tableaux doivent commencer et finir par un | pour les rangées normales ou a ^ pour les en-têtes.

^ En-tête 1   ^ En-tête 2   ^ En-tête 3   ^
| Row 1 Col 1   | Row 1 Col 2   | Row 1 Col 3   |
| Row 2 Col 1   | quelques colspan (notez la double pipe) ||
| rangée 3 col 1   | Row 3 Col 2   | Row 3 Col 3   |

Pour connecter les cellules horizontalement, il suffit de faire en sorte que la cellule suivante soit complètement vide comme indiqué ci-dessus. Veillez à toujours avoir la même quantité de séparateurs de cellules !

Les en-têtes de table verticaux sont également possibles.

Comme vous pouvez le voir, c'est le séparateur de cellules qui précède une cellule qui décide du formatage :

|              ^ En-tête 1   ^ En-tête 2   ^
^ Tête 3   | Row 1 Col 2   | Row 1 Col 3   |
^ tête 4   | pas de colspan cette fois |                    |
^ Tête 5   | Rang 2 Col 2   | Rang 2 Col 3   |

Vous pouvez avoir des rowspans (cellules connectées verticalement) en ajoutant ::: dans les cellules en dessous de celle à laquelle elles doivent se connecter.

Hormis la syntaxe rowspan, ces cellules ne doivent contenir rien d'autre.

^ En-tête 1   ^ En-tête 2   ^ En-tête 3   ^
| rangée 1 col 1   | this cell spans vertically | Rangée 1 Col 3   |
| Row 2 Col 1   | :: :   | Row 2 Col 3   |
| Row 3 Col 1   | :: :   | Row 2 Col 3   |

Vous pouvez aussi aligner le contenu du tableau. Il suffit d'ajouter au moins deux espaces blancs aux extrémités opposées de votre texte : ajoutez deux espaces à gauche pour l'alignement à droite, deux espaces à droite pour l'alignement à gauche et deux espaces au moins aux deux extrémités pour le texte centré.

Voici ce qu'il en est dans la source :

^           Tableau avec alignement           ^^^
|         droite|    centre    |left      |
|left      |         droite|    center    |
| xxxxxxxxxx | xxxxxxxxxx | xxxxxxxxxx |

Remarque : L'alignement vertical n'est pas pris en charge.

Si vous avez besoin d'afficher le texte exactement tel qu'il est typé (sans aucun formatage), entourez la zone soit avec <nowiki> ou encore plus simple, avec des signes double percent %%.

Il s'agit d'un texte qui contient des adresses comme celle-ci : http://www.splitbrain.org et **formatage**mais rien n'est fait avec. La même chose est vraie pour .//__ce__ texte// avec un smiley ;-).

<nowiki>
Il s'agit d'un texte qui contient des adresses comme celle-ci : http://www.splitbrain.org et **formatage**mais rien n'est fait avec.
</nowiki>
La même chose est vraie pour %%.//__ce__ texte// avec un smiley ;-)%%.

Vous pouvez inclure des blocs de code dans vos documents, soit en les désignant par au moins deux espaces (comme utilisé pour les exemples précédents), soit en utilisant les balises <code> or <file>.

This is text is indented by two spaces.

This is preformatted code all spaces are preserved: like              <-this

This is pretty much the same, but you could use it to show that you quoted a file.

Ces blocs ont été créés par cette source :

  This is text is indented by two spaces.

<code>
This is preformatted code all spaces are preserved: like              <-this
</code>

<file>
This is pretty much the same, but you could use it to show that you quoted a file.
</file>

DokuWiki permet de mettre en évidence le code source, ce qui le rend plus facile à lire. Il utilise le GeSHi Generic Syntax Highlighter – donc n'importe quel langage supporté par GeSHi est supporté. La syntaxe utilise le même code et les mêmes blocs de fichiers décrits dans la section précédente, mais cette fois-ci le nom de la syntaxe du langage à mettre en évidence est inclus dans la balise, par ex. <code java> or <file java>.

/**
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

The following language strings are currently recognized: 4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic

There are additional advanced options available for syntax highlighting, such as highlighting lines or adding line numbers.

When you use the <code> or <file> syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this:

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>

myexample.php

<?php echo "hello world!"; ?>

Si vous ne voulez pas de mise en évidence mais que vous voulez un fichier téléchargeable, spécifiez un dash (-) comme code de langue : <code - myfile.foo>.

DokuWiki peut intégrer des données provenant de flux XML externes. Pour l'analyse des flux XML, SimplePie est utilisé. Tous les formats compris par SimplePie peuvent être utilisés dans DokuWiki. Vous pouvez influencer le rendu par plusieurs paramètres supplémentaires séparés par des espaces :

La période de rafraîchissement par défaut est de 4 heures. Toute valeur inférieure à 10 minutes sera traitée comme 10 minutes. DokuWiki tentera généralement de fournir une version cachée d'une page, ce qui est évidemment inapproprié si la page contient un contenu externe dynamique. Le paramètre indique à DokuWiki de relancer la page s'il y a plus de période de rafraîchissement depuis que la page a été rendue pour la dernière fois.

Par défaut, le flux est trié par date, les éléments les plus récents en premier. Vous pouvez la trier par le plus ancien en utilisant l'option reverse ou afficher le flux tel quel avec nosort.

Exemple :

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

• Garmin Beats Apple to Market with Satellite-Connected Smartwatch de BeauHD (2025/09/03 23:40)
• AI Generated 'Boring History' Videos Are Flooding YouTube, Drowning Out Real History de BeauHD (2025/09/03 23:00)
• Supermarket Giant Tesco Sues VMware, Warns Lack of Support Could Disrupt Food Supply de BeauHD (2025/09/03 22:20)
• Instagram Is Coming To iPad, 15 Years Later de BeauHD (2025/09/03 21:40)
• Cloudflare Stops New World's Largest DDoS Attack Over Labor Day Weekend de BeauHD (2025/09/03 21:00)

Certaines syntaxes influencent la façon dont DokuWiki rend une page sans créer de sortie elle-même. Les macros de contrôle suivantes sont disponibles :

La syntaxe de DokuWiki peut être étendue par des Plugins. L'utilisation des plugins installés est décrite dans leurs pages de description respectives. Les plugins syntaxiques suivants sont disponibles dans cette installation particulière de DokuWiki :

• Anchor Plugin 2024-02-10 de Eli Fenton
  Create an HTML anchor.
• Autolink 4 2024-05-12 de Eli Fenton
  Automatically link a user-defined set of terms, without editing page content.
• Auto-Tooltip 2024-11-28 de Eli Fenton
  Syntax and helper plugins for tooltips, including automatically generated tips based on page abstract.
• Comment Syntax support 2022-01-01 de Satoshi Sahara
  Allow to use source comment syntax to leave edit instructions of the page. Comments are visible only in the source view, not rendered as any page elements.
• fontsize2 plugin 2017-01-07 de Thorsten Stratmann
  DokuWiki plugin for controlling the size of your text
• htmlok plugin 2023-05-10 de saggi, glen
  Allows embed HTML and PHP
• Icons Plugin 2024-10-30 de Giuseppe Di Terlizzi
  Embed icons in Dokuwiki
• ifauthex plugin 2023-02-08 de Pietro Saccardi
  Toggle DokuWiki page content based on users and groups with arbitrary boolean expressions.
• include plugin 2023-09-22 de Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
  Functions to include another page in a wiki page
• Info Plugin 2020-06-04 de Andreas Gohr
  Displays information about various DokuWiki internals
• nodisp 2022-09-14 de Myron Turner
  Hide text from brwosoer display or remove from output to browser depending on acl
• Pagelist Plugin 2023-08-27 de Matthias Schulte, Michael Hamann, Michael Klier, Gina Haeussge
  Lists pages in a nice formatted way
• Tag Plugin 2023-10-17 de Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
  tag wiki pages
• textinsert Plugin 2019-10-03 de Myron Turner
  replace macros with text subsitutions
• TocTweak ver.2 2018-01-08 de Satoshi Sahara
  Show tailored table of contents (TOC) of specified page/section in the page content
• Translation Plugin 2024-04-30 de Andreas Gohr
  Supports the easy setup of a multi-language wiki.
• Video Sharing Site Plugin 2025-02-21 de Andreas Gohr
  Easily embed videos from various Video Sharing sites. Example: {{youtube>XXXXXX}}
• Wrap Plugin 2023-08-13 de Anika Henke
  Universal plugin which combines functionalities of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction.