Outils pour utilisateurs

Outils du site


fr:wiki:syntax

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

Mise en forme de base du texte

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

Liens

DokuWiki prend en charge plusieurs façons de créer des liens.

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

Liens internes

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 :

  • Les liens vers des pages existantes s’affichent dans un style différent de celui des liens nonexisting .
  • Par défaut, DokuWiki n’utilise pas CamelCase pour créer automatiquement des liens, mais ce comportement peut être activé dans le fichier config . Astuce : si « DokuWiki » est un lien, cela signifie que cette fonctionnalité est activée.
  • Lorsque le titre d’une section est modifié, son signet change également. Ne vous fiez donc pas trop aux liens vers les sections.

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

Partages Windows

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 :

  • Pour des raisons de sécurité, la navigation directe vers des partages Windows ne fonctionne par défaut que dans Microsoft Internet Explorer (et uniquement dans la « zone locale »).
  • Pour Mozilla et Firefox, cette fonctionnalité peut être activée grâce à différentes solutions de contournement mentionnées dans la Mozilla Base de connaissances. Cependant, un avertissement JavaScript s'affichera toujours 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/en/lang.php (plus de détails sur 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 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 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).

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.

Structuration en sections

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.

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 au moins quatre tirets, vous pouvez créer une ligne horizontale :


Fichiers multimédias

Vous pouvez inclure des images à l’aide d’accolades. Vous pouvez éventuellement spécifier leur taille.

Taille réelle :

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

Voici la légende :

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

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

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

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 une balise * pour les listes non ordonnées ou un - pour les listes ordonnées.

  • Voici une liste
  • Le deuxième élément
    • Vous pouvez avoir différents niveaux
  • Un autre élément
  1. La même liste, mais ordonnée
  2. Un autre élément
    1. Il suffit d'utiliser l'indentation pour les niveaux plus profonds
  3. 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

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

Conversions de texte en image

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 :

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) = )
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • m( m(
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

Conversions de texte en HTML

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.

Citations

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 !

Tableaux

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.

Pas de mise en forme

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

Blocs de code

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>

Mise en évidence de la syntaxe

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.

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 voulez un fichier téléchargeable, indiquez un tiret (-) comme code de langage : <code - myfile.foo>.

Agrégation de flux RSS/ATOM

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

Macros de contrôle

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

Plugins de syntaxe

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 :


1) Ceci est une note de bas de page
fr/wiki/syntax.txt · Dernière modification : de domele