====== ======de la syntaxe de mise en forme
prend en charge un langage de balisage simple, qui vise à rendre les fichiers de données aussi lisibles que possible. Cette page répertorie toutes les syntaxes que vous pouvez utiliser lors de la modification des pages. Il vous suffit de consulter le code source de cette page en cliquant sur « Modifier cette page ». Si vous souhaitez tester quelque chose, utilisez simplement la[[doku>DokuWiki]] [[playground:playground|page d'entraînement]]. Les balises les plus simples sont également facilement accessibles via [[doku>toolbar|boutons rapides]].
DokuWiki prend en charge le gras, italique, souligné et textes monospacés . Bien sûr, vous pouvez combiner toutes ces options.
DokuWiki prend en charge **le gras**, //italique//, __souligné__ et ''textes à espacement fixe'' . Bien sûr, vous pouvez **__//''combiner''//__** toutes ces options.
Notez que les balises de mise en forme doivent encadrer directement le texte, donc ** gras ** avec des espaces à l'intérieur des balises ne sera pas mis en forme.
Vous pouvez utiliser des indices et l'exposant.
Vous pouvez également utiliser <sub>l'indice</sub> et <sup>l'exposant</sup>également.
Vous pouvez marquer quelque chose comme supprimé également.
Vous pouvez également marquer un élément comme <del>supprimé</del> également.
Les paragraphes sont créés à partir de lignes vides. Si vous souhaitez forcer un saut de ligne sans créer de paragraphe, vous pouvez utiliser deux barres obliques inversées suivies d’un espace ou de la fin de ligne.
Voici un texte comportant des sauts de ligne
Notez que les
deux barres obliques inversées ne sont reconnues qu’à la fin d’une ligne
ou s’ils sont suivis d’
un espace \\; sans cela, cela ne fonctionne pas.
Voici un texte comportant des sauts de ligne\\ Notez que les deux barres obliques inversées ne sont reconnues qu'à la fin d'une ligne\\ ou lorsqu'ils sont suivis d'\\ un espace \\cela se produit sans cela.
Vous ne devriez utiliser les sauts de ligne forcés qu’en cas de réelle nécessité.
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 le texte du lien : This Le lien pointe vers google. Les adresses e-mail 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 le texte du lien : [[http://www.google.com|This Le lien pointe vers google]]. Les adresses e-mail comme celle-ci : <[email protected]> sont également reconnues.
Les liens internes sont créés à l’aide de crochets. Vous pouvez soit indiquer simplement un pagename , soit utiliser un texte de lien.
Les liens internes sont créés à l'aide de crochets. Vous pouvez soit indiquer simplement une [[de:wiki:pagename]] , soit utiliser un [[de:wiki:pagename|]].
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 insérant deux points dans le nom de la page.
Vous pouvez utiliser [[some:namespaces]] en insérant deux points dans le nom de la page.
Pour plus de détails sur les espaces de noms, consultez 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 signe dièse, comme en HTML. Cela crée un lien vers cette section.
Ce lien renvoie vers [[fr:wiki:syntax#internal|cette section]].
Remarques :
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 de Wikipédia consacrée aux 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]] .
Les partages Windows tels que celui-ci 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 tels que [[\\server\share|celle-ci]] sont également reconnus.
Remarques :
conf/lang/en/lang.php (plus de détails sur localisation) : <?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 créer un lien vers une autre page interne ou externe en combinant la syntaxe des liens et celle des d'images (voir ci-dessous) comme ceci :
[[http://php.net|{{wiki:dokuwiki-128.png}}]]
Remarque : la mise en forme des images est la seule syntaxe de mise en forme acceptée dans les noms de liens.
L'image entière images_and_other_files d’image et links de lien est prise en charge (y compris le redimensionnement des images, les images internes et externes, les URL et les liens interwiki).
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.
Vous pouvez utiliser jusqu’à cinq niveaux différents de titres pour structurer votre contenu. Si vous avez plus de trois titres, une table des matières est générée automatiquement — cette fonctionnalité peut être désactivée en incluant la chaîne ~~NOTOC~~ dans le document.
En utilisant au moins quatre tirets, vous pouvez créer une ligne horizontale :
Vous pouvez inclure des images à l’aide d’accolades. Vous pouvez éventuellement spécifier leur taille.
Redimensionner à la largeur indiquée :
Redimensionnement à une largeur et une hauteur données (lorsque le rapport hauteur/largeur de la largeur et de la hauteur indiquées ne correspond pas à celui de l’image, celle-ci sera recadrée selon le nouveau rapport avant le redimensionnement) :
Image externe redimensionnée :
Taille réelle : {{wiki:dokuwiki-128.png }}
Redimensionner à la largeur indiquée : {{wiki:dokuwiki-128.png?50 }}
Redimensionner à la largeur et à la hauteur indiquées : {{wiki:dokuwiki-128.png?200x50}}
Image externe redimensionnée : {{https://www.php.net/images/php.gif?200x50}}
En utilisant des espaces à gauche ou à droite, vous pouvez choisir l'alignement.
Vous pouvez également définir explicitement l'alignement à l'aide d'un ?left, ?right ou ?center . Ce paramètre a priorité sur l'alignement par espaces ci-dessus et peut être combiné avec une taille.
Bien sûr, 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 créer un lien vers une autre page à partir d’une image, consultez Image Links ci-dessus.
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 indiquez un nom de fichier qui n'est pas un format multimédia pris en charge, celui-ci s'affichera alors sous forme de lien.
En ajoutant ?linkonly , vous fournissez un lien vers le fichier multimédia sans l'afficher directement dans la page
dokuwiki-128.png Il s'agit simplement d'un lien vers l'image.
Malheureusement, tous les navigateurs ne prennent pas en charge tous les formats vidéo et audio. Pour pallier ce problème, vous pouvez mettre en ligne votre fichier dans différents formats afin d'assurer une compatibilité maximale avec les navigateurs.
Prenons par exemple cette vidéo mp4 intégrée :
{{de:wiki:video.mp4|Une vidéo amusante}}
Lorsque vous téléchargez une fichier vidéo .webm et video.ogv à côté du fichier video.mp4, DokuWiki les ajoutera automatiquement en tant qu’alternatives afin que l’un des trois fichiers soit pris en charge par votre navigateur.
De plus, DokuWiki prend en charge une image « d'affiche » qui s'affichera avant le démarrage de la vidéo. Cette image doit porter 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 conviendrait.
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 une balise * pour les listes non ordonnées ou un - pour les listes ordonnées.
* 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
Consultez également la FAQ sur les éléments de liste.
DokuWiki peut convertir certains caractères ou chaînes prédéfinis en images, en autre texte ou en code HTML.
La conversion de texte en image est principalement utilisée pour les smileys. Quant à la conversion de texte en HTML, elle sert à remplacer des éléments typographiques, mais peut être configurée pour utiliser d’autres éléments HTML également.
DokuWiki convertit les 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 :
Typographie : dokuwiki permet de convertir des caractères de texte simples en entités typographiques 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 procédure peut être utilisée pour générer n'importe quel type de code 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.
Il arrive parfois que l’on souhaite mettre en évidence 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 qu’on devrait le faire
Non, on ne devrait pas
Eh bien, moi je dis qu’on devrait
Vraiment ?
Oui !
Alors allons-y !
DokuWiki prend en charge une syntaxe simple pour créer des tableaux.
| Titre 1 | Titre 2 | Titre 3 |
|---|---|---|
| Ligne 1 Colonne 1 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 |
| Ligne 2 Colonne 1 | colspan (notez la double barre verticale) | |
| 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 par un ^ pour les en-têtes.
^ En-tête 1 ^ Titre 2 ^ Titre 3 ^ | Ligne 1 Colonne 1 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | | Ligne 2 Colonne 1 | colspan (notez le double bar) || | Ligne 3 Colonne 1 | Ligne 3 Colonne 2 | Ligne 3 Colonne 3 |
Pour relier des cellules horizontalement, il suffit de laisser la cellule suivante entièrement vide, comme indiqué ci-dessus. Veillez à toujours utiliser le même nombre de séparateurs de cellules !
Il est également possible d'ajouter 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 |
| Titre 4 | pas de colspan cette fois-ci | |
| Titre 5 | Ligne 2, colonne 2 | Ligne 2, colonne 3 |
Comme vous pouvez le constater, c'est le séparateur de cellule situé avant une cellule qui détermine la mise en forme :
| ^ Titre 1 ^ Titre 2 ^ ^ Titre 3 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | ^ Titre 4 | pas de colspan cette fois-ci | | ^ Titre 5 | Ligne 2, colonne 2 | Ligne 2, colonne 3 |
Vous pouvez créer des « rowspans » (cellules reliées verticalement) en ajoutant ::: dans les cellules situées sous celle à laquelle elles doivent être reliées.
| Titre 1 | Titre 2 | Titre 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 rien contenir d'autre.
^ Titre 1 ^ Titre 2 ^ Titre 3 ^ | Ligne 1 Colonne 1 | cette cellule s'étend verticalement sur | 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 à chaque extrémité pour centrer le texte.
| Tableau avec alignement | ||
|---|---|---|
| à droite | centré | à gauche |
| à gauche | à droite | au centre |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Voici à quoi cela ressemble dans le code source :
^ Tableau avec alignement ^^^ | à droite| au centre |à gauche | |gauche | à droite| centre | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Remarque : l'alignement vertical n'est pas pris en charge.
Si vous souhaitez afficher le texte exactement tel qu'il est saisi (sans aucune mise en forme), encadrez la zone avec <nowiki> ou, plus simplement encore, entre deux signes pourcentage %%.
Voici un texte contenant des adresses de ce type : http://www.splitbrain.org et **mise en forme**, mais aucune modification n'est appliquée. Il en va de même pour //__ce__ texte// contenant un smiley ;-).
<nowiki> Voici un texte qui contient des adresses comme celle-ci : http://www.splitbrain.org et **la mise en forme**, mais aucune modification n'est appliquée. </nowiki> Il en va de même pour %%//__ce__ texte// contenant un smiley ;-)%%.
Vous pouvez inclure des blocs de code dans vos documents soit en les indentant d’au moins deux espaces (comme dans 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 à partir de 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>
dokuwiki permet de mettre en évidence le code source, ce qui facilite sa lecture. Il utilise le GeSHi Generic Syntax Highlighter — ainsi, tous les langages pris en charge par GeSHi sont pris en charge. La syntaxe utilise les mêmes blocs de code et de fichiers que ceux décrits dans la section précédente, mais cette fois-ci, le nom du langage à mettre en évidence est inclus à l'intérieur de la balise, par exemple : <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>
<?php echo "hello world!"; ?>
Si vous ne souhaitez pas de mise en évidence mais voulez un fichier téléchargeable, indiquez un tiret (-) comme code de langage : <code - myfile.foo>.
dokuwiki peut intégrer des données provenant de flux XML externes. Pour analyser les flux XML, SimplePie est utilisé. Tous les formats pris en charge par SimplePie peuvent également être utilisés dans DokuWiki. Vous pouvez modifier le rendu à l’aide de plusieurs paramètres supplémentaires séparés par des espaces :
| Paramètre | Description |
|---|---|
| any number | will be used as maximum number items to show, defaults to 8 |
| reverse | afficher en premier les derniers éléments du flux |
| author | afficher les noms des auteurs des éléments |
| date | afficher les dates des éléments |
| description | afficher la description de l'élément. Toutes les balises HTML seront supprimées |
| nosort | ne pas trier les éléments du flux |
| n[dhm] | période de rafraîchissement, où d=jours, h=heures, m=minutes. (par ex. 12h = 12 heures). |
La période de rafraîchissement est fixée par défaut à 4 heures. Toute valeur inférieure à 10 minutes sera considérée comme égale à 10 minutes. dokuwiki tentera généralement de fournir une version mise en cache d’une page ; cela n’est évidemment pas approprié lorsque la page contient du contenu externe dynamique. Le paramètre indique à dokuwiki de réafficher la page si cela fait plus de période de rafraîchissement s'est écoulé depuis le dernier affichage de la page.
Par défaut, le flux est trié par date, les éléments les plus récents apparaissant en premier. Vous pouvez le trier en commençant par les plus anciens à l'aide du paramètre paramètre « reverse », ou afficher le flux tel quel avec le , ou afficher le flux tel quel avec nosort.
Exemple :
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
Certaines syntaxes influencent la manière dont DokuWiki affiche une page sans générer de sortie en soi. 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 toute la sortie par défaut. Cela peut parfois ne pas être souhaité (par exemple lorsque la syntaxe <php> ci-dessus) ; l'ajout de cette macro forcera DokuWiki à réafficher une page à chaque appel |
La syntaxe de DokuWiki peut être étendue grâce à des plugins. L'utilisation des plugins installés est décrite sur leurs pages de description respectives. Les plugins de syntaxe suivants sont disponibles dans cette installation particulière de DokuWiki :