Outils pour utilisateurs

Outils du site


autres:syntaxe_wiki

Syntaxe

DokuWiki permet l'utilisation d'une syntaxe destinée à rendre les documents aussi lisibles que possible. Cette page recense l'ensemble des raccourcis typographiques que vous pouvez utiliser pour l'édition des pages du wiki. Vous pouvez facilement voir la forme brute de cette page en cliquant sur Modifier cette page qui se trouve en haut et en bas de page. Si vous voulez expérimenter et vous perfectionner, utilisez la page bac_a_sable. Ci dessous vous trouverez des exemples du texte une fois publié, suivi de celui-ci tel qu'il a été saisi (dans un encadré).

Edition simple de texte

DokuWiki accepte les mises en forme suivantes : gras, italique, souligné et chasse fixe. Bien sûr, vous pouvez combiner ces mises en formes.

DokuWiki accepte les mises en forme suivantes : **gras**, //italique//, __souligné__ et ''chasse fixe''. 
Bien sûr, vous pouvez     **__//''combiner''//__** ces mises en formes.

Vous pouvez aussi utiliser indice et exposant.

Vous pouvez aussi utiliser <sub>indice</sub> et <sup>exposant</sup>.

Pour créer un paragraphe, il vous suffit d'insérer une ligne vide. Si vous voulez simplement insérer un retour à la ligne, utilisez deux backslash (altgr + 8) suivi d'un espace ou d'un retour à la ligne.

Ceci est un texte avec un retour à la ligne
Noter que le double backslash n'est reconnu qu'à la fin d'une ligne
ou s'il est suivi par
un espace \\.

Ceci est un texte avec un retour à la ligne\\ Noter que le double backslash
n'est reconnu qu'à la fin d'une ligne\\
ou s'il est suivi par\\ un espace \\.

D'une manière générale, utilisez cette option avec parcimonie.

Liens

DokuWiki permet plusieurs options pour créer un lien.

Externes

Les liens externes sont reconnus automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez nommer vos liens : Ce lien pointe vers Google. Pour les adresses email: webmaster@nuxo.net est reconnu.

Les liens externe sont reconnus automatiquement : http://www.google.com ou 
simplement www.google.com - Vous pouvez nommer vos liens : 
[[http://www.google.com|Ce lien pointe vers Google]]. Pour les adresses email:
<[email protected]> est reconnu.

Internes

Les liens internes (renvoyant à d'autres pages de ce site) sont créés simplement via l'adjonction de double crochets. Vous pouvez soit vous contenter d'utiliser le nom de la page du wiki wiki:nomdepage ou ajouter en plus une infobulle Titre. Les noms de page wiki sont automatiquement convertis en minuscule par convention, les caractères spéciaux sont exclus.

Les liens internes (renvoyant à d'autres pages de ce site) sont créés 
simplement via l'adjonction de double crochets. Vous pouvez soit vous 
contenter d'utiliser le nom de la page du wiki [[doku>wiki:nomdepage]] ou 
ajouter en plus une infobulle [[doku>wiki:nomdepage|Titre]]. Les noms de
page wiki sont automatiquement convertis en minuscule par convention, les
caractères spéciaux sont exclus. 

Les liens vers une rubrique spécifique sont également possibles. Ajouter le nom de section au lien à l'aide d'un dièse comme dans l'exemple suivant Cette section.

comme dans l'exemple suivant [[:syntax#Internes|Cette section]].

Notes:

  • Les liens vers des pages existantes apparaissent différemment de ceux pointant vers celles n_existant_pas_encore.
  • Quand le titre d'une section est modifié, les liens relatifs à cette section ne fonctionneront plus, il est donc préférable d'éviter d'y recourir.

Interwiki

DokuWiki permet de créer les liens wiki:interwiki. Ils s'agit de liens rapides vers d'autres wikis. Ce lien vers la page de Wikipedia sur les wikis: Wiki.

DokuWiki permet de créer les liens [[doku>wiki:interwiki]]. Ils s'agit de
liens rapides vers d'autres wikis. Ce lien vers la page de Wikipedia sur les 
wikis: [[wp>Wiki]].

Partage Windows

Les partages réseau sous Windows fichier sont reconnus. Ces liens sont donc réservés à une application wiki sur un intranet ou un réseau local.

Les partages réseau sous Windows [[\\serveur\partage|fichier]] sont reconnus.

Liens illustrés

Vous pouvez également illustrer vos liens par une image de la manière suivante :

[[http://www.php.net|{{wiki:php-powered.png}}]]

Note de bas de page

Vous pouvez ajouter des notes de bas de page 1) en utilisant la double parenthèse.

Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page))

Sections

Vous pouvez utiliser jusqu'à 5 niveaux de hiérarchisation pour le contenu du wiki. Si vous avez plus de 3 chapitres, une table des matière est générée automatiquement – Cette fonction peut être désactivée en utilisant la commande suivante ~~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 4 tirets (touche 6) vous pouvez insérer une ligne horizontale:


Images et autres fichiers

Vous pouvez insérer des images images de la manière suivante :

Pour des images hébergées sur le serveur du site :

Pleine taille:

Redimensionnée en largeur (pixels) :

Redimensionnée en L par H :

Pleine taille:             {{wiki:php-powered.png}}
Redimensionnée en largeur (pixels) : {{wiki:php-powered.png?100}}
Redimensionnée en L par H :  {{wiki:php-powered.png?100x100}}

Pour des images avec lien sur un autre site :

Pleine taille :

Redimensionnée :

Pleine taille :      {{http://de3.php.net/images/php.gif}}
Redimensionnée : {{http://de3.php.net/images/php.gif?100x100}}

En utilisant un espace avant ou après vous pouvez aligner à droite, à gauche, pour centrer simplement insérer un espace avant et après :

{{ wiki:php-powered.png}}
{{wiki:php-powered.png }}
{{ wiki:php-powered.png }}

Et bien sûr vous pouvez ajouter une légende, toujours selon la même logique (qui sera affichée comme infobulle par la plupart des navigateurs):

Légende

{{ wiki:php-powered.png |Légende}}

Si vous spécifiez un lien (externe ou interne) qui n'est pas une image (gif,jpeg,png) celui-ci sera affiché comme un lien de téléchargement.

Listes

Dokuwiki permet de créer facilement des listes ordonnées ou non. Pour créer une liste, insérez deux espaces et ajouter * pour les listes non-ordonnées (points) ou un - pour les listes ordonnées (1,2,3…).

  • Ceci est une liste
  • Deuxième item
    • Vous pouvez insérer des sous niveau avec deux espaces
  • Autre item
  1. Même liste mais ordonnée
  2. Autre item
    1. Indentez de deux espace pour descendre d'un niveau
  3. Et voilà
  * Ceci est une liste
  * Deuxième item
    * Vous pouvez insérer des sous niveau avec deux espaces
  * Autre item

  - Même liste mais ordonnée
  - Autre item
    - Indentez de deux espace pour descendre d'un niveau
  - Et voilà

Emoticones

DokuWiki remplace les emoticones les plus utilisées par leur équivalent graphique. Voici un aperçu de ceux disponibles :

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

Typographie

DokuWiki Peut convertir des caractères simple en leur équivalent typographique. Voici un exemple des 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'..."

Tableaux

DokuWiki offre une syntaxe très simple pour créer des tableaux grâce au caractère “pipe” (altgr+6).

Titre 1 Titre 2 Titre 3
Ligne 1 Colonne 1 Ligne 1 Colonne 2 Ligne 1 Colonne 3
Ligne 2 Colonne 1 Une fusion de ligne (notez le double pipe)
Ligne 3 Colonne 1 Ligne 2 Colonne 2 Ligne 2 Colonne 3

Les lignes d'un tableau doivent commencer et finir par un pipe | et par un ^ pour les titres.

^ Titre 1      ^ Titre 2       ^ Titre 3          ^
| Ligne 1 Colonne 1    | Ligne 1 Colonne 2     | Ligne 1 Colonne 3        |
| Ligne 2 Colonne 1    | Une fusion de ligne (notez le double pipe) || 
| Ligne 3 Colonne 1    | Ligne 2 Colonne 2     | Ligne 2 Colonne 3        |

To connect cells horizontally just make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators!

Les tableaux a double entrée sont aussi bien sûr possibles.

Titre 1 Titre 2
Titre 3 Ligne 1 Colonne 2 Ligne 1 Colonne 3
Titre 4 no colspan this time
Titre 5 Ligne 2 Colonne 2 Ligne 2 Colonne 3

Comme vous pouvez le remarquer, c'est le séparateur de la cellule qui conditionne le formatage du tableau :

|              ^ Titre 1            ^ Titre 2          ^
^ Titre 3    | Ligne 1 Colonne 2          | Ligne 1 Colonne 3        |
^ Titre 4    | no colspan this time |                    |
^ Titre 5    | Ligne 2 Colonne 2          | Ligne 2 Colonne 3        |

Note : la fusion de colonnes n'est pas possible.

Eléments bruts

Vous pouvez inclure des éléments qui ne seront pas traité par le processeur syntaxique du Wiki en incluant deux espace en début de ligne ou en utilisant la balise code ou file.

Ceci est un exemple de code <a href="http://www.km-fr.com">km-fr.com</a>
<file>
Vous pouvez utiliser cette balise pour faire réference à un fichier externe.  
</file>

Pour forcer le processeur syntaxique à ignorer complètement un passage, utiliser soit la balise nowiki, %%.

Ceci est un passage qui n'est pas pris en compte par le processeur syntaxique http://www.splitbrain.org et **gras** auquel aucun formatage n'est appliqué.

1)
Ceci est une note de bas de page
autres/syntaxe_wiki.txt · Dernière modification: 2012/02/10 23:24 (modification externe)