Table des matières
Syntaxe de formatage
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. Jetez simplement un coup d'œil à la source de cette page en cliquant sur “Editer cette page”. Si vous voulez essayer quelque chose, utilisez simplement la page terrain de jeu. Les balises les plus simples sont facilement accessibles via boutons rapides.
Formatage du texte de base
DokuWiki supporte les caractères gras, italique, souligné et monospaced
textes. Bien entendu, vous pouvez combiner
tous ces éléments.
DokuWiki supporte les caractères **gras**, //italique//, __souligné__ et ''monospaced'' textes. Bien entendu, vous pouvez **__//''combiner''//__** tous ces éléments.
Vous pouvez utiliser indice et exposantégalement.
Vous pouvez utiliser l <sub>indice</sub> et <sup>exposant</sup>également.
Vous pouvez marquer quelque chose comme supprimé également.
Vous pouvez marquer quelque chose comme <del>supprimé</del> également.
Les paragraphes sont créés à partir de lignes vierges. Si vous souhaitez forcer une nouvelle ligne sans paragraphe, vous pouvez utiliser deux barres obliques inverses suivies d'un espace ou d'une fin de ligne.
Voici du texte avec des sauts de ligne
Notez que les
ne sont reconnus qu'en fin de ligne.
ou suivis d'un
d'un espace blanc \\ce qui n'est pas le cas ici.
Voici du texte avec des sauts de ligne\\ Notez que les ne sont reconnus qu'en fin de ligne.\\ ou suivis d'un\\ d'un espace blanc \\ce qui n'est pas le cas ici.
Vous ne devriez utiliser des lignes de séparation forcées que si cela est vraiment nécessaire.
Liens
DokuWiki permet de créer des liens de différentes manières.
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 : This Le lien pointe vers google. Les adresses électroniques comme celle-ci : andi@splitbrain.org sont également reconnues.
DokuWiki prend en charge plusieurs façons de créer des liens. Les liens externes sont reconnus automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez également définir texte du lien : [[http://www.google.com|This Le lien pointe vers google]]. Les adresses comme celle-ci : <[email protected]> sont également reconnues.
Interne
Les liens internes sont créés en utilisant des crochets. Vous pouvez soit donner un simple pagename , soit utiliser un texte de lien supplémentaire texte de lien supplémentaire.
Les liens internes sont créés à l'aide de crochets. Vous pouvez soit donner un [[en:wiki:pagename]] ou utiliser un texte de lien supplémentaire [[en:wiki:pagename|texte de lien]].
Les noms de pages 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 domaine.
Vous pouvez utiliser [[some:namespaces]] en utilisant un deux-points dans le nom de domaine.
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 derrière un caractère dièse, comme en HTML. Ce lien renvoie à cette section.
Ce lien renvoie à [[en:wiki:syntax#internal|cette section]].
Notes :
- Les liens vers les pages pages existantes sont affichés dans un style différent de ceux de nonexisting .
- Lorsque le titre d'une section est modifié, son signet change également. Ne comptez donc pas trop sur les liens de section.
Interwiki
DokuWiki supporte les liens Interwiki . Il s'agit de liens rapides vers d'autres Wikis. Par exemple, voici un lien vers la page de Wikipedia sur les Wikis : Wiki .
DokuWiki supporte les liens [[doku>Interwiki]] . Il s'agit de liens rapides vers d'autres Wikis. Par exemple, voici un lien vers la page de Wikipedia sur les Wikis : [[wp>Wiki]] .
Partage de Windows
Les partages Windows comme cette sont également reconnus. Veuillez noter que ces partages n'ont de sens que dans un groupe d'utilisateurs homogène tel qu'une entreprise Intranet .
Les partages Windows comme [[\\server\share|comme]] sont également reconnus.
Notes :
- Pour des raisons de sécurité, l'exploration directe des 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 par le biais d'une solution de contournement mentionnée dans la Mozilla Base de connaissances. Cependant, il y aura toujours un avertissement JavaScript lors de la tentative d'ouverture d'un partage Windows. Pour supprimer cet avertissement (pour tous les utilisateurs), ajoutez la ligne suivante dans
conf/lang/fr/lang.php
(pour plus de détails, voir localisation) :- conf/lang/en/lang.php
<?php /** * Customization of the english language file * Copy only the strings that needs to be modified */ $lang['js']['nosmblinks'] = '';
Liens d'image
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 des images (voir ci-dessous) comme suit :
[[http://php.net|{{wiki:dokuwiki-128.png}}]]
Remarque : la mise en forme de l'image est la seule syntaxe de mise en forme acceptée dans les noms de liens.
L'ensemble de l'image image et lien (y compris le redimensionnement de l'image, 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 - ceci peut être désactivé en incluant la chaîne de caractères ~~NOTOC~~
dans le document.
Titre Niveau 3
Titre Niveau 4
Titre niveau 5
==== Titre niveau 3 ==== === Titre niveau 4 === == Titre niveau 5 ==
En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale :
Fichiers multimédias
Vous pouvez inclure des images, des vidéos et des fichiers audio externes et internes externes et internes, des vidéos et des fichiers audio avec des crochets. Vous pouvez également spécifier la taille de ces fichiers.
Redimensionner à la largeur donnée :
Redimensionner à la largeur et à la hauteur données 2) :
Redimensionnement d'une image externe :
Taille réelle : {{wiki:dokuwiki-128.png}} Redimensionner à la largeur donnée : {{wiki:dokuwiki-128.png?50}} Redimensionner à la largeur et à la 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.
Bien entendu, vous pouvez également ajouter un titre (affiché sous forme d'info-bulle par la plupart des navigateurs).
{{ wiki:dokuwiki-128.png |Voici la légende}}
Pour lier une image à une autre page, voir Image Links ci-dessus.
Formats de médias pris en charge
DokuWiki peut intégrer directement les formats de mé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 sera affiché sous forme de lien.
En ajoutant ?linkonly
vous fournissez un lien vers le média sans l'afficher en ligne
dokuwiki-128.png Il s'agit simplement d'un lien vers l'image.
Formats de repli
Malheureusement, tous les navigateurs ne comprennent pas tous les formats vidéo et audio. Pour atténuer ce problème, vous pouvez télécharger votre fichier dans différents formats afin d'assurer une compatibilité maximale avec les navigateurs.
Prenons l'exemple de cette vidéo mp4 intégrée :
{{en:wiki:video.mp4|Une vidéo amusante}}
Lorsque vous téléchargez un fichier video.webm
et video.ogv
à côté du fichier video.mp4
DokuWiki les ajoutera automatiquement comme alternatives afin que l'un des trois fichiers soit compris par votre navigateur.
En outre, DokuWiki prend en charge une image “poster” qui sera affichée avant le début de la vidéo. 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 fichier video.jpg
fonctionnerait.
Listes
Dokuwiki supporte les listes ordonnées et non ordonnées. Pour créer un élément de liste, indentez votre texte de deux espaces et utilisez une balise *
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
- Autre élément
- Il suffit d'utiliser l'indention pour les niveaux plus profonds
- C'est tout
* 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
Jetez également un coup d'œil à la FAQ sur les éléments de la liste.
Conversions de texte
DokuWiki peut convertir certains caractères ou chaînes de caractères prédéfinis en images ou autres textes ou HTML.
La conversion de texte en image est principalement utilisée pour les smileys. Et la conversion de texte en HTML est utilisée pour les remplacements de typographie, mais peut être configurée pour utiliser d'autres HTML également.
Conversions texte-image
DokuWiki convertit les images emoticon couramment utilisées en leurs équivalents graphiques. Ces Smileys et d'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
Conversions texte vers HTML
Typographie : dokuwiki peut convertir des caractères de texte simples 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 de motifs fichier de motifs.
Il existe trois exceptions qui ne proviennent pas de ce fichier de motifs : l'entité de multiplication (640×480), les “guillemets simples” et les “guillemets doubles”. Elles peuvent être désactivées par l'intermédiaire d'une option de configuration option de configuration.
Citations
Il arrive que vous souhaitiez 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
Non, nous ne devrions pas
Eh bien, je dis que nous devrions le faire
Vraiment ?
Oui !
Alors faisons-le !
Tables
DokuWiki supporte une syntaxe simple pour créer des tableaux.
Rubrique 1 | Titre 2 | Titre 3 |
---|---|---|
Ligne 1 Col 1 | Ligne 1 Col 2 | Ligne 1 Col 3 |
Ligne 2 Col 1 | quelques colspan (notez le double tuyau) | |
Ligne 3 Col 1 | Ligne 3 Col 2 | Ligne 3 Col 3 |
Les lignes du tableau doivent commencer et se terminer par un |
pour les lignes normales ou un ^
pour les en-têtes.
^ Titre 1 ^ Titre 2 ^ Titre 3 ^ | Ligne 1 Col 1 | Ligne 1 Col 2 | Ligne 1 Col 3 | | Ligne 2 Col 1 | quelques colspan (notez le double tuyau) || | Ligne 3 Col 1 | Ligne 3 Col 2 | Ligne 3 Col 3 |
Pour relier des cellules horizontalement, il suffit de vider complètement la cellule suivante, comme indiqué ci-dessus. Veillez à toujours avoir le même nombre de séparateurs de cellules !
Les en-têtes de table verticaux sont également possibles.
Titre 1 | Titre 2 | |
---|---|---|
Rubrique 3 | Ligne 1 Col 2 | Ligne 1 Col 3 |
Titre 4 | pas de colspan cette fois | |
Titre 5 | Ligne 2 Col 2 | Ligne 2 Col 3 |
Comme vous pouvez le constater, c'est le séparateur de cellules avant une cellule qui décide de la mise en forme :
| ^ Titre 1 ^ Titre 2 ^ ^ Rubrique 3 | Ligne 1 Col 2 | Ligne 1 Col 3 | ^ Titre 4 | pas de colspan cette fois | | ^ Titre 5 | Ligne 2 Col 2 | Ligne 2 Col 3 |
Vous pouvez avoir des interlignes (cellules connectées verticalement) en ajoutant :::
dans les cellules situées en dessous de celle à laquelle elles doivent être reliées.
Titre 1 | Titre 2 | Titre 3 |
---|---|---|
Ligne 1 Col 1 | cette cellule s'étend verticalement | Ligne 1 Col 3 |
Ligne 2 Col 1 | :: : | Ligne 2 Col 3 |
Ligne 3 Col 1 | :: : | Ligne 2 Col 3 |
En dehors de la syntaxe de l'interligne, ces cellules ne doivent contenir rien d'autre.
^ Titre 1 ^ Titre 2 ^ Titre 3 ^ | Ligne 1 Col 1 | cette cellule s'étend verticalement | Ligne 1 Col 3 | | Ligne 2 Col 1 | :: : | Ligne 2 Col 3 | | Ligne 3 Col 1 | :: : | Ligne 2 Col 3 |
Vous pouvez également aligner le contenu du tableau. Il vous 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 deux espaces au moins aux deux extrémités pour un texte centré.
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 |
Note : L'alignement vertical n'est pas pris en charge.
Pas de formatage
Si vous souhaitez afficher le texte tel qu'il est tapé (sans aucune mise en forme), entourez la zone de l'un ou l'autre des éléments suivants <nowiki>
ou, plus simplement encore, par des doubles signes de pourcentage %%
.
Il s'agit d'un texte qui contient des adresses comme celle-ci : http://www.splitbrain.org et **mise en forme**mais rien n'est fait avec. Il en va de même 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 **mise en forme**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>
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 :
Ce texte est indenté de deux espaces.
<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>
Mise en évidence de la syntaxe
dokuwiki peut mettre en évidence le code source, ce qui en facilite la lecture. Il utilise le GeSHi Generic Syntax Highlighter – donc n'importe quel langage supporté par GeSHi est supporté. La syntaxe utilise les mêmes blocs de code et de fichier décrits dans la section précédente, mais cette fois le nom de la syntaxe du langage à mettre en évidence est inclus à l'intérieur de 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.
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!"; ?>
Si vous ne souhaitez pas de mise en évidence mais que vous voulez un fichier téléchargeable, indiquez un tiret (-
) comme code de langue : <code - myfile.foo>
.
Agrégation de flux RSS/ATOM
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 également être utilisés dans DokuWiki. Vous pouvez influencer le rendu en utilisant plusieurs paramètres supplémentaires séparés par des espaces :
Paramètre | Description |
---|---|
n'importe quel nombre | sera utilisé comme nombre maximum d'éléments à afficher, la valeur par défaut est 8 |
inverser | affiche les derniers éléments du flux en premier |
auteur | affiche le nom de l'auteur de l'article |
date | afficher les dates de l'article |
description | affiche la description de l'article. Toutes les balises HTML seront supprimées |
ne pas trier | ne pas trier les éléments du flux |
n[dhm] | période de rafraîchissement, où d=jours, h=heures, m=minutes (par exemple 12h = 12 heures). |
La période de rafraîchissement est fixée par défaut à 4 heures. Toute valeur inférieure à 10 minutes sera traitée comme 10 minutes. dokuwiki essaie généralement de fournir une version mise en cache d'une page, ce qui n'est évidemment pas le cas lorsque la page contient un contenu externe dynamique. Ce paramètre indique à dokuwiki de réafficher la page s'il s'agit d'un délai supérieur à période de rafraîchissement 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 le trier par le plus ancien en utilisant le paramètre inverse
ou afficher le flux tel quel avec nosort
.
Exemple :
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
- Peacock Feathers Can Be Lasers de BeauHD (2025/07/31 07:00)
- Google Tool Misused To Scrub Tech CEO's Shady Past From Search de BeauHD (2025/07/31 03:30)
- Voice Actors Push Back As AI Threatens Dubbing Industry de BeauHD (2025/07/31 01:30)
- Google's AlphaEarth AI Maps Any 10-Meter Area on Earth Using Satellite Data de msmash (2025/07/31 00:52)
- Boring Company To Build Tesla Tunnels Under Nashville de BeauHD (2025/07/31 00:10)
Macros de contrôle
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 :
Macro | Description |
---|---|
~~NOTOC~~ | Si cette macro est présente sur la page, aucune table des matières ne sera créée. |
~~NOCACHE~~ | DokuWiki met en cache tous les résultats par défaut. Parfois, cela n'est pas souhaité (par exemple, lorsque la syntaxe <php> ci-dessus), l'ajout de cette macro forcera DokuWiki à restituer une page à chaque appel. |
Plugins de syntaxe
La syntaxe de DokuWiki peut être étendue par des Plugins. La manière dont les plugins installés sont utilisés est décrite dans leurs pages de description respectives. Les plugins de syntaxe suivants sont disponibles dans cette installation particulière de DokuWiki :
- Gallery Plugin 2024-04-30 de Andreas Gohr
Creates a gallery of images from a namespace or RSS/ATOM feed - 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 - Numbered Headings 2023-09-12 de Satoshi Sahara
Prepend tiered numbers as indexes for hierarchical headings - PageQuery Plugin 2025-03-04 de Mark C. Prins, previously Symon Bent
Search for (fulltext) and list wiki pages, sorted and optionally grouped by name, date, creator, abc, etc. in columns. Insert the pagequery markup wherever you want your list to appear. E.g.{{pagequery>[query;fulltext;sort=key:direction,key2:direction;group;limit=??;cols=?;inwords;proper]}} [..] = optional - 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.