[[Introduction aux Wiki]]
 

Introduction aux Wiki

Les wiki sont des sites web où chacun peut participer, ils sont plus ou moins restrictifs quant à l'autorisation nécessaire pour avoir les droits de créer ou de modifier une page. Sur Paris-Carnet il a été décidé de laisser chacun libre de faire des modifications. Ce qui veut dire :

  • Toutes les pages sont attentivement suivies par une dizaine de blogueurs.
  • Une modification de page ne se justifie que par une amélioration du contenu.
  • Tout est loggué et le retour à l'état précédent se fait en quelques clics.

Introduction à DokuWiki

DokuWiki supporte un langage de balisage simple, qui essaye de faire des pages aussi lisibles que possible. Cette page contient toute la syntaxe possible que vous pouvez employer pour éditer/créer les pages. Allez simplement voir le source de cette page en cliquant sur Editer cette page au bas de cette page. Si vous voulez simplement essayer quelque chose, utilisez le bac à sable. Ce type de marqueur est aussi accessible via les quickbuttons.

Formatage basique du texte

DokuWiki supporte les mises en forme suivantes : texte gras, italique, souligné et à espace constant . Bien sûr vous pouvez les combiner .

DokuWiki supporte les mises en forme suivantes : texte **gras**, //italique//, __souligné__ et 
''à espace constant''. Bien sur vous pouvez les **__//''combiner''//__** .

Vous pouvez avoir : indice et exposant.

 Vous pouvez avoir : <sub>indice</sub> et <sup>exposant</sup>.

Vous pouvez marquer vos corrections aussi.

 Vous pouvez marquer vos <del>corrections</del> aussi.

Les paragraphes sont créés après une ligne vide. Si vous avez besoin d'avoir une ligne vide sans créer un nouveau paragraphe, vous pouvez utiliser deux antislashs à l'endroit de l'espace ou en fin de ligne.

Ce texte pour l'exemple crée un saut
de ligne. Notez que les deux antislashs sont reconnus en fin de ligne
ou s'ils sont suivis
d'un espace \\sinon ils sont inopérants.

 Ce texte pour l'exemple crée un saut \\ de ligne. Notez que les
 deux antislashs sont reconnus en fin de ligne\\
 ou s'ils sont suivis\\ d'un espace \\sinon ils sont inopérants.

Vous ne devriez employer des caractères deux antislashs que si c'est vraiment nécessaire.

Liens

DokuWiki supporte différentes méthodes pour créer des liens.

Externes

Les liens Externes sont reconnus automatiquement: http://www.google.fr ou simplement www.google.fr - Vous pouvez faire des liens avec un nom: Lien vers Google. Les adresses Emails sont aussi reconnues comme ceci: navire@exemple.com

Les liens Externes sont reconnus automatiquement: http://www.google.fr ou simplement www.google.fr 
Vous pouvez faire des liens avec un nom: [[http://www.google.fr|Lien vers Google]]. 
Les adresses Emails sont aussi reconnues comme ceci: <navire@exemple.com>

Internes

Les liens Internes sont créés en utilisant les crochets. Vous pouvez juste donner un nom_de_page ou utiliser un Titre de page additionnel. Les noms de page wiki sont automatiquement convertis en minuscules, les caractères spéciaux ne sont pas autorisés.

Les liens Internes sont créés en utilisant les crochets. Vous pouvez juste donner 
un [[wiki:nom_de_page]] ou utiliser un [[wiki:nom_de_page|Titre de page]] additionnel. 
Les noms de page wiki sont automatiquement convertis en minuscules, les caractères 
spéciaux ne sont pas autorisés.

Vous pouvez aussi faire un lien en ne mettant que le nom précédé de : , exemple: accueil

 Vous pouvez aussi faire un lien en ne mettant que le nom précédé de : , exemple: [[:accueil]]

Pour plus de détail sur les noms des liens internes allez sur :wiki:namespaces.

Créer un lien spécifique à un paragraphe est possible. Ajoutez simplement le caractére hash ⇔# et le nom du paragraphe recherché (comme en html). Pour exemple ce chapitre de cette page.

Pour exemple ce [[syntax#internes|chapitre]] de cette page.

Notes:

Interwiki

DokuWiki supporte les liens InterWiki. Ce sont des liens directs vers d'autres Wiki. Par exemple pour faire un lien vers une page de Wikipedia sur les Wiki: Wiki.

DokuWiki supporte les liens [[wiki:interwiki|InterWiki]]. Ce sont des liens rapides vers d'autres Wiki. 
Par exemple pour faire un lien vers une page de Wikipedia sur les Wiki: [[wp>Wiki]].

Lien en image

Vous pouvez aussi utiliser une image pour faire un lien vers une page interne ou externe en combinant la syntaxe des liens et des images (voir plus bas), exemple:

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

Note: Le formatage d'image est la seule syntaxe de formatage admise dans des noms de lien.

Note de bas de page

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

Vous pouvez ajouter des notes de bas de page ((ceci est une note)) en utilisant une double parenthèse.

Découpage en section

Vous pouvez employer jusqu'à cinq niveaux différents de titres pour structurer votre page. Si vous avez plus de trois titres, une table des matières est produite automatiquement – ceci peut être neutralisé en incluant dans le document ~~NOTOC~~.

Images et autres fichiers


Vous pouvez inclure des images externes ou internes au wiki avec les accolades {}. En option, vous pouvez spécifier leurs tailles.

Taille réelle :

modification de la longueur :

modification de la longueur et de la largeur :

modification image externe :

En employant un espace sur la gauche ou la droite, vous pouvez choisir l'alignement de l'image

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Naturellement, vous pouvez ajouter à l'image, une info bulle qui apparaitra si vous positionnez votre souris dessus.

Info-bulle liée

{{ wiki:dokuwiki-128.png |Info-bulle liée}}

Si vous indiquez un nom de fichier (externe ou interne) qui n'est pas une image (GIF, JPEG, PNG ), alors seule l'adresse du fichier sera affichée.

Listes

Dokuwiki permet les listes ordonnées ou non. Pour créer une liste, décalez votre texte de deux espaces et utilisez un * pour une liste à puces ou un - pour une liste ordonnée.

  • premier élément
  • second élément
    • vous pouvez encore créer un sous niveau
  • puis repartir au niveau supérieur
  1. premier élément numéroté
  2. le second
    1. on peut décaler en section inférieure
  3. puis repartir dans la numérotation supérieure
  * premier élément
  * second élément
    * vous pouvez encore créer un sous niveau
  * puis repartir au niveau supérieur

  - premier élément numéroté
  - le second
    - on peut décaler en section inférieure
  - puis repartir dans la numérotation supérieure

Smileys

DokuWiki convertis les emoticons classiques sous leurs formes graphiques. Vous pouvez augmenter le nombre de Smileys dans le repertoire smiley et en configurant le fichier conf/smileys.conf. Voici une vue d'ensemble des smiley 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 simples des textes, en leurs entités typographiques correctes. Voici un exemple des caractères reconnus.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “Il pense que 'c'est un monde d'homme…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"Il pense que 'c'est un monde d'homme..."

Note: Ces conversions peuvent être arrêtées dans le fichier de config.

Tableaux

DokuWiki utilise une 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 somme 2xCol (notez le double pipe⇒)
Lig 3 Col 1 Lig 3 Col 2 Lig 3 Col 3

Les lignes normales du Tableau doivent commencer et finir par un | ,et pour les en-têtes c'est 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    | somme 2xCol (notez le double pipe=>)||
| Lig 3 Col 1    | Lig 3 Col 2     | Lig 3 Col 3        |

Pour relier des cellules horizontalement, décalez les | comme montré ci-dessus. Soyez sûr d'avoir toujours la même quantité de séparateurs de cellules!

Les en-têtes verticaux sont possibles, aussi.

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 somme cette fois
en tête 5 Lig 3 Col 2 Lig 3 Col 3

Comme vous pouvez voir, c'est le séparateur de cellules avant une cellule qui décide du style de format:

|              ^ 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 somme         |  cette fois        |
^ en tête 5    | Lig 3 Col 2          | Lig 3 Col 3        |

Note: Etendre verticalement n'est pas possible (rowspan).

Vous pouvez aligner le contenu du tableau. Ajoutez simplement deux espaces sur le coté opposé de votre texte: Ajoutez deux espaces sur la gauche pour aligner à droite, deux sur la droite pour aligner à gauche et deux espaces de chaque coté pour centrer le texte.

Tableau avec alignement
droit centré gauche
gauche droit centré
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

voici la source de cet exemple:

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

Blocs non parcourus par le moteur DokuWiki

Vous pouvez inclure des blocs non parcourus (c'est-à-dire que l'affichage sera préservé même si il y a des caractères spéciaux utilisés par DokuWiki) dans vos documents en plaçant au minimum deux espaces devant la ligne (comme utilisé dans les exemples précédents) ou en utilisant les tags code ou file.

(avec code) Ceci est du code préformaté et tous les espaces sont préservés comme              <- ceci.
(avec file) C'est pratiquement la même chose, mais vous pouvez voir que c'est un fichier (fichier de config ou autre) qui est entre les tags.

Pour faire ignorer une zone complète au moteur DokuWiki (c'est-à-dire qu'il n'y aura aucun formatage), entourez le texte avec des tags nowiki ou plus simplement, avec deux signes pourcents %%.

Voici un peu de texte qui contient des adresses comme ceci : http://www.splitbrain.org et du **formatage**, mais rien n'est affiché dans la page générée (que vous êtes en train de lire).

Voyez la source de cette page pour voir comment ces blocs sont utilisés.

Coloration syntaxique

DokuWiki peut colorer syntaxiquement le code source, ce qui le rend plus facile à lire. Il utilise GeSHi Generic Syntax Highlighter – et donc, tous les langages supportés par GeSHi sont supportés. La syntaque est la même que pour les blocs de code de la section précédente, mais cette fois, le nom du langage utilisé doit être inséré dans la tag. Par exemple : <code java>.

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

Les langages suivants sont actuellement reconnus : actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, nsis, objc, oobas, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml

1) ceci est une note
 
wiki/syntax.txt · Dernière modification: 2007/03/05 18:58 par laurent
 
Recent changes RSS feed Creative Commons License Valid XHTML 1.0 Valid CSS Driven by DokuWiki