Outils pour utilisateurs

Outils du site


fr:wiki:syntax

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 .
  • DokuWiki n'utilise pas CamelCase pour créer automatiquement des liens par défaut, mais ce comportement peut être activé dans le fichier config . Indice : si DokuWiki est un lien, alors il est activé.
  • 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.

Taille réelle :

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

Voici la légende

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

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.mp4DokuWiki 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
  1. La même liste mais ordonnée
  2. Autre élément
    1. Il suffit d'utiliser l'indention 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

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-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • m( m(
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME 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 }}

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 :


1) Ceci est une note de bas de page
2) lorsque le rapport d'aspect de la largeur et de la hauteur données ne correspond pas à celui de l'image, celle-ci sera recadrée au nouveau rapport avant d'être redimensionnée
fr/wiki/syntax.txt · Dernière modification : de domele