Inhaltsverzeichnis

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.

Mise en forme de texte de base

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.

Liens

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

Externe

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.

Interne

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 :

Interwiki

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]] .

Partage de Windows

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 :

Liens d'image

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).

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 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

Headline niveau 5
==== 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 :

Fichiers multimédias

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 height2) :

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.

Voici le titre 

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

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 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.

Formats de repli

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.

Listes

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.

  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.

Conversions de texte

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.

Conversions de texte en image

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 :

Conversions texte vers HTML

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.

Quoting

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 !

Tables

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

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

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.

Tête 1 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ée 2 col 2 Rang 2 Col 3

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.

En-tête 1 En-tête 2 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

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é.

Tableau avec alignement
droite centre left
left droit center
xxxxxxxxxx xxxxxxxxxx xxxxxxxxxx

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.

Pas de mise en forme

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 ;-)%%.

Blocs de code

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>

Mise en évidence de la syntaxe

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.

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 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>.

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 être utilisés dans DokuWiki. Vous pouvez influencer le rendu par plusieurs paramètres supplémentaires séparés par des espaces :

Paramètre Description
any number will be used as the maximum number items to show, defaults to 8
reverse afficher en premier les derniers éléments du flux
auteur afficher les noms des auteurs des articles
date show item dates
description afficher la description de l'article. Toutes les balises HTML seront supprimées
nosort ne trie pas les éléments dans le flux
n[dhm] refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours).

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 }}

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 trouvée sur la page, aucune table des matières ne sera créée.
~~NOCACHE~~ DokuWiki cache toutes les sorties par défaut. Parfois, ce n'est pas nécessaire (par exemple, lorsque la ...<php> syntaxe ci-dessus est utilisée), l'ajout de cette macro forcera DokuWiki à rendre 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 syntaxiques suivants sont disponibles dans cette installation particulière de DokuWiki :

1)
Ceci est une note de bas de page
2)
si le ratio d'aspect de la largeur et de la hauteur données ne correspond pas à celui de l'image, elle sera recadrée au nouveau ratio avant d'être redimensionnée