Différences

Ci-dessous, les différences entre deux révisions de la page.

--- wiki:syntax [19-10-2009 17:20]
111110101011 Traduction française
+++ wiki:syntax [26-02-2012 10:18]
edmc73 Links to playground:playground changed to wiki:bacasable
@@ Ligne 1: / Ligne 1: @@
 ====== Syntaxe de mise en page ======
-[[DokuWiki]] utilise un langage de balisage simple, qui essaie de rendre les fichiers de données 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:toolbar|raccourcis]].
+[[DokuWiki]] utilise un langage de balisage simple, qui essaie de rendre les fichiers de données 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 [[bacasable|bac à sable]]. Les balises les plus simples sont aussi facilement accessibles depuis les [[doku>fr:toolbar|raccourcis]].
 ===== Mise en forme de texte basique =====
@@ Ligne 40: / Ligne 39: @@
 ==== Externes ====
-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.
+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
+  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.
 ==== Internes ====
@@ Ligne 57: / Ligne 58: @@
   sont pas autorisés.
-Vous pouvez utiliser des [[doku>fr:namespace|catégories]] (//namespaces//) en utilisant les //deux points// ('':'') dans le nom de page //pagename//.
+Vous pouvez utiliser des [[doku>fr:namespaces|catégories]] (//namespaces//) en utilisant les //deux points// ('':'') dans le nom de page //pagename//.
   Vous pouvez utiliser des [[catégories]] (//namespaces//) en utilisant les //deux points// ('':'') dans le nom de page //pagename//.
-Pour plus de détails sur les catégories (//namespaces//), voir [[doku>fr:namespace|Catégories]].
+Pour plus de détails sur les catégories (//namespaces//), voir [[doku>fr:namespaces|Catégories]].
 Les liens vers une section spécifique sont également possibles. Ajoutez simplement le nom de la section après un caractère dièse (#) comme en HTML. Ce lien renvoie vers [[syntax#internes|cette section]].
@@ Ligne 80: / Ligne 81: @@
   liens rapides vers d'autres Wikis. Par exemple ceci est un lien vers la
   définition des Wikis dans Wikipedia en français : [[wp>fr:Wiki|Wiki]].
@@ Ligne 93: / Ligne 93: @@
   * Pour des raisons de sécurité, la navigation directe sur partages Windows ne fonctionne que dans //Microsoft Internet Explorer// par défaut (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 !? (même après redémarrage de FF 2.0.0.6 sous Windows)
+     * Je viens de tester en passant la valeur à "false", mais cela ne change rien !? (même après redémarrage de FF 2.0.0.6 sous Windows)
+     * Tiré de l'URL ci-dessus : "This preference only works in Gecko versions before 1.8 (so Firefox 1.0 and Mozilla Suite builds). In Firefox 1.5 and Seamonkey 1.0 this preference no longer has an effect." (Cette préférence n'est plus disponible dans les versions de Firefox supérieures à 1.5)
   * Veuillez consulter [[dokubug>151]] pour plus d'informations.
 ==== Liens images ====
@@ Ligne 134: / Ligne 133: @@
 ----
+\\
+<code>----</code>
 ===== Images et autres fichiers =====
@@ Ligne 144: / Ligne 143: @@
 Redimensionnement à une largeur donnée :                 {{wiki:dokuwiki-128.png?50}}
-Redimensionnement à une largeur et une hauteur données((Si les proportions de l'image ne sont pas respectées, celle-ci sera <<découpé>> avant redimensionnement selon les nouvelles proportions)) : {{wiki:dokuwiki-128.png?200x50}}
+Redimensionnement à une largeur et une hauteur données((Si les proportions de l'image ne sont pas respectées, celle-ci sera <<découpée>> avant redimensionnement selon les nouvelles proportions)) : {{wiki:dokuwiki-128.png?200x50}}
 Image externe redimensionnée :                           {{http://de3.php.net/images/php.gif?200x50}}
@@ Ligne 172: / Ligne 171: @@
   {{ wiki:dokuwiki-128.png |Ceci est le titre}}
+On peut proposer une image en téléchargement sans l'afficher, en utilisant ''?linkonly'' après le nom de l'image
+{{ wiki:dokuwiki-128.png?linkonly|le logo de DokuWiki}}
+  {{ wiki:dokuwiki-128.png?linkonly|le logo de DokuWiki}}
 Si vous spécifiez 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.
@@ Ligne 202: / Ligne 208: @@
 </code>
+Vous pouvez aussi consulter notre [[fr:faq:lists|FAQ sur les listes]]
-===== Emoticônes (smileys) =====
+===== Conversions textuelles =====
+DokuWiki peut convertir certains caractères ou chaines de caractère prédéfinis en image, autre texte, ou HTML.
+Les conversions en image sont principalement utilisée pour les émoticônes (//smileys//). Les conversions en texte ou HTML sont utilisées pour des raisons de typographie, mais peuvent également être configurées pour utiliser d'autres balises HTML.
+==== Emoticônes (smileys) ====
 DokuWiki transforme les [[wpfr>Émoticône]]s courantes en leurs équivalents graphiques. Plus d'émoticônes (//smileys//) peuvent être placées dans le répertoire ''smiley'' et configurées dans le fichier ''conf/smileys.conf''. Voici une vue d'ensemble des émoticônes incluse dans DokuWiki.
@@ Ligne 228: / Ligne 241: @@
   * DELETEME %% DELETEME %%
-===== Typographie =====
+==== Typographie ====
 [[DokuWiki]] peut convertir de simples caractères de texte brut en leurs entités typographiques correctes. Voici un exemple des caractères reconnus.
@@ Ligne 240: / Ligne 253: @@
 </code>
-NB : Ces conversions peuvent être désactivées par une option dans le fichier de configuration ou un fichiers de motifs.
+Il est possible de faire la même chose pour n'importe quelle balise HTML. Il suffit pour cela de rajouter une ligne dans le [[fr:entities|fichier de motifs]].
+Il existe trois exceptions à ce mécanisme. le symbole de multiplication (640x480), les %%'%%apostrophes%%'%% et les "guillemets". On peut toutefois désactiver ces trois substitutions par une [[fr:config:typography|option de configuration]].
 ===== Citations =====
@@ Ligne 302: / Ligne 316: @@
   ^ Titre 5      | Ligne 2 Col 2            | Ligne 2 Col 3    |
-NB : les fusions verticales ne sont pas possibles.
+Vous pouvez fusionner des cellules verticalement en ajoutant ::: dans les cellules sous celles avec laquelle elles doivent fusionner.
+:!: Cette fonctionnalité n'est disponible que pour les versions supérieures à 2009-02-14b
-Vous pouvez également aligner les contenus du tableau. Ajoutez simplement au moins deux espaces à l'extrémité opposée 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 extrémité pour centrer le texte.
+^ Titre 1       ^ Titre 2                                  ^ Titre 3       ^
+| Ligne 1 Col 1 |  Cette cellule s'étend\\ verticalement   | Ligne 1 Col 3 |
+| Ligne 2 Col 1 | :::                                      | Ligne 2 Col 3 |
+| Ligne 3 Col 1 | :::                                      | Ligne 3 Col 3 |
+Ces cellules ne doivent rien contenir d'autre que l'indicateur de fusion vertical.
+  ^ Titre 1       ^ Titre 2                                  ^ Titre 3       ^
+  | Ligne 1 Col 1 |  Cette cellule s'étend\\ verticalement   | Ligne 1 Col 3 |
+  | Ligne 2 Col 1 | :::                                      | Ligne 2 Col 3 |
+  | Ligne 3 Col 1 | :::                                      | Ligne 3 Col 3 |
+Vous pouvez également aligner les contenus du tableau (uniquement horizontalement). Ajoutez simplement au moins deux espaces à l'extrémité opposée 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 extrémité pour centrer le texte.
 ^          Tableau avec alignement         ^^^
@@ Ligne 332: / Ligne 360: @@
 Pour laisser l'analyseur ignorer complètement 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 caractères 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>
 <nowiki>
@@ Ligne 339: / Ligne 371: @@
 Consultez le code source de cette page pour voir comment utiliser ces blocs.
-===== Coloration syntaxique =====
+==== 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 même que dans le bloc de code de la section précédente, mais cette fois le nom du langage utilisé est inséré dans la balise. Par exemple : ''<nowiki><code java></nowiki>''.
@@ Ligne 345: / Ligne 377: @@
 <code java>
 /**
- * La classe HelloWorldApp implemente une application qui
+ * La classe HelloWorldApp implémente une application qui
  * affiche simplement "Hello World!" dans la sortie standard.
  */
@@ Ligne 355: / Ligne 387: @@
 </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//
+Les identificateurs de langage suivants sont actuellement reconnus : //4cs, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, ecmascript, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, z80//
+==== Bloc de code téléchargeables ====
+Quand vous utilisez les balises //%%<code>%%// ou //%%<file>%%//, vous pouvez rendre disponible en téléchargement le code affiché. Il faut alors préciser un nom de fichier juste après le code du langage.
+<file php monexemple.php>
+<?php echo "hello world!"; ?>
+</file>
+  <file php monexemple.php>
+  <?php echo "hello world!"; ?>
+  </file>
+Si vous ne voulez pas de coloration syntaxique, il suffit de fournir un tiret (-) en guise de code de langage:\\
+ %%<code - monfichier.toto>%%.
 ===== Agrégation de fils RSS/ATOM =====
@@ Ligne 371: / Ligne 416: @@
 | //n//[dhm]  | durée de rafraîchissement, ou d=days (jours), h=heures, m=minutes. (Par exemple 12h = 12 heures). |
-La durée de rafraîchissement est par défaut de 4 heures. Toute valeur inférieure à 10 minutes sera traitée comme 10 minutes. [[DokuWiki]] essaiera en général de fournir une version de la page à partir du cache, évidemment, cela est inadapté quand la page a un contenu dynamique externe. Le paramètre dit à [[DokuWiki]] de réengendrer la page s'il y a plus que la //durée de rafraîchissement// depuis que la page a été engendrée pour la dernière fois.
+La durée de rafraîchissement est par défaut de 4 heures. Toute valeur inférieure à 10 minutes sera traitée comme 10 minutes. [[DokuWiki]] essaiera en général de fournir une version de la page à partir du cache, évidemment, cela est inadapté quand la page a un contenu dynamique externe. Le paramètre dit à [[DokuWiki]] de ré-engendrer la page s'il y a plus que la //durée de rafraîchissement// depuis que la page a été engendrée pour la dernière fois.
 **Exemple :**

Outils pour utilisateurs

Outils du site

Différences

Outils de la page