====== Syntaxe de formatage ======
[[:wiki:DokuWiki]] supporte un **langage de balises simple**, qui essaie de rendre les fichiers de données aussi lisibles que possible. Cette page contient toute la syntaxe possible que vous pourrez utiliser en éditant les pages. Regardez simplement le source de cette page en cliquant sur le bouton « Éditer cette page » en haut ou en bas de cette page. Si vous souhaitez essayer quelque chose, rendez-vous dans le [[playground:page_d_essai|bac à sable]]. Les balises les plus simples sont facilement accessibles depuis les
[[doku>wiki:quickbuttons|boutons rapides]], aussi.
===== Mise en forme de texte basique =====
DokuWiki supporte les textes en //emphase//, **emphase forte**, __souligné__ (déconseillé) et ''à espace fixe'' (pour du code en ligne).
Bien sûr, vous pouvez tous les **__//''combiner''//__**.
DokuWiki supporte les textes en //emphase//, **emphase forte**,
__souligné__ (déconseillé) et ''à espace fixe'' (pour du code en ligne).
Bien sûr, vous pouvez tous les **__//''combiner''//__**.
Vous pouvez aussi utiliser indice et exposant.
Vous pouvez aussi utiliser indice et exposant.
De plus, vous pouvez marquer du contenu comme supprimé.
De plus, vous pouvez marquer du contenu comme supprimé.
**Les paragraphes** sont créés depuis les lignes vides. Si vous souhaitez **forcer un saut de ligne** sans paragraphe, vous pouvez utiliser deux antislashes suivis par un espace ou une fin de ligne.
Voici du texte avec des sauts de ligne remarquez que les
deux contre-obliques sont reconnues uniquement en fin de ligne
ou suivies par un espace ; ceci se produit sinon.
Voici du texte avec des sauts de ligne remarquez que les
deux contre-obliques sont reconnues uniquement en fin de ligne
ou suivies par un espace ; ceci se produit sinon.
Ne forcer des sauts de ligne que si c'est réellement nécessaire.
===== Liens =====
DokuWiki supporte plusieurs manières de créer des liens.
==== Externes ====
Les liens externes sont reconnus automatiquement : http://www.google.fr ou simplement www.google.fr - Vous pouvez aussi donner des noms aux liens : [[http://www.google.fr|Ce lien pointe vers google]]. Les adresses email telles que celle-ci : sont également reconnues.
Les liens externes sont reconnus automatiquement :
http://www.google.fr ou simplement www.google.fr -
Vous pouvez aussi donner des noms aux liens:
[[http://www.google.fr|Ce lien pointe vers google]].
Les adresses email telles que celle-ci :
sont également reconnues.
==== Interne ====
Les liens internes sont créés en utilisant des crochets. Vous pouvez soit donner juste un [[doku>wiki:nomdepage]] ou utiliser un [[doku>wiki:nomdepage|Titre]]. Les noms de page Wiki sont automatiquement convertis en minuscules et les caractères spéciaux ne sont pas admis.
Les liens internes sont créés en utilisant des crochets. Vous pouvez soit donner
juste un [[doku>wiki:nomdepage]] ou utiliser un [[doku>wiki:nomdepage|Titre]].
Les noms de page Wiki sont automatiquement convertis en minuscules et les
caractères spéciaux ne sont pas admis.
Vous pouvez utiliser des catégories en tapant deux points dans le nom de la page.
Vous pouvez utiliser des [[categories]] en tapant deux points dans le nom de la page.
Pour plus de détails à propos des catégories, se référer à [[doku>wiki:namespaces]].
Il est également possible de pointer vers une section spécifique. Ajoutez simplement le nom de la section derrière un caractère dièse comme en HTML. Par exemple, un lien vers [[syntax#interne|cette section]].
Par exemple, un lien vers [[syntax#interne|cette section]].
Notes :
* Les liens vers des [[syntax|pages existantes]] sont affichés dans un style différent de ceux pointant des [[pages_qui_n_existent_pas]].
* DokuWiki n'utilise pas automatiquement les mots Wiki (mots collés commençant par une majuscule, exemple : MotWiki) pour créer des liens par défaut, mais ce comportement peut être activé dans le fichier [[doku>config]]. NB : si DokuWiki est un lien alors il est activé.
* Quand le titre d'une section est modifié, les liens pointant vers elle ne sont plus valables. Donc, ne vous fiez pas trop aux liens vers les sections.
==== Interwiki ====
DokuWiki propose les liens [[doku>wiki:interwiki|Interwiki]]. Ce sont des liens rapides vers d'autres Wikis. Par exemple:
* [[wp>wiki|définition des Wikis dans Wikipedia]] (version anglaise)
* [[wpfr>wiki|définition des Wikis dans Wikipedia]] (version française)
* [[google>Wiki]] liens vers une recherche Google.
DokuWiki propose les liens [[doku>wiki:interwiki|Interwiki]].
Ce sont des liens rapides vers d'autres Wikis. Par exemple:
* [[wp>wiki|définition des Wikis dans Wikipedia]] (version anglaise)
* [[wpfr>wiki|définition des Wikis dans Wikipedia]] (version française)
* [[google>Wiki]] liens vers une recherche Google.
==== Les liens hyperimages ====
Vous pouvez également utiliser une image pour créer un lien vers une page interne ou externe en combinant la syntaxe des liens et images (voir plus bas) comme ceci :
[[http://www.php.net|{{wiki:php-powered.png}}]]
[[http://www.php.net|{{wiki:php-powered.png}}]]
NB : le formatage d'image est la seule syntaxe acceptée dans les noms de lien.
==== Inclure une page web ====
{{url>votre url ici}}
===== Notes de bas de page =====
Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en tapant une double parenthèse ((comme cela)).
Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en
tapant une double parenthèse ((comme cela)).
===== Note =====
Ceci est une note.
Attention ! Cette note est importante !
Astuce : cherchez bien !
Attention ! Vous allez dormir !
Ceci est une note.
Attention ! Cette note est importante !
Astuce : cherchez bien !
Attention ! Vous allez dormir !
===== Tout savoir sur les boîtes =====
Syntaxe :
Texte du contenu ici
* width : largeur de la boîte (ex : 120px ou 90%)
* classes : Classe de CSS personnalisée ou classe prédéfinie. La classe par défaut est avec des coins de boîte carrés et une couleur focntion de la couleur par défaut de Dokuwiki :
* round : arrondi les contour de la boîte
* blue : couleur bleue
* red : couleur rouge
* green : couleur verte
* orange : couleur orange
* left : fait flotter la boîte vers la gauche
* right : fait flotter la boîte vers la droite
* colours : une à 4 couleurs en notation CSS hexadecimale ou en notation RGB (ex : #F00 #fcab94 rgb(255,255,0). Les couleurs sont appliquées dans l'ordre aux éléments suivants. S'il y en a moins de 4 la première couleur sert à celles qui manquent :
- arrière plan de la partie contenu
- arrière plan du titre
- arrière plan de la partie extérieure de la boîte
- arrière plan de la partie contenu
- bords de la boîte
* title //montexte// — texte affiché au dessus du contenu de la boîte avec un style distinct.
* caption //montexte// — texte affiché en dessous du contenu de la boîte avec un style distinct.
* **[[http://wiki.jalakai.co.uk/dokuwiki/doku.php/test/boxes|Des exemples ici]]**
===== Rediriger une page =====
~~REDIRECT>Nom de la page~~
===== Découpage en sections =====
Vous pouvez utiliser jusqu'à cinq niveaux d'en-tête pour structurer votre contenu. Si vous avez plus de trois en-têtes, une table des matières est automatiquement générée -- elle peut être désactivée en incluant ''~~NOTOC~~'' dans le document.
==== En-tête niveau 3 ====
=== En-tête niveau 4 ===
== En-tête niveau 5 ==
==== En-tête niveau 3 ====
=== En-tête niveau 4 ===
== En-tête niveau 5 ==
En tapant 4 traits d'union, vous pouvez créer une ligne horizontale :
----
===== Images et autres fichiers =====
Vous pouvez inclure des [[doku>images]] internes ou externes avec des accolades. Vous pouvez éventuellement spécifier leur taille.
Taille réelle : {{wiki:dokuwiki-128.png}}
Modifier la largeur : {{wiki:dokuwiki-128.png?50}}
Redimensionner : {{wiki:dokuwiki-128.png?200x50}}
Redimensionner une image externe : {{http://de3.php.net/images/php.gif?100x100}}
Taille réelle : {{wiki:dokuwiki-128.png}}
Modifier la largeur : {{wiki:dokuwiki-128.png?50}}
Redimensionner : {{wiki:dokuwiki-128.png?200x50}}
Redimensionner une image externe : {{http://de3.php.net/images/php.gif?100x100}}
En laissant un espace à gauche ou à droite, vous pouvez choisir l'alignement
{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}
Vous pouvez bien évidemment ajouter un titre (affiché dans une info-bulle sur la plupart des navigateurs).
{{ wiki:dokuwiki-128.png |Voici le titre}}
{{ wiki:dokuwiki-128.png |Voici le titre}}
Si vous spécifiez un nom de fichier (externe ou interne) qui n'est pas une image (''gif,jpeg,png''), un lien sera affiché à la place.
===== Listes =====
DokuWiki supporte les listes ordonnées et non ordonnées. Pour créer une liste d'items, indentez votre texte avec deux espaces et tapez ''*'' pour une liste non ordonnée ou ''-'' pour une liste ordonnée.
* Voici une liste
* Le second item
* Vous pouvez avoir plusieurs niveaux
* Un autre item
- La même liste mais ordonnée
- Un autre item
- Utilisez l'indentation pour ajouter un niveau
- Voilà
* Voici une liste
* Le second item
* Vous pouvez avoir plusieurs niveaux
* Un autre item
- La même liste mais ordonnée
- Un autre item
- Utilisez l'indentation pour ajouter un niveau
- Voilà
===== Smileys =====
DokuWiki convertit les [[wp>emoticon]]s les plus courants en l'équivalent graphique. D'autres smileys peuvent être ajoutés dans le répertoire ''smiley'' et configurés dans le fichier ''conf/smileys.conf''. Voici un aperçu des Smileys inclus dans DokuWiki.
* 8-) %% 8-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :- %% :- %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
===== Typographie =====
[[dokuwiki]] peut convertir les caractères spéciaux. Voici un éventail des caractères reconnus :
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"Il pensa 'C'est un monde humain'..."
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"Il pensa 'C'est un monde humain'..."
NB : cette conversion peut être désactivée dans le fichier de configuration.
Please note: These conversions can be turned off through a [[doku>wiki:config#typography|config option]] and a [[doku>wiki:entities|pattern file]].
===== Citations =====
Vous pouvez parfois avoir envie de mettre en évidence une réponse ou un commentaire. Vous pouvez utiliser la syntaxe suivante :
Je pense que nous devrions le faire.
> Non, nous ne devrions pas.
>> Eh bien, je pense que nous devrions.
> En êtes-vous sûr ?
>> Certain !
>>> D'accord, faisons-le ! Je pense que nous devrions le faire.
Je pense que nous devrions le faire.
> Non, nous ne devrions pas.
>> Eh bien, je pense que nous devrions.
> En êtes-vous sûr ?
>> Certain !
>>> D'accord, faisons-le ! Je pense que nous devrions le faire.
===== Tableaux =====
DokuWiki supporte un syntaxe simple pour créer des tableaux.
^ En-tête 1 ^ En-tête 2 ^ En-tête 3 ^
| Lig 1 Col 1 | Lig 1 Col 2 | Lig 1 Col 3 |
| Lig 2 Col 1 | Fusion (notez le double pipe) ||
| Lig 3 Col 1 | Lig 2 Col 2 | Lig 2 Col 3 |
Les lignes normales du tableau doivent commencer et se terminer par un ''|'', les lignes d'en-tête par un ''^''.
^ En-tête 1 ^ En-tête 2 ^ En-tête 3 ^
| Lig 1 Col 1 | Lig 1 Col 2 | Lig 1 Col 3 |
| Lig 2 Col 1 | Fusion (notez le double pipe) ||
| Lig 3 Col 1 | Lig 2 Col 2 | Lig 2 Col 3 |
Pour fusionner des cellules (colspan), laissez vide la cellule suivante comme dans l'exemple ci-dessus. Vérifiez bien le nombre de séparateurs de cellule !
Les en-têtes de lignes sont également possibles.
| ^ En-tête 1 ^ En-tête 2 ^
^ En-tête 3 | Lig 1 Col 2 | Lig 1 Col 3 |
^ En-tête 4 | Pas de fusion cette fois | |
^ En-tête 5 | Lig 2 Col 2 | Lig 2 Col 3 |
Comme vous pouvez le voir, c'est le séparateur précédant la cellule qui définit le formatage :
| ^ En-tête 1 ^ En-tête 2 ^
^ En-tête 3 | Lig 1 Col 2 | Lig 1 Col 3 |
^ En-tête 4 | Pas de fusion cette fois | |
^ En-tête 5 | Lig 2 Col 2 | Lig 2 Col 3 |
Note : la fusion verticale de cellules (rowspan) n'est pas possible.
Vous pouvez également aligner le contenu des cellules. Ajoutez simplement au moins deux espaces du côté opposé au texte: ajoutez deux espaces à gauche pour aligner à droite, deux espaces à droite pour aligner à gauche et deux espaces à droite et deux à gauche pour centrer le texte.
^ Tableau avec alignement ^^^
| droite| centré |gauche |
|gauche | droite| centré |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Voici comment cela apparaît dans le fichier source:
^ Tableau avec alignement ^^^
| droite| centré |gauche |
|gauche | droite| centré |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
===== Blocs non interprétés =====
Vous pouvez inclure des blocs de texte non interprétés soit en les indentant avec au moins deux espaces (comme utilisé précédemment dans les exemples) soit en utilisant les balises ''code'' ou ''file''.
balise ''''
Voici du texte préformaté où tous les espaces sont conservés : comme <-ça
balise ''''
C'est quasiment la même chose mais vous pouvez utilisez celà pour montrer que vous citez un fichier.
Pour indiquer à l'interpréteur d'ignorer complètement une zone (ie. de ne pas la formater), entourer la zone de la balise ''nowiki'' ou plus simplement avec un double pourcentage ''%%''.
Voici du texte qui contient une adresse comme : http://www.splitbrain.org et du **formatage** mais rien n'est effectué.
Regardez le source de la page pour voir comment utiliser ces blocs.
===== Coloration Syntaxique =====
[[dokuwiki]] peut colorer le code source pour le rendre plus lisible. Il utilise l'utilitaire [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- donc tous les langages supportés par GeSHi sont supportés. La syntaxe est la même que le bloc de code précédent mais cette fois, vous précisez le langage du code source comme attribut de la balise. Exemple : ''
/**
* 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.
}
}
Les chaînes correspondant aux langages suivants sont acceptées : //actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, mpasm, nsis, objc, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml//
===== Tags & Topics =====
==== Les tags ====
Pour utiliser des //tags// (mots-clés) dans les pages du wiki :
{{tag>[motcle1 motcle2]}}
Les tags devant être accentués le sont. Exemples : [[:matériel]], [[:système]], [[:sécurité]], etc.
{{tag>matériel système sécurité}}
Les tags doivent être intégralement en minuscule, excepté le tag « BROUILLON » afin qu'il soit visible.
==== Les « topics » ====
Pour lister les pages ayant un tag utilisez cette syntaxe :
{{topic>nom_du_tag}}
Si vous venez d'ajouter un tag à une page et qu'une page listant les pages contenant ce tag //via// « le wikicode topic » ne contient pas votre page, cela est peut-être du au fait que votre page ne contient pas de titre de niveau 1. Veillez à bien structurer votre page de manière sémantique (c'est-à-dire avec des titres, etc.).
===== Index Automatique =====
~~PAGEINDEX=Nomdelespace~~
Exemple :
~~PAGEINDEX=main:geomatique~~
~~PAGEINDEX=main:geomatique~~
Autre écriture :
{{indexmenu>Nomdelespace|js}}
Exemple :
{{indexmenu>main:geomatique|js}}
{{indexmenu>main:geomatique|js}}
===== Sommaire =====
Désactiver le sommaire :
~~NOTOC~~
===== Syntax Plugins (admin) =====
DokuWiki's syntax can be extended by [[doku>wiki:plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:
~~INFO:syntaxplugins~~