Différences

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

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
wiki:syntax [2014/01/31 21:14] – import syntax wiki from official dokuwiki website minimiwiki:syntax [2017/12/05 17:11] (Version actuelle) – Page wikisynctaxe ayant été effacée mais toujours référencée alex
Ligne 1: Ligne 1:
 ====== Syntaxe de mise en page ====== ====== Syntaxe de mise en page ======
- +[[doku>fr:dokuwiki|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 //Modifier 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 [[playground:playground|bac à sable]]. Les balises les plus simples sont aussi facilement accessibles depuis les [[doku>fr:toolbar|raccourcis]].+
  
 ===== Mise en forme de texte basique ===== ===== 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 sûr, vous pouvez tous les **__//''combiner''//__**.
  
-  DokuWiki accepte les textes en **gras**, //italique//, __souligné__ et ''à chasse fixe''. 
  
-Bien sûr, vous pouvez tous les **__//''combiner''//__**.+  DokuWiki accepte les textes en **gras**, //italique//, __souligné__ et ''à chasse fixe''Bien sûr, vous pouvez tous les **__//''combiner''//__**.
  
-  Bien sûr, vous pouvez tous les **__//''combiner''//__**.+Vous pouvez aussi utiliser des <sub>indices</sub> et <sup>exposants</sup>.
  
-Vous pouvez aussi utiliser <sub>indice</sub> et <sup>exposant</sup>+  Vous pouvez aussi utiliser des <sub>indices</sub> et <sup>exposants</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>.
Ligne 39: Ligne 35:
 ==== Externes ==== ==== 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. 
  
-  Les liens externes sont reconnus « automatiquement » : http://www.google.fr +  Les liens externes sont reconnus automagiquement : http://www.google.fr 
   ou simplement www.google.fr - Vous pouvez aussi donner des noms aux    ou simplement www.google.fr - Vous pouvez aussi donner des noms aux 
   liens : [[http://www.google.fr|Ce lien pointe vers Google]]. Les adresses    liens : [[http://www.google.fr|Ce lien pointe vers Google]]. Les adresses 
Ligne 50: Ligne 46:
 ==== Internes ==== ==== Internes ====
  
-Les liens internes sont créés 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 caractères spéciaux ne sont pas autorisés.+Les liens internes sont créés en utilisant des crochets. Vous pouvez juste utiliser un [[nom de page]] ou utiliser un [[nom de page|texte de lien]]. 
 + 
 +  Les liens internes sont créés en utilisant des crochets. Vous pouvez juste 
 +  utiliser un [[nom de page]] ou utiliser un [[nom de page|texte de lien]].
  
-  Les liens internes sont créés en utilisant les crochets. Vous pouvez soit +Les [[doku>fr:pagename|noms de pages wiki]] sont automatiquement convertis en minuscules ; les caractères spéciaux ne sont pas autorisés.
-  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 caractères spéciaux ne +
-  sont pas autorisés.+
  
-Vous pouvez utiliser des [[doku>fr:namespaces|catégories]] (//namespaces//en utilisant les //deux points// ('':''dans le nom de page //pagename//.+Vous pouvez utiliser les [[voici:des:categories]] en utilisant les deux points dans le nom de page.
  
-  Vous pouvez utiliser des [[catégories]] (//namespaces//en utilisant les //deux points// ('':''dans le nom de page //pagename//.+  Vous pouvez utiliser les [[voici:des:categories]] en utilisant 
 +  les deux points dans le nom de page.
  
-Pour plus de détails sur les catégories (//namespaces//), voir [[doku>fr:namespaces|Catégories]].+Pour plus de détails sur les catégories, 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]].+Les liens vers une section spécifique d'une page 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]].
  
   Ce lien renvoie vers [[syntax#internes|cette section]].   Ce lien renvoie vers [[syntax#internes|cette section]].
Ligne 76: Ligne 72:
 ==== Interwiki ==== ==== 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 définition des Wikis dans Wikipedia en français : [[wp>fr:Wiki|Wiki]]+Les liens [[doku>fr:interwiki|Interwiki]] sont des liens rapides vers d'autres Wikis.\\ 
- +Par exemple [[wpfr>Wiki|Wiki]] ou [[wp>fr:Wiki|Wiki]] sont des liens vers la définition des Wikis dans Wikipedia en français.
-  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 +
-  définition des Wikis dans Wikipedia en français : [[wp>fr:Wiki|Wiki]].+
  
 +  Les liens [[doku>fr:interwiki|Interwiki]] sont des liens rapides vers d'autres Wikis.\\
 +  Par exemple [[wpfr>Wiki|Wiki]] ou [[wp>fr:Wiki|Wiki]] sont des liens vers la définition des Wikis dans Wikipedia en français.
  
 ==== Partages Windows ==== ==== 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 homogène tels qu'un [[wp>Intranet]] d'entreprise. +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 homogène tels qu'un [[wpfr>Intranet]] d'entreprise. 
  
   Les partages Windows tels que [[\\serveur\partage|ceci]] sont également reconnus.   Les partages Windows tels que [[\\serveur\partage|ceci]] sont également reconnus.
Ligne 92: Ligne 87:
  
   * 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 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é. +  * Pour //Mozilla// et //Firefox//, sans réglages, ça ne fonctionne pas. Voir [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|cette fiche]] de la base de connaissance de Mozilla pour les contournements possiblesIl restera cependant un avertissement JavaScriptPour supprimer cet avertissement, pour tous les visiteurs du wiki, ajouter cette ligne dans le fichier texte ''conf/userscript.js'':<code javascript> 
-     * 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) +LANG.nosmblinks = ''; 
-     * 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) +</code> 
-  * Veuillez consulter [[dokubug>151]] pour plus d'informations.+
 ==== Liens images ==== ==== Liens images ====
  
Ligne 106: Ligne 101:
 NB : la mise en forme image est la seule syntaxe de mise en forme acceptée comme nom de lien. NB : la mise en forme image est la seule syntaxe de mise en forme acceptée comme nom de lien.
  
-Les syntaxes d'[[#Images et autres fichiers|image]] complète et de [[#Liens]] sont possibles (incluant le redimensionnement d'image, les images internes et externes, les URL et les liens interwikis).+Les syntaxes d'[[#Images et autres fichiers|image]] complète et de [[#Liens]] sont possibles (y compris le redimensionnement d'image, les images internes et externes, les URL et les liens interwikis).
  
 ===== Notes de pied de page ===== ===== Notes de pied de page =====
Ligne 137: Ligne 132:
 ===== Images et autres fichiers ===== ===== Images et autres fichiers =====
  
-Vous pouvez inclure des [[doku>fr:images|images]] externes et internes avec des accolades. Vous pouvez spécifier leur taille (facultatif).+Vous pouvez insérer des [[doku>fr:images|images, fichiers audio et vidéo]] (ou autres fichiers) internes ou externes avec des accolades. Additionnelement, vous pouvez en préciser la taille. 
 +  
 +taille originale :                 {{wiki:dokuwiki-128.png}}
  
-Taille réelle                                          {{wiki:dokuwiki-128.png}}+largeur donnée                   {{wiki:dokuwiki-128.png?50}}
  
-Redimensionnement à une largeur donnée                 {{wiki:dokuwiki-128.png?50}}+hauteur et largeur 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}}
  
-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}}
  
-Image externe redimensionnée :                           {{http://de3.php.net/images/php.gif?200x50}}+  taille originale :                {{wiki:dokuwiki-128.png}} 
 +  largeur donnée :                  {{wiki:dokuwiki-128.png?50}} 
 +  hauteur et largeur données :      {{wiki:dokuwiki-128.png?200x50}} 
 +  Image externe redimensionnée :    {{http://de3.php.net/images/php.gif?200x50}}
  
-  Taille réelle :                                          {{wiki:dokuwiki-128.png}} 
-  Redimensionnement à une largeur donnée :                 {{wiki:dokuwiki-128.png?50}} 
-  Redimensionnement à une largeur et une hauteur données : {{wiki:dokuwiki-128.png?200x50}} 
-  Image externe redimensionnée :                           {{http://de3.php.net/images/php.gif?200x50}} 
  
 +Par défaut les images se placent au fil du texte, centrées verticalement.
  
-En utilisant des espaces à gauche ou à droite, vous pouvez choisir l'alignement.+Vous pouvez les aligner avec des espaces à gauche ou à droite :
  
 {{ wiki:dokuwiki-128.png}} {{ wiki:dokuwiki-128.png}}
Ligne 165: Ligne 162:
   {{ wiki:dokuwiki-128.png }}   {{ wiki:dokuwiki-128.png }}
  
-Bien sûr, vous pouvez aussi ajouter un titre (affiché comme une bulle d'aide par la plupart des navigateurs)+Bien sûr, vous pouvez  ajouter un titreaffiché comme une bulle d'aide par les navigateurs.
  
-{{ wiki:dokuwiki-128.png |Ceci est le titre}}+{{ wiki:dokuwiki-128.png |This is the caption}}
  
-  {{ wiki:dokuwiki-128.png |Ceci est le titre}}+  {{ wiki:dokuwiki-128.png |This is the caption}}
  
-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}}+Les fichiers qui ne sont pas affichables (voir tableau des médias pris en charge dans la [[#Médias pris en charge|section suivante]]), sont représentés uniquement comme un lien de téléchargement. par défaut, les images disposent d'un lien vers une page de détails.
  
-  {{ wiki:dokuwiki-128.png?linkonly|le logo de DokuWiki}}+Vous pouvez modifier ce comportement :
  
-  +{{wiki:dokuwiki-128.png?nolink}} Pas de lien.\\ 
-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. +{{wiki:dokuwiki-128.png?direct}} Lien direct sur le media.\\ 
 +{{wiki:dokuwiki-128.png?linkonly}} Uniquement le lien direct.\\ 
 +[[http://www.php.net|{{wiki:dokuwiki-128.png}}]] Lien vers une page. Voir [[#liens images]] ci dessus 
 + 
 +  {{wiki:dokuwiki-128.png?nolink}} Pas de lien. 
 +  {{wiki:dokuwiki-128.png?direct}} Lien direct sur le media. 
 +  {{wiki:dokuwiki-128.png?linkonly}} Uniquement le lien direct. 
 +  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] Lien vers une page. Voir [[#liens images]] ci dessus 
 + 
 + 
 +Vous pouvez combiner plusieurs effets avec ''&''
 + 
 +{{wiki:dokuwiki-128.png?50&nolink|Le titre}} 
 +  {{wiki:dokuwiki-128.png?50&nolink|Le titre}} 
 + 
 +==== Médias pris en charge ==== 
 + 
 +DokuWiki peut directement présenter les formats de fichiers suivants 
 + 
 +^ Image | ''gif''''jpg''''png''  | 
 +^ Vidéo | ''webm''''ogv'', ''mp4''
 +^ Audio | ''ogg'', ''mp3'', ''wav'' 
 +^ Flash | ''swf''                    | 
 + 
 +Si vous indiquez un fichier dans un format non pris en charge, DokuWiki le présentera comme un lien de téléchargement. 
 + 
 +==== Formats de replis ==== 
 + 
 +Malheureusement, certains navigateurs ne comprennent qu'un ensemble restreint de formats vidéo et audio. Pour atténuer ce problème, vous pouvez téléverser vos vidéos et audio dans différents formats pour augmenter la compatibilité avec les divers navigateurs. DokuWiki présentera alors des alternatives au navigateur. 
 + 
 +Par exemple, si vous avez téléversé ''film.webm'', ''film.ogv'' et ''film.mp4'', lorsque vous présentez la vidéo mp4 comme ceci : 
 + 
 +  {{film.mp4|une vidéo sympa}} 
 + 
 +DokuWiki indiquera automatiquement les alternatives ''film.webm'', ''film.ogv'' de telle sorte que l'un des formats au moins soit reconnu par le navigateur. 
 + 
 +De plus, DokuWiki permet d'utiliser une image poster qui est affichée avant le démarrage de la vidéo. Cette image doit avoir le même nom que la vidéo et être soit une image jpeg, soit une image png. Dans l'exemple précédent, on aurait pu utiliser une image nommée ''film.jpg''.
  
-Pour lier une image à une autre page, voir [[#Liens images]] ci-dessus. 
  
 ===== Listes ===== ===== Listes =====
Ligne 208: Ligne 240:
 </code> </code>
  
-Vous pouvez aussi consulter notre [[fr:faq:lists|FAQ sur les listes]] +Vous pouvez aussi consulter notre [[doku>fr:faq:lists|FAQ sur les listes]] 
  
 ===== Conversions textuelles ===== ===== Conversions textuelles =====
  
-DokuWiki peut convertir certains caractères ou chaines de caractère prédéfinis en image, autre texte, ou HTML.+DokuWiki peut convertir certains caractères ou chaînes 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. 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.
Ligne 218: Ligne 250:
 ==== Emoticônes (smileys) ==== ==== 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. +DokuWiki transforme les [[wpfr>Émoticône]]s courantes en leurs équivalents graphiques. On peut facilement en [[doku>fr:smileys|ajouter d'autres]]. Voici une vue d'ensemble des émoticônes incluses dans DokuWiki. 
  
   * 8-) %%  8-)  %%   * 8-) %%  8-)  %%
Ligne 243: Ligne 275:
 ==== 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. +[[doku>fr:dokuwiki|DokuWiki]] peut convertir de simples caractères de texte brut en leurs entités typographiques correctes. Voici un exemple des caractères reconnus. 
  
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
Ligne 253: Ligne 285:
 </code> </code>
  
-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 est possible de faire la même chose pour n'importe quelle balise HTML. Il suffit pour cela de rajouter une ligne dans le [[doku>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 [[doku>fr:config:typography|option de configuration]].
  
-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 ===== ===== Citations =====
  
Ligne 345: Ligne 378:
   |gauche        |        droite|    centré    |   |gauche        |        droite|    centré    |
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
 +
  
 ===== Blocs non analysés ===== ===== Blocs non analysés =====
  
-Vous pouvez inclure des blocs non analysés dans vos documents soit en les indentant avec au moins deux espaces (comme on peut le voir dans les exemples précédents) soit en utilisant les balises ''code'' ou ''file''.+Si vous avez besoin d'afficher du texte exactement comme il est saisi (sans aucun formatage), entourez le texte soit de balises ''%%<nowikiW%%'' soit, plus simplement encore, de double signe pourcent ''<nowiki>%%</nowiki>''.
  
 +<nowiki>
 +Voilà du texte qui contient une adresse : http://www.splitbrain.org et de la **mise en formee** ; mais
 +il est reproduit tel quel.
 +</nowiki>
 +La même chose est vraie pour  %%//__ce__ texte// avec une émoticône ;-)%%.
 +
 +  <nowiki>
 +  Voilà du texte qui contient une adresse : http://www.splitbrain.org et de la **mise en formee** ; mais
 +  il est reproduit tel quel.
 +  </nowiki>
 +  La même chose est vraie pour  %%//__ce__ texte// avec une émoticône ;-)%%.
 +  <nowiki>
 +
 +
 +===== Blocs de code =====
 +
 +Vous pouvez inclure des blocs non analysés dans vos documents soit en les indentant avec au moins deux espaces (comme on peut le voir dans les exemples précédents) soit en utilisant les balises ''%%<code>%%'' ou ''%%<file>%%''.
 +
 +  Ce texte est indenté avec deux espaces.
  
 <code> <code>
-Ceci est du code préformaté, tous les espaces sont préservés : comme           <-ceci+Ceci est du code préformaté, tous les espaces sont préservés : 
 +comme           <- ceci
 </code> </code>
  
 <file> <file>
-Ceci est pratiquement la même chose, mais vous pouvez l'utiliser pour montrer que vous avez cité un fichier. +C'est pratiquement la même chose, mais vous pouvez l'utiliser pour montrer 
 +que vous avez cité un fichier. 
 </file> </file>
  
-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>''+    Ce texte est indenté avec deux espaces
- +   
-  <nowiki+  <code
-  Voici du texte qui contient des adresses comme ceci : http://www.spiltbrain.org et de la **mise en forme**, mais rien ne se passe.  +  Ceci est du code préformaté, tous les espaces sont préservés : 
-  </nowiki+  comme           <- ceci 
- +  </code
-<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.  +  <file
-</nowiki>+  C'est pratiquement la même chose, mais vous pouvez l'utiliser pour montrer 
 +  que vous avez cité un fichier.  
 +  </file>
  
-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>''.+[[doku>fr:dokuwiki|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>''.
  
 <code java> <code java>
Ligne 387: Ligne 443:
 </code> </code>
  
-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//+DokuWiki reconnait les identifiants de langage suivants : //4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript-french, actionscript, actionscript3, ada, algol68, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, 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, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic//.
  
 ==== Bloc de code téléchargeables ==== ==== Bloc de code téléchargeables ====
Ligne 402: Ligne 458:
   </file>   </file>
  
-Si vous ne voulez pas de coloration syntaxique, il suffit de fournir un tiret (-) en guise de code de langage:\\ +Si vous ne voulez pas de coloration syntaxique, il suffit de fournir un tiret (-) en guise de code de langage :\\ 
- %%<code - monfichier.toto>%%.+ ''%%<code - monfichier.toto>%%''.
  
-===== Agrégation de fils RSS/ATOM ===== +===== Inclure du code HTML ou PHP =====
-[[DokuWiki]] peut agréger les données 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 utilisés dans DokuWiki. Vous pouvez modifier le comportement en ajoutant plusieurs paramètres séparés par des espaces :+
  
-^ Paramètre   ^ Description ^ +Vous pouvez inclure du code HTML ou PHP pur dans vos documents en utilisant les balises ''%%<html>%%'' ou ''%%<php>%%''. En utilisant des balises en majusculevous définissez un blocLes balises en minuscule insèrent les éléments en ligne.
-| tout nombre | sera utilisé comme le nombre maximum d'éléments à montrer, 8 par défaut | +
-| reverse     | affiche les derniers éléments en premier dans le fil | +
-| author      | affiche le nom des auteurs des éléments | +
-| date        | affiche les dates des éléments | +
-| description | affiche les descriptions des éléments. Si [[doku>config#htmlok|HTML]] est désactivé, toutes les étiquettes (//tags//) seront enlevées | +
-| //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.+exemple HTML :
  
-**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> <code>
-<html> +Ceci est <html>de l'<span style="color:red;font-size:150%;">HTML en ligne</span>
-Ceci est du <font color="redsize="+1">HTML</font>+
 </html> </html>
 +
 +Quant à <HTML>
 +<p style="border:2px dashed red;">ceci, un bloc HTML</p>
 +</HTML>
 </code> </code>
  
-<html> +Ceci est <html>de l'<span style="color:red;font-size:150%;">HTML en ligne</span>
-Ceci est du <font color="redsize="+1">HTML</font>+
 </html> </html>
 +
 +Quant à <HTML>
 +<p style="border:2px dashed red;">ceci, un bloc HTML</p>
 +</HTML>
 +
 +exemple PHP :
  
 <code> <code>
 <php> <php>
-echo 'Un logo produit par PHP :'; +echo 'Version de PHP: '
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Logo PHP !" />';+echo phpversion()
 +echo ' (HTML en ligne généré)';
 </php> </php>
 +<PHP>
 +echo '<table class="inline"><tr><td>La même chose, mais dans un élément de niveau bloc:</td>';
 +echo '<td>'.phpversion().'</td>';
 +echo '</tr></table>';
 +</PHP>
 </code> </code>
  
 <php> <php>
-echo 'Un logo produit par PHP :'; +echo 'Version de PHP: '
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Logo PHP !" />';+echo phpversion()
 +echo ' (HTML en ligne généré)';
 </php> </php>
 +<PHP>
 +echo '<table class="inline"><tr><td>La même chose, mais dans un élément de niveau bloc:</td>';
 +echo '<td>'.phpversion().'</td>';
 +echo '</tr></table>';
 +</PHP>
  
 **NB** : L'inclusion de code HTML et PHP est désactivée dans la configuration par défaut. Dans ce cas, le code est affiché au lieu d'être exécuté.  **NB** : L'inclusion de code HTML et PHP est désactivée dans la configuration par défaut. Dans ce cas, le code est affiché au lieu d'être exécuté. 
 +
 +===== Agrégation de fils RSS/ATOM =====
 +
 +[[doku>fr:dokuwiki|DokuWiki]] peut agréger les données 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 utilisés dans DokuWiki. Vous pouvez modifier le comportement en ajoutant plusieurs paramètres séparés par des espaces :
 +
 +^ Paramètre   ^ Description ^
 +| tout nombre | sera utilisé comme le nombre maximum d'éléments à montrer, 8 par défaut |
 +| reverse     | affiche les derniers éléments en premier dans le fil |
 +| author      | affiche le nom des auteurs des éléments |
 +| date        | affiche les dates des éléments |
 +| description | affiche les descriptions des éléments. Si [[doku>fr:config:htmlok|HTML]] est désactivé, toutes les balises seront enlevées |
 +| //n//[dhm]  | durée de rafraîchissement, ou d=days (jours), h=heures, m=minutes. (Par exemple 12h = 12 heures). |
 +
 +La période de rafraîchissement est par défaut de 4 heures. Toute valeur inférieure à 10 minutes sera traitée comme 10 minutes. [[doku>fr:dokuwiki|DokuWiki]] essaiera en général de fournir une version de la page à partir du cache ; évidemment, cela est inadapté si la page a un contenu dynamique externe. Ce paramètre informe [[doku>fr:dokuwiki|DokuWiki]] qu'il doit reconstruire la page s'il s'est écoulé plus de temps que la //période de rafraîchissement// depuis la dernière reconstruction.
 +
 +**Exemple :**
  
 ===== Macros ===== ===== Macros =====
  
-Certains mot-clef modifient la manière dont DokuWiki génère une page, sans rajouter aucun contenu. Les macros suivantes sont disponibles :+Certains mots-clef modifient la manière dont DokuWiki génère une page, sans rajouter aucun contenu. Les macros suivantes sont disponibles :
  
 ^ Macro           ^ Description | ^ Macro           ^ Description |
 | %%~~NOTOC~~%%   | Si cette macro est présente dans une page, aucune table des matières ne sera générée. | | %%~~NOTOC~~%%   | Si cette macro est présente dans une page, aucune table des matières ne sera générée. |
-| %%~~NOCACHE~~%% | Par défaut, DokuWiki met en cache les pages qu'il génère. Parfois, ce n'est pas ce qui est voulu (par exemple quand la syntaxe %%<php>%% vue ci dessus est utilisée), ajouter cette macro va forcer DokuWiki à générer une page à chaque appel de celle ci.  |+| %%~~NOCACHE~~%% | Par défaut, DokuWiki met en cache les pages qu'il génère. Parfois, ce n'est pas ce qui est voulu (par exemple quand la syntaxe %%<php>%% vue ci-dessus est utilisée), ajouter cette macro va forcer DokuWiki à générer une page à chaque appel de celle-ci.  |
  
 ===== Extensions de syntaxe ===== ===== Extensions de syntaxe =====
  
-La syntaxe de DokuWiki peut être étendue par des [[doku>fr:plugins|extensions]]. Comment utiliser les extensions installées est décrit dans leurs pages de description respectives. Les extensions de syntaxe suivantes sont disponibles dans cette installation particulière de DokuWiki :+La syntaxe de DokuWiki peut être étendue par des [[doku>fr:plugins|extensions]]. La manière d'utiliser les extensions installées est détaillée dans leurs pages de description respectives. Les extensions de syntaxe suivantes sont disponibles dans cette installation particulière de DokuWiki :
  
 ~~INFO:syntaxplugins~~ ~~INFO:syntaxplugins~~