Syntaxe de mise en page

DokuWiki propose une syntaxe simple pour créer des tableaux.

Les lignes de tableau doivent commencer et se terminer avec une barre verticale | pour des lignes normales ou avec un ^ pour les titres.

^ Titre 1         ^ Titre 2           ^ Titre 3                            ^
| Ligne 1 Col 1   | Ligne 1 Col 2     | Ligne 1 Col 3                      |
| Ligne 2 Col 1   | colonnes fusionnées (notez la double barre verticale) ||
| Ligne 3 Col 1   | Ligne 2 Col 2     | Ligne 2 Col 3                      |

Pour fusionner des cellules horizontalement, videz simplement complètement la cellule suivante comme il est montré ci-dessus. Assurez-vous d'avoir toujours le même nombre de séparateurs de cellules !

Les titres de tableau verticaux sont également possibles.

Comme vous pouvez le constater, c'est le séparateur ('|' ou '^') précédant une cellule qui détermine le format :

|              ^ Titre 1                  ^ Titre 2          ^
^ Titre 3      | Ligne 1 Col 2            | Ligne 1 Col 3    |
^ Titre 4      | pas de fusion cette fois |                  |
^ Titre 5      | Ligne 2 Col 2            | Ligne 2 Col 3    |

Vous pouvez fusionner des cellules verticalement en ajoutant ::: dans les cellules sous celles avec laquelle elles doivent fusionner. Cette fonctionnalité n'est disponible que pour les versions supérieures à 2009-02-14b

Ces cellules ne doivent rien contenir d'autre que l'indicateur de fusion vertical.

^ 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 3 Col 3 |

Vous pouvez également aligner les contenus du tableau (uniquement horizontalement). Ajoutez simplement au moins deux espaces à l'extrémité opposée de votre texte : ajoutez deux espaces sur la gauche pour aligner à droite, deux espaces sur la droite pour aligner à gauche et deux espaces au moins à chaque extrémité pour centrer le texte.

Voici à quoi ça ressemble dans le code source :

^          Tableau avec alignement         ^^^
|        droite|    centré    |gauche        |
|gauche        |        droite|    centré    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Si vous avez besoin d'afficher du texte exactement comme il est saisi (sans aucun formatage), entourez le texte soit de balises <nowiki> soit, plus simplement encore, de double signe pourcent %%.

Voilà du texte qui contient une adresse : http://www.splitbrain.org et de la **mise en formee** ; mais il est reproduit tel quel. La même chose est vraie pour //__ce__ texte// avec une émoticône ;-).

<nowiki>
Voilà du texte qui contient une adresse : http://www.splitbrain.org et de la **mise en formee** ; mais
il est reproduit tel quel.
</nowiki>
La même chose est vraie pour  %%//__ce__ texte// avec une émoticône ;-)%%.
<nowiki>

Vous pouvez inclure des blocs non analysés dans vos documents soit en les indentant avec au moins deux espaces (comme on peut le voir dans les exemples précédents) soit en utilisant les balises <code> ou <file>.

Ce texte est indenté avec deux espaces.

Ceci est du code préformaté, tous les espaces sont préservés :
comme           <- ceci

C'est pratiquement la même chose, mais vous pouvez l'utiliser pour montrer
que vous avez cité un fichier. 

Ce texte est indenté avec deux espaces.
  

  Ceci est du code préformaté, tous les espaces sont préservés :
  comme           <- ceci
  

<file>
C'est pratiquement la même chose, mais vous pouvez l'utiliser pour montrer
que vous avez cité un fichier. 
</file>

DokuWiki peut mettre en forme et en couleur du code source, ce qui facilite sa lecture. Il utilise le Generic Syntax Highlighter GeSHi – donc n'importe quel langage connu de GeSHi est accepté. La syntaxe est la même que dans le bloc de code de la section précédente, mais cette fois le nom du langage utilisé est inséré dans la balise. Par exemple : <code java>.

/** 
 * La classe HelloWorldApp implémente une application qui
 * affiche simplement "Hello World!" dans la sortie standard.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Affiche la chaîne.
    }
}

DokuWiki reconnait les identifiants de langage suivants : 4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript, actionscript3, ada, aimms, algol68, apache, applescript, aptsources, arm, asm, asp, asymptote, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, batch, bf, biblatex, bibtex, blitzbasic, bnf, boo, c, caddcl, cadlisp, ceylon, cfdg, cfm, chaiscript, chapel, cil, cloadrunner, clojure, cmac, cmake, cobol, coffeescript, cpp, cpp-qt, cpp-winapi, csharp, css, cuesheet, cwinapi, d, dart, dcl, dcpu16, dcs, delphi, diff, div, dos, dot, e, ecmascript, eiffel, email, epc, 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, j, java, java5, javascript, jcl, 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, ocaml-brief, octave, oobas, oorexx, oracle11, oracle8, oxygene, oz, parasail, parigp, pascal, pcre, per, perl, perl6, pf, phix, php, php-brief, pic16, pike, pixelbender, pli, plsql, postgresql, postscript, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, pys60, python, q, qbasic, qml, racket, rails, rbs, rebol, reg, rexx, robots, rpmspec, rsplus, ruby, rust, sas, sass, scala, scheme, scilab, scl, sdlbasic, smalltalk, smarty, spark, sparql, sql, standardml, stonescript, swift, systemverilog, tcl, tclegg, teraterm, texgraph, text, thinbasic, tsql, twig, typoscript, unicon, upc, urbi, uscript, vala, vb, vbnet, vbscript, vedit, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, xbasic, xml, xojo, xorg_conf, xpp, yaml, z80, zxbasic.

D'autres options avancées sont disponibles, comme la mise en évidence des lignes ou l'ajout de numéros de lignes.

Quand vous utilisez les balises <code> ou <file>, vous pouvez rendre disponible en téléchargement le code affiché. Il faut alors préciser un nom de fichier juste après le code du langage.

monexemple.php

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

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

Si vous ne voulez pas de coloration syntaxique, il suffit de fournir un tiret (-) en guise de code de langage :
<code - monfichier.toto>.

Vous pouvez inclure du code HTML ou PHP pur dans vos documents en utilisant les balises <html> ou <php>. En utilisant des balises en majuscule, vous définissez un bloc. Les balises en minuscule insèrent les éléments en ligne.

exemple HTML :

Ceci est <html>de l'<span style="color:red;font-size:150%;">HTML en ligne</span>
</html>

Quant à <HTML>
<p style="border:2px dashed red;">ceci, un bloc HTML</p>
</HTML>

Ceci est de l'HTML en ligne

Quant à

ceci, un bloc HTML

exemple PHP :

<php>
echo 'Version de PHP: ';
echo phpversion();
echo ' (HTML en ligne généré)';
</php>
<PHP>
echo '<table class="inline"><tr><td>La même chose, mais dans un élément de niveau bloc:</td>';
echo '<td>'.phpversion().'</td>';
echo '</tr></table>';
</PHP>

echo 'Version de PHP: '; echo phpversion(); echo ' (HTML en ligne généré)';

echo '<table class="inline"><tr><td>La même chose, mais dans un élément de niveau bloc:</td>';
echo '<td>'.phpversion().'</td>';
echo '</tr></table>';

NB : L'inclusion de code HTML et PHP est désactivée dans la configuration par défaut. Dans ce cas, le code est affiché au lieu d'être exécuté.

DokuWiki peut agréger les données de fils XML externes. Pour l'analyse des fils XML, il utilise SimplePie. On peut utiliser tous les formats connus de SimplePie dans DokuWiki. Vous pouvez modifier le comportement en ajoutant plusieurs paramètres séparés par des espaces :

La période de rafraîchissement est par défaut de 4 heures. Toute valeur inférieure à 10 minutes sera traitée comme 10 minutes. DokuWiki essaiera en général de fournir une version de la page à partir du cache ; évidemment, cela est inadapté si la page a un contenu dynamique externe. Ce paramètre informe DokuWiki qu'il doit reconstruire la page s'il s'est écoulé plus de temps que la période de rafraîchissement depuis la dernière reconstruction.

Exemple :

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

• The Growth Rate For Mobile Internet Subscribers Has Stalled Across the World de msmash (2024/11/21 15:23)
• Steam Tightens Rules on Game Season Passes de msmash (2024/11/21 14:42)
• OpenAI Accidentally Deleted Potential Evidence in New York Times Copyright Lawsuit de msmash (2024/11/21 14:04)
• NASA Wants SpaceX and Blue Origin To Deliver Cargo To the Moon de BeauHD (2024/11/21 11:00)
• NASA's Curiosity Rover Captures 360-Degree View of Mars de BeauHD (2024/11/21 08:00)

Certains mots-clef modifient la manière dont DokuWiki génère une page, sans rajouter aucun contenu. Les macros suivantes sont disponibles :

La syntaxe de DokuWiki peut être étendue par des extensions. La manière d'utiliser les extensions installées est détaillée dans leurs pages de description respectives. Les extensions de syntaxe suivantes sont disponibles dans cette installation particulière de DokuWiki :

• Blockquote Plugin 2017-08-25 de Anika Henke (previous author: Gina Haeussge)
  Write quotations in a semantically correct way
• Bootstrap Wrapper Plugin 2020-09-03 de Giuseppe Di Terlizzi
  Bootstrap Wrapper for DokuWiki
• DataTables Plugin 2020-06-14 de Giuseppe Di Terlizzi
  Add DataTables support to DokuWiki
• Gallery Plugin 2019-01-05 de Andreas Gohr
  Creates a gallery of images from a namespace or RSS/ATOM feed
• Icons Plugin 2019-08-27 de Giuseppe Di Terlizzi
  Embed icons in Dokuwiki
• de
  
• Indexmenu Plugin 2020-07-31 de Samuele Tognini
  Show a customizable and sortable index for a namespace
• Info Plugin 2020-06-04 de Andreas Gohr
  Displays information about various DokuWiki internals
• Markdowku 2020-06-06 de Raphael Wimmer
  Integrates Markdown into Dokuwiki syntax
• MathJax plugin 2018-06-23 de Mark Liffiton
  Enables MathJax (https://www.mathjax.org/) parsing of TeX math expressions in wiki pages
• nspages plugin 2020-09-16 de Guillaume Turri
  Presents a toc of the selected namespace using <nspages>
• Poem 2012-07-06 de Danny Lin
  <poem> tag that embeds a block with linebreaks preserved.
• RefNotes Plugin 2020-08-10 de Mykola Ostrovskyy
  Extended syntax for footnotes and references.
• Translation Plugin 2020-03-24 de Andreas Gohr
  Supports the easy setup of a multi-language wiki.
• Wrap Plugin 2018-04-22 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.