Différences

Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.

aide 2011/03/27 15:33 version actuelle
Ligne 1: Ligne 1:
 +====== Syntaxe de mise en page ======
 +[[DokuWiki]] utilise un langage de balisage simple, qui essaie de rendre les fichiers de donnes aussi lisibles que possible. Cette page contient toutes les syntaxes possibles que vous pouvez utiliser en ditant les pages. Regardez simplement le code 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 la page du [[playground:playground|bac sable]]. Les balises les plus simples sont aussi facilement accessibles depuis les [[doku>fr:quickbuttons|raccourcis]].
 +
 +===== Mise en forme de texte basique =====
 +
 +DokuWiki accepte les textes en **gras**, //italique//, __soulign__ et '' chasse fixe''.
 +
 +  DokuWiki accepte les textes en **gras**, //italique//, __soulign__ et '' chasse fixe''.
 +
 +Bien sr, vous pouvez tous les **__//''combiner''//__**.
 +
 +  Bien sr, vous pouvez tous les **__//''combiner''//__**.
 +
 +Vous pouvez aussi utiliser <sub>indice</sub> et <sup>exposant</sup>.
 +
 +  Vous pouvez aussi utiliser <sub>indice</sub> et <sup>exposant</sup>.
 +
 +De plus, vous pouvez marquer un passage comme <del>supprim</del>.
 +
 +  De plus, vous pouvez marquer un passage comme <del>supprim</del>.
 +
 +**Les paragraphes** sont crs partir des lignes vides. Si vous souhaitez **forcer un saut de ligne** sans paragraphe, vous pouvez utiliser deux contre-obliques suivies 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.
 +
 +Vous ne devriez forcer des sauts de ligne que si c'est vraiment ncessaire.
 +
 +===== Liens =====
 +
 +DokuWiki propose plusieurs moyens pour crer 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 de courriel comme celle-ci : <andi@splitbrain.org> sont galement reconnues.
 +
 +  Les liens externes sont reconnus automagiquement : 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
 +  de courriel comme celle-ci : <andi@splitbrain.org> sont galement reconnues.
 +
 +==== Internes ====
 +
 +Les liens internes sont crs en utilisant les crochets. Vous pouvez soit juste donner un [[doku>fr:pagename|nom de page]] soit utiliser un [[doku>fr:pagename|texte pour le titre]]. Les noms de pages (//pagenames//) wiki sont convertis automatiquement en minuscules ; les caractres spciaux ne sont pas autoriss.
 +
 +  Les liens internes sont crs en utilisant les crochets. Vous pouvez soit
 +  juste donner un [[nom de page]] soit utiliser un
 +  [[nom de page|texte pour le titre]]. Les noms de pages (//pagenames//) wiki
 +  sont convertis automatiquement en minuscules ; les caractres spciaux ne
 +  sont pas autoriss.
 +
 +Vous pouvez utiliser des [[doku>fr:namespace|catgories]] (//namespaces//) en utilisant les //deux points// ('':'') dans le nom de page //pagename//.
 +
 +  Vous pouvez utiliser des [[catgories]] (//namespaces//) en utilisant les //deux points// ('':'') dans le nom de page //pagename//.
 +
 +Pour plus de dtails sur les catgories (//namespaces//), voir [[doku>fr:namespace|Catgories]].
 +
 +Les liens vers une section spcifique sont galement possibles. Ajoutez simplement le nom de la section aprs un caractre dise (#) comme en HTML. Ce lien renvoie vers [[syntax#internes|cette section]].
 +
 +  Ce lien renvoie vers [[syntax#internes|cette section]].
 +
 +Notes :
 +
 +  * Les liens vers des [[syntax|pages existantes]] sont montrs dans un style diffrent des liens vers des pages [[inexistantes]].
 +  * DokuWiki n'utilise pas la syntaxe [[wpfr>CamelCase]] pour utiliser des liens par dfaut, mais ce comportement peut tre activ dans le fichier de [[doku>fr:config|configuration]]. Astuce : si le mot DokuWiki apparat sur cette page comme un lien, alors c'est que la syntaxe CamelCase est active.
 +  * Lorsque le titre d'une section est modifi, alors son lien change aussi. Donc ne comptez pas trop sur les liens de section.
 +
 +==== Interwiki ====
 +
 +DokuWiki propose les liens [[doku>fr:interwiki|Interwiki]]. Ce sont des liens rapides vers d'autres Wikis. Par exemple ceci est un lien vers la dfinition des Wikis dans Wikipedia en franais : [[wp>fr:Wiki|Wiki]].
 +
 +  DokuWiki propose les liens [[doku>fr:interwiki|Interwiki]]. Ce sont des
 +  liens rapides vers d'autres Wikis. Par exemple ceci est un lien vers la
 +  dfinition des Wikis dans Wikipedia en franais : [[wp>fr:Wiki|Wiki]].
 +
 +
 +
 +==== Partages Windows ====
 +
 +Les partages Windows tels que [[\\serveurnt4\partage|ceci]] sont galement reconnus. Veuillez noter qu'ils n'ont un sens que dans un groupe d'utilisateurs homogne tels qu'un [[wp>Intranet]] d'entreprise.
 +
 +  Les partages Windows tels que [[\\serveur\partage|ceci]] sont galement reconnus.
 +
 +Notes :
 +
 +  * Pour des raisons de scurit, la navigation directe sur partages Windows ne fonctionne que dans //Microsoft Internet Explorer// par dfaut (et seulement dans la zone locale ).
 +  * Pour //Mozilla// et //Firefox//, elle peut tre mise en place dans l'option de configuration [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] mais ceci n'est pas conseill.
 +    * Je viens de tester en passant la valeur "false", mais cel ne change rien !? (mme aprs redmarrage de FF 2.0.0.6 sous Windows)
 +  * Veuillez consulter [[dokubug>151]] pour plus d'informations.
 +
 +
 +==== Liens images ====
 +
 +Vous pouvez aussi utiliser une image afin de crer un lien vers une autre page interne ou externe en combinant les syntaxes des liens et des [[#Images et autres fichiers|images]] (voir plus bas) comme ceci :
 +
 +  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
 +
 +[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
 +
 +NB : la mise en forme image est la seule syntaxe de mise en forme accepte comme nom de lien.
 +
 +Les syntaxes d'[[#Images et autres fichiers|image]] complte et de [[#Liens]] sont possibles (incluant le redimensionnement d'image, les images internes et externes, les URL et les liens interwikis).
 +
 +===== Notes de pied de page =====
 +
 +Vous pouvez ajouter des notes de pied de page ((Ceci est une note de pied de page)) en utilisant des parenthses doubles.
 +
 +  Vous pouvez ajouter des notes de pied de page ((Ceci est une note de pied de page)) en utilisant des parenthses doubles.
 +
 +
 +===== Dcoupage en sections =====
 +
 +Vous pouvez utiliser jusqu' cinq niveaux de titres diffrents afin de **structurer** le contenu. Si vous avez plus de trois titres, une table des matires est construite automatiquement -- ceci peut tre dsactiv en incluant la chane
 +''<nowiki>~~NOTOC~~</nowiki>'' 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 crer une ligne horizontale :
 +
 +----
 +
 +
 +===== Images et autres fichiers =====
 +
 +Vous pouvez inclure des [[doku>fr:images|images]] externes et internes avec des accolades. Vous pouvez spcifier leur taille (facultatif).
 +
 +Taille relle :                                          {{wiki:dokuwiki-128.png}}
 +
 +Redimensionnement une largeur donne :                {{wiki:dokuwiki-128.png?50}}
 +
 +Redimensionnement une largeur et une hauteur donnes : {{wiki:dokuwiki-128.png?200x50}}
 +
 +Image externe redimensionne :                          {{http://de3.php.net/images/php.gif?200x50}}
 +
 +  Taille relle :                                          {{wiki:dokuwiki-128.png}}
 +  Redimensionnement une largeur donne :                {{wiki:dokuwiki-128.png?50}}
 +  Redimensionnement une largeur et une hauteur donnes : {{wiki:dokuwiki-128.png?200x50}}
 +  Image externe redimensionne :                          {{http://de3.php.net/images/php.gif?200x50}}
 +
 +
 +En utilisant des espaces 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 }}
 +
 +Bien sr, vous pouvez aussi ajouter un titre (affich comme une bulle d'aide par la plupart des navigateurs).
 +
 +{{ wiki:dokuwiki-128.png |Ceci est le titre}}
 +
 +  {{ wiki:dokuwiki-128.png |Ceci est le titre}}
 +
 +Si vous spcifiez un nom de fichier (externe ou interne) qui n'est pas une image (''gif, jpeg, png''), alors il sera affich comme un lien et non comme une image.
 +
 +Pour lier une image une autre page, voir [[#Liens images]] ci-dessus.
 +
 +===== Listes =====
 +
 +DokuWiki accepte les listes ordonnes et non ordonnes. Pour crer un lment de liste, indentez votre texte par deux espaces et utilisez une ''*'' pour une liste non ordonne ou un ''-'' pour une liste ordonne.
 +
 +  * Ceci est une liste
 +  * Le second lment
 +    * Vous pouvez avoir plusieurs niveaux
 +  * Un autre lment
 +
 +  - La mme liste mais ordonne
 +  - Un autre lment
 +    - Utilisez simplement l'indentation pour des niveaux plus profonds
 +  - Et voil
 +
 +<code>
 +  * Ceci est une liste
 +  * Le second lment
 +    * Vous pouvez avoir plusieurs niveaux
 +  * Un autre lment
 +
 +  - La mme liste mais ordonne
 +  - Un autre lment
 +    - Utilisez simplement l'indentation pour des niveaux plus profonds
 +  - Et voil
 +</code>
 +
 +
 +===== Emoticnes (smileys) =====
 +
 +DokuWiki transforme les [[wpfr>moticne]]s courantes en leurs quivalents graphiques. Plus d'moticnes (//smileys//) peuvent tre places dans le rpertoire ''smiley'' et configures dans le fichier ''conf/smileys.conf''. Voici une vue d'ensemble des moticnes incluse 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 de simples caractres de texte brut en leurs entits typographiques correctes. Voici un exemple des caractres reconnus.
 +
 +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
 +"He thought 'It's a man's world'..."
 +
 +<code>
 +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
 +"He thought 'It's a man's world'..."
 +</code>
 +
 +NB : Ces conversions peuvent tre dsactives par une option dans le fichier de configuration ou un fichiers de motifs.
 +
 +===== Citations =====
 +
 +Parfois vous souhaitez marquer du texte afin de montrer que c'est une rponse 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 si
 +
 +  > Vraiment ?
 +
 +  >> Oui !
 +
 +  >>> Alors faisons-le !
 +
 +Je pense que nous devrions le faire
 +
 +> Non nous ne devrions pas
 +
 +>> Eh bien, je pense que si
 +
 +> Vraiment ?
 +
 +>> Oui !
 +
 +>>> Alors faisons-le !
 +
 +===== Tableaux =====
 +
 +DokuWiki propose une syntaxe simple pour crer des tableaux.
 +
 +^ Titre 1        ^ Titre 2          ^ Titre 3                            ^
 +| Ligne 1 Col 1  | Ligne 1 Col 2    | Ligne 1 Col 3                      |
 +| Ligne 2 Col 1  | colonnes fusionnes (notez la double barre verticale) ||
 +| Ligne 3 Col 1  | Ligne 2 Col 2    | Ligne 2 Col 3                      |
 +
 +Les lignes de tableau doivent commencer et se terminer avec une //barre verticale// ''|'' pour des lignes normales ou avec un ''^'' pour les titres.
 +
 +  ^ Titre 1        ^ Titre 2          ^ Titre 3                            ^
 +  | Ligne 1 Col 1  | Ligne 1 Col 2    | Ligne 1 Col 3                      |
 +  | Ligne 2 Col 1  | colonnes fusionnes (notez la double barre verticale) ||
 +  | Ligne 3 Col 1  | Ligne 2 Col 2    | Ligne 2 Col 3                      |
 +
 +Pour fusionner des cellules horizontalement, videz simplement compltement la cellule suivante comme il est montr ci-dessus. Assurez-vous d'avoir toujours le mme nombre de sparateurs de cellules !
 +
 +Les titres de tableau verticaux sont galement possibles.
 +
 +|              ^ Titre 1                  ^ Titre 2          ^
 +^ Titre 3      | Ligne 1 Col 2            | Ligne 1 Col 3    |
 +^ Titre 4      | pas de fusion cette fois |                  |
 +^ Titre 5      | Ligne 2 Col 2            | Ligne 2 Col 3    |
 +
 +Comme vous pouvez le constater, c'est le sparateur ('|' ou '^') prcdant une cellule qui dtermine le format :
 +
 +  |              ^ Titre 1                  ^ Titre 2          ^
 +  ^ Titre 3      | Ligne 1 Col 2            | Ligne 1 Col 3    |
 +  ^ Titre 4      | pas de fusion cette fois |                  |
 +  ^ Titre 5      | Ligne 2 Col 2            | Ligne 2 Col 3    |
 +
 +NB : les fusions verticales ne sont pas possibles.
 +
 +Vous pouvez galement aligner les contenus du tableau. Ajoutez simplement au moins deux espaces l'extrmit oppose de votre texte : ajoutez deux espaces sur la gauche pour aligner droite, deux espaces sur la droite pour aligner gauche et deux espaces au moins chaque extrmit pour centrer le texte.
 +
 +^          Tableau avec alignement        ^^^
 +|        droite|    centr    |gauche        |
 +|gauche        |        droite|    centr    |
 +| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
 +
 +Voici quoi a ressemble dans le code source :
 +
 +  ^          Tableau avec alignement        ^^^
 +  |        droite|    centr    |gauche        |
 +  |gauche        |        droite|    centr    |
 +  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
 +
 +===== Blocs non analyss =====
 +
 +Vous pouvez inclure des blocs non analyss dans vos documents soit en les indentant avec au moins deux espaces (comme on peut le voir dans les exemples prcdents) soit en utilisant les balises ''code'' ou ''file''.
 +
 +
 +<code>
 +Ceci est du code prformat, tous les espaces sont prservs : comme          <-ceci
 +</code>
 +
 +<file>
 +Ceci est pratiquement la mme chose, mais vous pouvez l'utiliser pour montrer que vous avez cit un fichier.
 +</file>
 +
 +Pour laisser l'analyseur ignorer compltement un bloc (comme ne pas faire lui appliquer de mise en forme), encadrez ce bloc soit avec des balises ''nowiki'' ou, encore plus simple, avec des caractres pourcent doubles ''<nowiki>%%</nowiki>''.
 +
 +<nowiki>
 +Voici du texte qui contient des adresses comme ceci : http://www.spiltbrain.org et de la **mise en forme**, mais rien ne se passe.
 +</nowiki>
 +
 +Consultez le code source de cette page pour voir comment utiliser ces blocs.
 +
 +===== Coloration syntaxique =====
 +
 +[[DokuWiki]] peut mettre en forme et en couleur du code source, ce qui facilite sa lecture. Il utilise le Generic Syntax Highlighter [[http://qbnz.com/highlighter/|GeSHi]] -- donc n'importe quel langage connu de GeSHi est accept. La syntaxe est la mme que dans le bloc de code dans la section prcdent, mais cette fois le nom du langage utilis est insre dans la balise. Par exemple : ''<nowiki><code java></nowiki>''.
 +
 +<code java>
 +/**
 + * La classe HelloWorldApp implemente une application qui
 + * affiche simplement "Hello World!" dans la sortie standard.
 + */
 +class HelloWorldApp {
 +    public static void main(String[] args) {
 +        System.out.println("Hello World!"); //Affiche la chane.
 +    }
 +}
 +</code>
 +
 +Les identificateurs de langage suivants sont actuellement reconnus : //actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, plsql, python, qbasic, rails, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml, xpp, z80//
 +
 +
 +
 +
 +===== Agrgation de fils RSS/ATOM =====
 +[[DokuWiki]] peut agrger les donnes de fils XML externes. Pour l'analyse des fils XML, [[http://simplepie.org/|SimplePie]] est utilis. Tous les formats connus de SimplePie peuvent aussi tre utiliss dans DokuWiki. Vous pouvez modifier le comportement en ajoutant plusieurs paramtres spars par des espaces :
 +
 +^ Paramtre  ^ Description ^
 +| tout nombre | sera utilis comme le nombre maximum d'lments montrer, 8 par dfaut |
 +| reverse    | affiche les derniers lments en premier dans le fil |
 +| author      | affiche le nom des auteurs des lments |
 +| date        | affiche les dates des lments |
 +| description | affiche les descriptions des lments. Si [[doku>config#htmlok|HTML]] est dsactiv, toutes les tiquettes (//tags//) seront enleves |
 +| //n//[dhm]  | dure de rafrachissement, ou d=days (jours), h=heures, m=minutes. (Par exemple 12h = 12 heures). |
 +
 +La dure de rafrachissement est par dfaut de 4 heures. Toute valeur infrieure 10 minutes sera traite comme 10 minutes. [[DokuWiki]] essaiera en gnral de fournir une version de la page partir du cache, videmment, cela est inadapt quand la page a un contenu dynamique externe. Le paramtre dit [[DokuWiki]] de rengendrer la page s'il y a plus que la //dure de rafrachissement// depuis que la page a t engendre pour la dernire fois.
 +
 +**Exemple :**
 +
 +  {{rss>http://slashdot.org/index.rss 5 author date 1h }}
 +
 +{{rss>http://slashdot.org/index.rss 5 author date 1h }}
 +
 +===== Inclure du code HTML ou PHP =====
 +
 +Vous pouvez inclure du code HTML ou PHP pur dans vos documents en utilisant les balises ''html'' ou ''php'' comme ceci :
 +<code>
 +<html>
 +Ceci est du <font color="red" size="+1">HTML</font>
 +</html>
 +</code>
 +
 +<html>
 +Ceci est du <font color="red" size="+1">HTML</font>
 +</html>
 +
 +<code>
 +<php>
 +echo 'Un logo produit par PHP :';
 +echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Logo PHP !" />';
 +</php>
 +</code>
 +
 +<php>
 +echo 'Un logo produit par PHP :';
 +echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Logo PHP !" />';
 +</php>
 +
 +**NB** : L'inclusion de code HTML et PHP est dsactive dans la configuration par dfaut. Dans ce cas, le code est affich au lieu d'tre excut.
 +
 +===== Extensions de syntaxe =====
 +
 +La syntaxe de DokuWiki peut tre tendue par des [[doku>fr:plugins|extensions]]. Comment utiliser les extensions installes est dcrit dans leurs pages de description respectives. Les extensions de syntaxe suivantes sont disponibles dans cette installation particulire de DokuWiki :
 +
 +~~INFO:syntaxplugins~~
aide.txt · Dernière modification: 2011/03/27 15:33 (édition externe)
Haut de page
chimeric.de = chi`s home Creative Commons License Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0