====== Syntaxe de formatage ====== [[wiki:DokuWiki]] supporte un langage simple de balises pour rendre les fichiers de données aussi lisible que possible. Cette page décrit de maniére compléte la syntaxe que vous pouvez utilisez pour éditer les pages. Jetez simplement un oeil au source de la page en cliquant sur le bouton //Editer la page// en haut ou en bas de la page. Si vous voulez faire des essais, utilisez le [[tutoriel:takanacity|bac à sable]]. Les balises sont également accessibles via la barre d'outils. En général pour créer une nouvelle page, créez un lien dans une page parente déja existante (voir la syntaxe des liens plus bas). En cliquant sur ce nouveau lien (rouge), vous accederez à cette page pour pouvoir éditer son contenu. Pour ne pas vous trompez, copiez collez le code d'un lien déja présent sur la page parente que vous éditez... faites bien attention à respecter les catégories. Bon post ;) ===== Formatage basique de texte ===== DokuWiki supporte le texte **gras**, //italique//, __souligné__ et à ''largeur fixe''. Bien évidemment, vous pouvez les **__//''combiner''//__**. DokuWiki supporte le texte **gras**, //italique//, __souligné__ et à ''largeur fixe''. Bien évidemment, vous pouvez les **__//''combiner''//**. Vous pouvez également écrire en indice et en exposant. Vous pouvez également écrire en indice et en exposant. Vous pouvez montrer qu'une suite de mots a été supprimée comme ça. Vous pouvez montrer qu'une suite de mots a été supprimée comme ça. Les paragraphes sont créés à partir de lignes vides. Si vous voulez forcer le retour à la ligne sans créer de paragraphe, vous pouvez utiliser deux anti-slashs suivi d'un espace ou d'une fin de ligne. Voici du texte avec des sauts de ligne\\ Notez que les deux anti-slashs sont seulement reconnus à la fin d'une ligne\\ ou suivi d'un\\ espace. \\Voici ce qui arrive sans. Voici du texte avec des sauts de ligne\\ Notez que les deux anti-slashs sont seulement reconnus à la fin d'une ligne\\ ou suivi d'un\\ espace. \\Voici ce qui arrive sans. Ne forcez les retours à la ligne que si c'est vraiment nécessaire. ===== Commentaires ===== Vous pouvez faire en sorte que les gens puissent laisser des commentaires sur votre article en inserant n'importe ou la balise : ~~DISCUSSION~~ ===== Liens ===== DokuWiki supporte plusieurs manières de créer des liens. ==== Externe ==== Les liens externes sont reconnus automatiquement : http://www.google.fr ou simplement www.google.fr - Vous pouvez également définir un libellé pour le lien : [[http://www.google.fr|Ce lien pointe vers google]]. Les adresses mail sont également reconnues, par exemple : . Les liens externes sont reconnus automatiquement : http://www.google.fr ou simplement www.google.fr - Vous pouvez également définir un libellé pour le lien : [[http://www.google.fr | Ce lien pointe vers google]]. Les adresses mail sont également reconnues, par exemple : . ==== Interne ==== Les liens internes sont créés en utilisant des crochets. Vous pouvez soit donner juste un [[tutoriels:nomdepage]] ou utiliser un [[tutoriels: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 [[tutoriels:nomdepage]] ou utiliser un [[tutoriels:nomdepage|Titre]]. Les noms de page Wiki sont automatiquement convertis en minuscules et les caractères spéciaux ne sont pas admis. Vous **DEVEZ** utiliser des [[wiki:categories]] en tapant deux points dans le nom de la page. Vous DEVEZ utiliser des [[wiki:categories]] en tapant deux points dans le nom de la page. Par exemple, dans les thèmes, une catégorie s'appelle flash. Si vous réalisez un tutoriel pour cette section, il faut renseigner l'url de la catégorie correspondante : [[flash:votre_tutoriel|votre_tutoriel]] Pour la syntaxe : [[flash:votre_tutoriel|votre_tutoriel]] ===== 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)). ===== 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 images internes ou externes avec des accolades. Les images internes peuvent être uploadées sur le Wiki par l'intermédiaire du bouton image (dans la barre des boutons)... En cliquant sur l'image uploadée, un lien s'insère automatiquement. Vous pouvez éventuellement spécifier leur taille. Taille réelle : {{http://de3.php.net/images/php.gif}} Modifier la largeur : {{http://de3.php.net/images/php.gif?200}} Redimensionner : {{http://de3.php.net/images/php.gif?200x200}} Redimensionner une image externe : {{http://de3.php.net/images/php.gif?100x100}} Taille réelle : {{http://de3.php.net/images/php.gif}} Modifier la largeur : {{http://de3.php.net/images/php.gif?200}} Redimensionner : {{http://de3.php.net/images/php.gif?200x200}} Redimensionner une image externe : {{http://de3.php.net/images/php.gif?100x100}} En laissant un espace à gauche ou à droite, vous pouvez choisir l'alignement {{ http://wiki.splitbrain.org/media/wiki/php-powered.png}} {{http://wiki.splitbrain.org/media/wiki/php-powered.png }} {{ http://wiki.splitbrain.org/media/wiki/php-powered.png }} Vous pouvez bien évidemment ajouter un titre (affiché dans une info-bulle sur la plupart des navigateurs). {{ http://wiki.splitbrain.org/media/wiki/php-powered.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. ===== 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. ===== 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''. Voici du texte préformaté où tous les espaces sont conservés : comme <-ça C'est quasiment la même chose mais vous pouvez utilisez cela 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 suivantes correspondant au langage sont acceptées : * action-script * ada * apache * asm * bash * c * c_mac * caddc * cadlisp * cpp * csharp * css * delphi * html4strict * java * javascript * nsis * objc * oobas * pascal * perl * php * php-brief * python * qbasic * smarty * sql * vb * sbnet * visualfoxpro * xml ----------------------------------------------------------------------------------- Source : [[http://www.forum-2d.com/wiki/wiki/syntax?do=show]]