- English
- Français
Ceci est une ancienne révision du document !
Table des matières
Syntaxe de formatage
DokuWiki prend en charge un langage de balisage simple, qui vise à rendre les fichiers de données aussi lisibles que possible. Cette page contient toutes les syntaxes possibles que vous pouvez utiliser lors de la modification des pages. Il suffit de consulter le code source de cette page en cliquant sur « Modifier cette page ». Si vous souhaitez essayer quelque chose, utilisez simplement la page playground. Le balisage le plus simple est également facilement accessible via les boutons rapides.
Formatage de texte de base
DokuWiki prend en charge les textes en gras, en italique, soulignés et “'à espacement fixe”'. Vous pouvez bien sûr “'combiner”' tous ces formats.
DokuWiki prend en charge les textes **en gras**, //en italique//, __soulignés__ et “'à espacement fixe”'. Vous pouvez bien sûr **__//“'combiner”'//__** tous ces styles.
Vous pouvez également utiliser les balises indice et exposant.
Vous pouvez également utiliser <sub>indice</sub> et <sup>exposant</sup>.
Vous pouvez également marquer quelque chose comme supprimé.
Vous pouvez également marquer quelque chose comme <del>supprimé</del>.
Les paragraphes sont créés à partir de lignes vides. Si vous souhaitez forcer un saut de ligne sans paragraphe, vous pouvez utiliser deux barres obliques inversées suivies d'un espace ou de la fin de la ligne.
Voici un texte avec quelques sauts de ligne
Notez que les
deux barres obliques inversées ne sont reconnues qu'à la fin d'une ligne
ou suivies d'un espace \\cela se produit sans cela.
Vous ne devriez utiliser les sauts de ligne forcés qu'en cas de nécessité absolue.
Liens
DokuWiki prend en charge plusieurs méthodes de création de liens.
Externes
Les liens externes sont reconnus automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez également définir le texte du lien : Ce lien pointe vers Google. Les adresses e-mail telles que celle-ci : andi@splitbrain.org sont également reconnues.
DokuWiki prend en charge plusieurs méthodes pour créer des liens. Les liens externes sont reconnus automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez également définir le texte du lien : [[http://www.google.com|Ce lien pointe vers Google]]. Les adresses e-mail telles que celle-ci : <andi@splitbrain.org> sont également reconnues.
Interne
Les liens internes sont créés à l'aide de crochets. Vous pouvez soit indiquer simplement un nom de page, soit utiliser un texte du lien supplémentaire.
Les liens internes sont créés à l'aide de crochets. Vous pouvez soit indiquer simplement un [[nom de page]], soit utiliser un [[nom de page|texte du lien]] supplémentaire.
Les noms de page Wiki sont automatiquement convertis en minuscules, les caractères spéciaux ne sont pas autorisés.
Vous pouvez utiliser namespaces en utilisant un deux-points dans le nom de la page.
Vous pouvez utiliser [[some:namespaces]] en utilisant deux points dans le nom de la page.
Pour plus de détails sur les espaces de noms, voir namespaces.
Il est également possible de créer un lien vers une section spécifique. Il suffit d'ajouter le nom de la section après le caractère dièse, comme dans le langage HTML. Ce lien renvoie à cette section.
Remarques :
- Les liens vers des pages existantes sont affichés dans un style différent de ceux vers des pages inexistantes.
- Lorsque l'en-tête d'une section est modifié, son signet change également. Ne vous fiez donc pas trop aux liens de section.
Interwiki
DokuWiki prend en charge les liens Interwiki. Il s'agit de liens rapides vers d'autres wikis. Par exemple, voici un lien vers la page Wikipédia sur les wikis : Wiki.
DokuWiki prend en charge les liens [[doku>Interwiki]]. Il s'agit de liens rapides vers d'autres wikis. Par exemple, voici un lien vers la page Wikipédia consacrée aux wikis : [[wp>Wiki]].
Partages Windows
Les partages Windows tels que ceci sont également reconnus. Veuillez noter que ceux-ci n'ont de sens que dans un groupe d'utilisateurs homogène comme un Intranet d'entreprise.
Les partages Windows comme [[\\server\share|celui-ci]] sont également reconnus. Remarques :
- Pour des raisons de sécurité, la navigation directe vers les partages Windows ne fonctionne par défaut que dans Microsoft Internet Explorer (et uniquement dans la « zone locale »).
- Pour Mozilla et Firefox, elle peut être activée grâce à différentes solutions de contournement mentionnées dans la base de connaissances Mozilla. Cependant, un avertissement JavaScript s'affichera toujours lorsque vous tenterez d'ouvrir un partage Windows. Pour supprimer cet avertissement (pour tous les utilisateurs), ajoutez la ligne suivante dans « conf/lang/en/lang.php » (plus de détails dans localization) :
- conf/lang/en/lang.php
<?php /** * Personnalisation du fichier de langue anglaise * Copiez uniquement les chaînes qui doivent être modifiées */ $lang[“js”][“nosmblinks”] = “”;
Liens vers des images
Vous pouvez également utiliser une image pour créer un lien vers une autre page interne ou externe en combinant la syntaxe des liens et images (voir ci-dessous) comme ceci :
[[http://php.net|{{wiki:dokuwiki-128.png}}]]
Remarque : le formatage des images est la seule syntaxe de formatage acceptée dans les noms de liens.
L'ensemble de la syntaxe image et lien est pris en charge (y compris le redimensionnement des images, les images internes et externes, les URL et les liens interwiki).
Notes de bas de page
Vous pouvez ajouter des notes de bas de page 1) 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.
Sectionnement
Vous pouvez utiliser jusqu'à cinq niveaux de titres différents pour structurer votre contenu. Si vous avez plus de trois titres, une table des matières est générée automatiquement. Vous pouvez désactiver cette fonction en incluant la chaîne « ~~NOTOC~~ » dans le document.
Titre de niveau 3
Titre de niveau 4
Titre de niveau 5
==== Titre de niveau 3 ==== === Titre de niveau 4 === == Titre de niveau 5 ==
En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale :
Fichiers multimédias
Vous pouvez inclure des images, vidéos et fichiers audio externes et internes à l'aide d'accolades. Vous pouvez également spécifier leur taille.
Redimensionner à la largeur indiquée :
Redimensionner à la largeur et à la hauteur données 2) :
Image externe redimensionnée :
Taille réelle : {{wiki:dokuwiki-128.png}}
Redimensionner à la largeur indiquée : {{wiki:dokuwiki-128.png?50}}
Redimensionnement à la largeur et hauteur données : {{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.
{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}
Bien sûr, vous pouvez également ajouter un titre (affiché sous forme d'info-bulle par la plupart des navigateurs).
{{ wiki:dokuwiki-128.png |Ceci est la légende}}
Pour lier une image à une autre page, voir Liens vers des images ci-dessus.
Formats multimédias pris en charge
DokuWiki peut intégrer directement les formats multimédias suivants.
| Image | « gif », « jpg », « png » |
| Vidéo | « webm », « ogv », « mp4 » |
| Audio | “'ogg”', “'mp3”', “'wav”' |
| Flash | “'swf”' |
Si vous spécifiez un nom de fichier qui n'est pas un format multimédia pris en charge, il s'affichera sous forme de lien.
En ajoutant « ?linkonly », vous fournissez un lien vers le média sans l'afficher en ligne.
{{wiki:dokuwiki-128.png?linkonly}}
dokuwiki-128.png Il s'agit simplement d'un lien vers l'image.
Formats de secours
Malheureusement, tous les navigateurs ne prennent pas en charge tous les formats vidéo et audio. Pour pallier ce problème, vous pouvez télécharger votre fichier dans différents formats afin d'optimiser la compatibilité avec les navigateurs.
Prenons l'exemple de cette vidéo mp4 intégrée :
{{video.mp4|Une vidéo amusante}}
Lorsque vous téléchargez un fichier « video.webm » et « video.ogv » à côté du fichier « video.mp4 » référencé, DokuWiki les ajoute automatiquement comme alternatives afin que l'un des trois fichiers soit pris en charge par votre navigateur.
De plus, DokuWiki prend en charge une image « poster » qui s'affiche avant le démarrage de la vidéo. Cette image doit avoir le même nom de fichier que la vidéo et être au format jpg ou png. Dans l'exemple ci-dessus, un fichier « video.jpg » fonctionnerait.
Listes
Dokuwiki prend en charge les listes ordonnées et non ordonnées. Pour créer un élément de liste, indentez votre texte de deux espaces et utilisez un « * » pour les listes non ordonnées ou un « - » pour les listes ordonnées.
- Ceci est une liste
- Le deuxième élément
- Vous pouvez avoir différents niveaux
- Un autre élément
- La même liste, mais ordonnée
- Un autre élément
- Utilisez simplement l'indentation pour les niveaux plus profonds
- C'est tout
* Ceci est une liste
* Le deuxième élément
* Vous pouvez avoir différents niveaux
* Un autre élément
- La même liste, mais ordonnée
- Un autre élément
- Utilisez simplement l'indentation pour les niveaux plus profonds
- C'est tout
Consultez également la FAQ sur les éléments de liste.
Conversions de texte
DokuWiki peut convertir certains caractères ou chaînes prédéfinis en images ou en autre texte ou HTML.
La conversion de texte en image est principalement utilisée pour les smileys. La conversion de texte en HTML est utilisée pour les remplacements typographiques, mais peut également être configurée pour utiliser d'autres balises HTML.
Conversions de texte en image
DokuWiki convertit les émoticônes couramment utilisées en leurs équivalents graphiques. Ces smileys et autres images peuvent être configurés et étendus. Voici un aperçu des smileys inclus dans DokuWiki :
8-)
8-O
:-(
:-)
=)
:-/
:-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
^_^
m(
:?:
:!:
LOL
FIXME
DELETEME
Conversions de texte en HTML
Typographie : DokuWiki peut convertir des caractères de texte simples en entités typographiques correctes. Voici un exemple de caractères reconnus.
→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® « Il pensait : « C'est un monde d'hommes… » »
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) « Il pensait : « C'est un monde d'hommes... » »
La même chose peut être faite pour produire n'importe quel type de HTML, il suffit de l'ajouter au fichier de modèles.
Il existe trois exceptions qui ne proviennent pas de ce fichier de modèles : l'entité de multiplication (640×480), les guillemets simples et les guillemets doubles. Elles peuvent être désactivées via une option de configuration.
Citations
Parfois, vous souhaitez marquer un texte pour indiquer qu'il s'agit d'une réponse ou d'un commentaire. Vous pouvez utiliser la syntaxe suivante :
Je pense que nous devrions le faire. > Non, nous ne devrions pas. >> Eh bien, je pense que nous devrions. > Vraiment ? >> Oui ! >>> Alors faisons-le !
Je pense que nous devrions le faire.
Non, nous ne devrions pas.
Eh bien, je pense que nous devrions le faire
Vraiment ?
Oui !
Alors faisons-le !
Tableaux
DokuWiki prend en charge une syntaxe simple pour créer des tableaux.
| En-tête 1 | En-tête 2 | En-tête 3 |
|---|---|---|
| Ligne 1 Colonne 1 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 |
| Ligne 2 Colonne 1 | some colspan (notez le double pipe) | |
| Ligne 3 Colonne 1 | Ligne 3 Colonne 2 | Ligne 3 Colonne 3 |
Les lignes du tableau doivent commencer et se terminer par un « | » pour les lignes normales ou un « ^ » pour les en-têtes.
^ En-tête 1 ^ En-tête 2 ^ En-tête 3 ^ | Ligne 1 Colonne 1 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | | Ligne 2 Colonne 1 | some colspan (notez le double pipe) || | Ligne 3 Colonne 1 | Ligne 3 Colonne 2 | Ligne 3 Colonne 3 |
Pour relier des cellules horizontalement, il suffit de laisser la cellule suivante complètement vide, comme indiqué ci-dessus. Veillez à toujours avoir le même nombre de séparateurs de cellules !
Il est également possible d'utiliser des en-têtes de tableau verticaux.
| En-tête 1 | En-tête 2 | |
|---|---|---|
| En-tête 3 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 |
| En-tête 4 | pas de colspan cette fois-ci | |
| En-tête 5 | Ligne 2 Colonne 2 | Ligne 2 Colonne 3 |
Comme vous pouvez le constater, c'est le séparateur de cellules avant une cellule qui détermine la mise en forme :
| ^ En-tête 1 ^ En-tête 2 ^ ^ En-tête 3 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | ^ En-tête 4 | pas de colspan cette fois-ci | | ^ En-tête 5 | Ligne 2 Colonne 2 | Ligne 2 Colonne 3 |
Vous pouvez créer des lignes multiples (cellules reliées verticalement) en ajoutant « ::: » dans les cellules situées sous celles auxquelles elles doivent être reliées.
| En-tête 1 | En-tête 2 | En-tête 3 |
|---|---|---|
| Ligne 1 Colonne 1 | cette cellule s'étend verticalement | Ligne 1 Colonne 3 |
| Ligne 2 Colonne 1 | Ligne 2 Colonne 3 | |
| Ligne 3 Colonne 1 | Ligne 2 Colonne 3 |
Hormis la syntaxe rowspan, ces cellules ne doivent contenir aucun autre élément.
^ En-tête 1 ^ En-tête 2 ^ En-tête 3 ^ | Ligne 1 Colonne 1 | cette cellule s'étend verticalement | Ligne 1 Colonne 3 | | Ligne 2 Colonne 1 | ::: | Ligne 2 Colonne 3 | | Ligne 3 Colonne 1 | ::: | Ligne 2 Colonne 3 |
Vous pouvez également aligner le contenu du tableau. Il suffit d'ajouter au moins deux espaces à l'extrémité opposée de votre texte : ajoutez deux espaces à gauche pour aligner à droite, deux espaces à droite pour aligner à gauche et au moins deux espaces aux deux extrémités pour centrer le texte.
| Tableau avec alignement | ||
|---|---|---|
| droite | centre | gauche |
| gauche | droite | centre |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Voici à quoi cela ressemble dans la source :
^ Tableau avec alignement ^^^ | droite| centre |gauche | |gauche | droite| centre | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Remarque : l'alignement vertical n'est pas pris en charge.
Pas de mise en forme
Si vous avez besoin d'afficher du texte exactement tel qu'il est saisi (sans aucune mise en forme), encadrez la zone avec les balises « <nowiki> » ou, plus simplement encore, avec deux signes pour cent « %% ».
Ceci est un texte qui contient des adresses telles que : http://www.splitbrain.org et **formatage**, mais rien n'est fait avec. Il en va de même pour //__ce__ texte// avec un smiley ;-).
<nowiki> Ceci est un texte qui contient des adresses comme ceci : http://www.splitbrain.org et **formatage**, mais rien n'est fait avec. </nowiki> Il en va de même pour %%//__ce__ texte// avec un smiley ;-)%%.
Blocs de code
Vous pouvez inclure des blocs de code dans vos documents en les indentant d'au moins deux espaces (comme dans les exemples précédents) ou en utilisant les balises “”<code>“” ou “”<file>“”.
Ce texte est indenté de deux espaces.
Il s'agit d'un code préformaté où tous les espaces sont conservés : comme <-ceci
C'est à peu près la même chose, mais vous pouvez l'utiliser pour indiquer que vous citez un fichier.
Ces blocs ont été créés à partir de cette source :
Ce texte est indenté de deux espaces.
<code> Il s'agit d'un code préformaté, tous les espaces sont conservés : comme <-ceci </code>
<file> C'est à peu près la même chose, mais vous pouvez l'utiliser pour indiquer que vous avez cité un fichier. </file> ==== Mise en évidence de la syntaxe ====
DokuWiki peut mettre en évidence le code source, ce qui facilite sa lecture. Il utilise le générateur de syntaxe générique GeSHi – ainsi, tous les langages pris en charge par GeSHi sont pris en charge. La syntaxe utilise les mêmes blocs de code et de fichier que ceux 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 exemple « <code java> » ou « <file java> ».
/** * La classe HelloWorldApp implémente une application qui * affiche simplement « Hello World ! » sur la sortie standard. */ class HelloWorldApp { public static void main(String[] args) { System.out.println(« Hello World! »); //Affiche la chaîne. } }
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.
Downloadable Code Blocks
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!"; ?>
If you don't want any highlighting but want a downloadable file, specify a dash (-) as the language code: <code - myfile.foo>.
RSS/ATOM Feed Aggregation
DokuWiki can integrate data from external XML feeds. For parsing the XML feeds, SimplePie is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:
| Parameter | Description |
|---|---|
| any number | will be used as maximum number items to show, defaults to 8 |
| reverse | display the last items in the feed first |
| author | show item authors names |
| date | show item dates |
| description | show the item description. All HTML tags will be stripped |
| nosort | do not sort the items in the feed |
| n[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |
The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. DokuWiki will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells DokuWiki to re-render the page if it is more than refresh period since the page was last rendered.
By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the reverse parameter, or display the feed as is with nosort.
Example:
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
- Aurora Watch In Effect As Severe Solar Storm Slams Into Earth de BeauHD (2026/01/21 08:00)
- Era of 'Global Water Bankruptcy' Is Here, UN Report Says de BeauHD (2026/01/21 04:30)
- cURL Removes Bug Bounties de BeauHD (2026/01/21 03:02)
- OpenAI and ServiceNow Strike Deal to Put AI Agents in Business Software de BeauHD (2026/01/21 02:25)
- Developer Rescues Stadia Bluetooth Tool That Google Killed de BeauHD (2026/01/21 01:45)
Macros de contrôle
Certaines syntaxes influencent la manière dont DokuWiki affiche une page sans créer de sortie elle-même. Les macros de contrôle suivantes sont disponibles :
| Macro | Description |
|---|---|
| ~~NOTOC~~ | Si cette macro est trouvée sur la page, aucune table des matières ne sera créée |
| ~~NOCACHE~~ | DokuWiki met en cache toutes les sorties par défaut. Cela peut parfois ne pas être souhaitable (par exemple lorsque la syntaxe <php> ci-dessus est utilisée). L'ajout de cette macro forcera DokuWiki à réafficher une page à chaque appel |
Plugins de syntaxe
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 de syntaxe suivants sont disponibles dans cette installation particulière de DokuWiki :
- HTML Comment Plugin 2013-03-19 de Christopher Arndt
allows HTML comments to be retained in the output

