meta données pour cette page
  •  

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 [2025/08/19 15:10] – nicolaswiki:syntax [2025/09/09 21:14] (Version actuelle) – modification externe 127.0.0.1
Ligne 1: Ligne 1:
-====== Syntaxe de mise en forme ====== +====== Formatting Syntax ======
-[[doku>DokuWiki]] prend en charge un langage de balisage simple, qui vise à rendre les fichiers de données aussi lisibles que possible. Cette page contient toutes les syntaxes possibles que vous pouvez utiliser lors de l'édition des pages. Il vous suffit de consulter le code source de cette page en appuyant sur "Modifier cette page". Si vous souhaitez essayer quelque chose, utilisez simplement la page [[playground:playground|bac à sable]]. La mise en forme plus simple est également accessible via les [[doku>toolbar|boutons rapides]].+
  
-===== Mise en forme de texte de base ===== +[[doku>DokuWiki]] supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing "Edit this page". If you want to try something, just use the [[playground:playground|playground]] page. The simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too.
-DokuWiki prend en charge les textes en **gras**, //italique//, __souligné__ et ''monospace''. Bien sûr, vous pouvez **__//''combiner''//__** tout cela. +
-  DokuWiki prend en charge les textes en **gras**, //italique//, __souligné__ et ''monospace''. +
-  Bien sûr, vous pouvez **__//''combiner''//__** tout cela. +
-Vous pouvez utiliser <sub>indice</sub> et <sup>exposant</sup>, aussi. +
-  Vous pouvez utiliser <sub>indice</sub> et <sup>exposant</sup>, aussi. +
-Vous pouvez marquer quelque chose comme <del>supprimé</del> également. +
-  Vous pouvez marquer quelque chose comme <del>supprimé</del> également. +
-Les **paragraphe**s sont créés à partir de lignes vides. Si vous voulez **forcer un retour à la ligne** sans créer de paragraphe, vous pouvez utiliser deux barres obliques inverses suivies d'un espace ou de la fin de la ligne. +
-Voici un texte avec des retours à la ligne\\ Notez que les +
-deux barres obliques inverses ne sont reconnues qu'à la fin d'une ligne\\ +
-ou suivies d'\\ un espace \\ceci se produit sans cela. +
-  Voici un texte avec des retours à la ligne\\ Notez que les +
-  deux barres obliques inverses ne sont reconnues qu'à la fin d'une ligne\\ +
-  ou suivies d'\\ un espace \\ceci se produit sans cela. +
-Vous devriez utiliser les retours à la ligne forcés uniquement si c'est vraiment nécessaire.+
  
-===== Liens ===== +===== Basic Text Formatting =====
-DokuWiki prend en charge plusieurs façons de créer des liens.+
  
-==== Externes ==== +DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
-Les liens externes sont reconnus automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez également définir le texte du lien : [[http://www.google.com|Ce lien pointe vers Google]]. Les adresses e-mail comme celle-ci : <andi@splitbrain.org> sont également reconnues. +
-  DokuWiki prend en charge plusieurs façons de créer des liens. Les liens externes sont reconnus +
-  automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez définir +
-  le texte du lien également : [[http://www.google.com|Ce lien pointe vers Google]]. Les adresses e-mail +
-  comme celle-ci : <andi@splitbrain.org> sont également reconnues.+
  
-==== Internes ==== +  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. 
-Les liens internes sont créés en utilisant des crochets. Vous pouvez soit simplement indiquer un [[nom_de_page]] ou utiliser un texte de lien supplémentaire [[nom_de_page|texte du lien]]. +  Of course you can **__//''combine''//__** all these. 
-  Les liens internes sont créés en utilisant des crochets. Vous pouvez soit simplement indiquer un + 
-  [[nom_de_page]] ou utiliser un texte de lien supplémentaire [[nom_de_page|texte du lien]]. +You can use <sub>subscript</sub> and <sup>superscript</sup>, too. 
-Les [[doku>nom_de_page|noms de page Wiki]] sont automatiquement convertis en minuscules, les caractères spéciaux ne sont pas autorisés. + 
-Vous pouvez utiliser des [[quelques:espaces_de_noms]] en utilisant un deux-points dans le nom de la page. +  You can use <sub>subscript</sub> and <sup>superscript</sup>, too. 
-  Vous pouvez utiliser des [[quelques:espaces_de_noms]] en utilisant un deux-points dans le nom de la page. + 
-Pour plus de détails sur les espaces de noms, voir [[doku>namespaces]]. +You can mark something as <del>deleted</del> as well. 
-Il est également possible de lier une section spécifique. Il suffit d'ajouter le nom de la section derrière un caractère dièse, comme en HTML. Cela crée un lien vers [[syntaxe#interne|cette Section]]. + 
-  Cela crée un lien vers [[syntaxe#interne|cette Section]]. +  You can mark something as <del>deleted</del> as well. 
-Remarques : + 
-  * Les liens vers des [[syntaxe|pages existantes]] sont affichés dans un style différent des pages [[inexistantes]]. +**Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line. 
-  * DokuWiki n'utilise pas [[wp>CamelCase]] pour créer automatiquement des liens par défaut, mais ce comportement peut être activé dans le fichier [[doku>config]]. Astuce : Si DokuWiki est un lien, alors c'est activé. + 
-  * Lorsque l'en-tête d'une section est modifié, son signet change également. Ne vous fiez donc pas trop aux liens de section.+This is some text with some linebreaks\\ Note that the 
 +two backslashes are only recognized at the end of a line\\ 
 +or followed by\\ a whitespace \\this happens without it. 
 + 
 +  This is some text with some linebreaks\\ Note that the 
 +  two backslashes are only recognized at the end of a line\\ 
 +  or followed by\\ a whitespace \\this happens without it. 
 + 
 +You should use forced newlines only if really needed. 
 + 
 +===== Links ===== 
 + 
 +DokuWiki supports multiple ways of creating links. 
 + 
 +==== External ==== 
 + 
 +External links are recognized automagically: http://www.google.com or simply www.google.com - You can set the link text as well: [[http://www.google.com|This Link points to google]]. Email addresses like this one: <andi@splitbrain.org> are recognized, too. 
 + 
 +  DokuWiki supports multiple ways of creating links. External links are recognized 
 +  automagically: http://www.google.com or simply www.google.com - You can set 
 +  link text as well: [[http://www.google.com|This Link points to google]]. Email 
 +  addresses like this one: <andi@splitbrain.org> are recognized, too. 
 + 
 +==== Internal ==== 
 + 
 +Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]]. 
 + 
 +  Internal links are created by using square brackets. You can either just give 
 +  a [[pagename]] or use an additional [[pagename|link text]]. 
 + 
 +[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed. 
 + 
 +You can use [[some:namespaces]] by using a colon in the pagename. 
 + 
 +  You can use [[some:namespaces]] by using a colon in the pagename. 
 + 
 +For details about namespaces see [[doku>namespaces]]. 
 + 
 +Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax#internal|this Section]]. 
 + 
 +  This links to [[syntax#internal|this Section]]. 
 + 
 +Notes: 
 + 
 +  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones. 
 +  * DokuWiki does not use [[wp>CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>config]] file. Hint: If DokuWiki is a link, then it's enabled. 
 +  * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.
  
 ==== Interwiki ==== ==== Interwiki ====
-DokuWiki prend en charge les liens [[doku>Interwiki]]. Ce sont des liens rapides vers d'autres Wikis. Par exemple, voici un lien vers la page Wikipédia sur les Wikis : [[wp>Wiki]]. 
-  DokuWiki prend en charge les liens [[doku>Interwiki]]. Ce sont des liens rapides vers d'autres Wikis. 
-  Par exemple, voici un lien vers la page Wikipédia sur les Wikis : [[wp>Wiki]]. 
  
-==== Partages Windows ==== +DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis. For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]]. 
-Les partages Windows comme [[\\serveur\partage|celui-ci]] sont également reconnus. Veuillez noter que ceux-ci n'ont de sens que dans un groupe d'utilisateurs homogène comme un [[wp>Intranet]] d'entreprise. + 
-  Les partages Windows comme [[\\serveur\partage|celui-ci]] sont également reconnus. +  DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis. 
-Remarques : +  For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]]. 
-  * Pour des raisons de sécurité, la navigation directe dans les partages Windows ne fonctionne par défaut que dans Microsoft Internet Explorer (et uniquement dans la "zone locale"). + 
-  * Pour Mozilla et Firefox, cela peut être activé via différentes solutions de contournement mentionnées dans la [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Base de connaissances Mozilla]]. Cependant, il y aura toujours un avertissement JavaScript concernant la tentative d'ouverture d'un partage Windows. Pour supprimer cet avertissement (pour tous les utilisateurs), ajoutez la ligne suivante dans ''conf/lang/fr/lang.php'' (plus de détails à [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localisation]]) : <code - conf/lang/fr/lang.php>+==== Windows Shares ==== 
 + 
 +Windows shares like [[\\server\share|this]] are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate [[wp>Intranet]]. 
 + 
 +  Windows Shares like [[\\server\share|this]] are recognized, too. 
 + 
 +Notes: 
 + 
 +  * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"). 
 +  * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in ''conf/lang/en/lang.php'' (more details at [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): <code - conf/lang/en/lang.php>
 <?php <?php
 /** /**
- * Personnalisation du fichier de langue française + * Customization of the english language file 
- * Copiez uniquement les chaînes qui doivent être modifiées+ * Copy only the strings that needs to be modified
  */  */
 $lang['js']['nosmblinks'] = ''; $lang['js']['nosmblinks'] = '';
 </code> </code>
  
-==== Liens d'images ==== +==== Image Links ==== 
-Vous pouvez également utiliser une image pour lier à une autre page interne ou externe en combinant la syntaxe des liens et des [[#images_et_autres_fichiers|images]] (voir ci-dessous) comme ceci :+ 
 +You can also use an image to link to another internal or external page by combining the syntax for links and [[#images_and_other_files|images]] (see below) like this: 
   [[http://php.net|{{wiki:dokuwiki-128.png}}]]   [[http://php.net|{{wiki:dokuwiki-128.png}}]]
 +
 [[http://php.net|{{wiki:dokuwiki-128.png}}]] [[http://php.net|{{wiki:dokuwiki-128.png}}]]
-Veuillez noter : La mise en forme des images est la seule syntaxe de mise en forme acceptée dans les noms de liens. 
-Toute la syntaxe des [[#images_et_autres_fichiers|images]] et des [[#liens|liens]] est prise en charge (y compris le redimensionnement des images, les images internes et externes, les URL et les liens interwiki). 
  
-===== Notes de bas de page ===== +Please note: The image formatting is the only formatting syntax accepted in link names.
-Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en utilisant des doubles parenthèses. +
-  Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en utilisant des doubles parenthèses.+
  
-===== Sections ===== +The whole [[#images_and_other_files|image]] and [[#links|link]] syntax is supported (including image resizing, internal and external images and URLs and interwiki links). 
-Vous pouvez utiliser jusqu'à cinq niveaux différents de titres pour structurer votre contenu. Si vous avez plus de trois titres, une table des matières est générée automatiquement -- cela peut être désactivé en incluant la chaîne ''<nowiki>~~NOTOC~~</nowiki>'' dans le document.+ 
 +===== Footnotes ===== 
 + 
 +You can add footnotes ((This is a footnote)) by using double parentheses. 
 + 
 +  You can add footnotes ((This is a footnote)) by using double parentheses. 
 + 
 +===== Sectioning ===== 
 + 
 +You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically -- this can be disabled by including the string ''<nowiki>~~NOTOC~~</nowiki>'' in the document. 
 + 
 +==== Headline Level 3 ==== 
 +=== Headline Level 4 === 
 +== Headline Level 5 == 
 + 
 +  ==== Headline Level 3 ==== 
 +  === Headline Level 4 === 
 +  == Headline Level 5 == 
 + 
 +By using four or more dashes, you can make a horizontal line:
  
-==== Niveau de titre 3 ==== 
-=== Niveau de titre 4 === 
-== Niveau de titre 5 == 
-  ==== Niveau de titre 3 ==== 
-  === Niveau de titre 4 === 
-  == Niveau de titre 5 == 
-En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale : 
 ---- ----
  
-===== Fichiers multimédias ===== +===== Media Files ===== 
-Vous pouvez inclure des [[doku>images|images, vidéos et fichiers audio]] internes et externes avec des accolades. Vous pouvez éventuellement spécifier leur taille. + 
-Taille réelle :                        {{wiki:dokuwiki-128.png}} +You can include external and internal [[doku>images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them. 
-Redimensionner à la largeur donnée :   {{wiki:dokuwiki-128.png?50}} + 
-Redimensionner à la largeur et à la hauteur données((lorsque le rapport hauteur/largeur de la largeur et de la hauteur données ne correspond pas à celui de l'image, elle sera recadrée au nouveau rapport avant le redimensionnement)) : {{wiki:dokuwiki-128.png?200x50}} +Real size:                        {{wiki:dokuwiki-128.png}} 
-Image externe redimensionnée :         {{https://www.php.net/images/php.gif?200x50}} + 
-  Taille réelle :                        {{wiki:dokuwiki-128.png}} +Resize to given width:            {{wiki:dokuwiki-128.png?50}} 
-  Redimensionner à la largeur donnée :   {{wiki:dokuwiki-128.png?50}} + 
-  Redimensionner à la largeur et à la hauteur données : {{wiki:dokuwiki-128.png?200x50}} +Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the image, it will be cropped to the new ratio before resizing)): {{wiki:dokuwiki-128.png?200x50}} 
-  Image externe redimensionnée :         {{https://www.php.net/images/php.gif?200x50}} + 
-En utilisant des espaces à gauche ou à droite, vous pouvez choisir l'alignement.+Resized external image:           {{https://www.php.net/images/php.gif?200x50}} 
 + 
 +  Real size:                        {{wiki:dokuwiki-128.png}} 
 +  Resize to given width:            {{wiki:dokuwiki-128.png?50}} 
 +  Resize to given width and height: {{wiki:dokuwiki-128.png?200x50}} 
 +  Resized external image:           {{https://www.php.net/images/php.gif?200x50}} 
 + 
 + 
 +By using left or right whitespaces you can choose the alignment. 
 {{ wiki:dokuwiki-128.png}} {{ wiki:dokuwiki-128.png}}
 +
 {{wiki:dokuwiki-128.png }} {{wiki:dokuwiki-128.png }}
 +
 {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }}
 +
   {{ 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 sûr, vous pouvez ajouter un titre (affiché comme une infobulle par la plupart des navigateurs), aussi. 
-{{ wiki:dokuwiki-128.png |Voici la légende}} 
-  {{ wiki:dokuwiki-128.png |Voici la légende}} 
-Pour lier une image à une autre page, voir [[#Liens d'images]] ci-dessus. 
  
-==== Formats multimédias pris en charge ==== +Of course, you can add a title (displayed as a tooltip by most browsers), too. 
-DokuWiki peut intégrer directement les formats multimédias suivants. + 
-| Image  | ''gif'', ''jpg'', ''png''  | +{{ wiki:dokuwiki-128.png |This is the caption}} 
-| Vidéo  | ''webm'', ''ogv'', ''mp4'' | + 
-| Audio  | ''ogg'', ''mp3'', ''wav''  | +  {{ wiki:dokuwiki-128.png |This is the caption}} 
-| Flash  | ''swf''                    | + 
-Si vous spécifiez un nom de fichier qui n'est pas un format multimédia pris en charge, il sera affiché comme un lien à la place. +For linking an image to another page see [[#Image Links]] above. 
-En ajoutant ''?linkonly'' vous fournissez un lien vers le média sans l'afficher en ligne+ 
 +==== Supported Media Formats ==== 
 + 
 +DokuWiki can embed the following media formats directly. 
 + 
 +| Image | ''gif'', ''jpg'', ''png''  | 
 +| Video | ''webm'', ''ogv'', ''mp4'' | 
 +| Audio | ''ogg'', ''mp3'', ''wav''  | 
 +| Flash | ''swf''                    | 
 + 
 +If you specify a filename that is not a supported media format, then it will be displayed as a link instead. 
 + 
 +By adding ''?linkonly'' you provide a link to the media without displaying it inline 
   {{wiki:dokuwiki-128.png?linkonly}}   {{wiki:dokuwiki-128.png?linkonly}}
-{{wiki:dokuwiki-128.png?linkonly}} Ceci est juste un lien vers l'image. 
  
-==== Formats de repli ==== +{{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image. 
-Malheureusement, tous les navigateurs ne comprennent pas tous les formats vidéo et audio. Pour atténuer le problème, vous pouvez télécharger votre fichier dans différents formats pour une compatibilité maximale avec les navigateurs. + 
-Par exemple, considérons cette vidéo mp4 intégrée : +==== Fallback Formats ==== 
-  {{video.mp4|Une vidéo amusante}} + 
-Lorsque vous téléchargez un fichier ''video.webm'' et ''video.ogv'' à côté de la ''video.mp4'' référencée, DokuWiki les ajoutera automatiquement comme alternatives afin qu'un des trois fichiers soit compris par votre navigateur. +Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility. 
-De plus, DokuWiki prend en charge une image "poster" qui sera affichée avant que la vidéo ne commence. Cette image doit avoir le même nom de fichier que la vidéo et être soit un fichier jpg, soit png. Dans l'exemple ci-dessus, un fichier ''video.jpg'' fonctionnerait.+ 
 +For example consider this embedded mp4 video: 
 + 
 +  {{video.mp4|A funny video}} 
 + 
 +When you upload a ''video.webm'' and ''video.ogv'' next to the referenced ''video.mp4'', DokuWiki will automatically add them as alternatives so that one of the three files is understood by your browser. 
 + 
 +Additionally DokuWiki supports a "poster" image which will be shown before the video has started. That image needs to have the same filename as the video and be either a jpg or png file. In the example above a ''video.jpg'' file would work. 
 + 
 +===== Lists ===== 
 + 
 +Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a ''*'' for unordered lists or a ''-'' for ordered ones. 
 + 
 +  * This is a list 
 +  * The second item 
 +    * You may have different levels 
 +  * Another item 
 + 
 +  - The same list but ordered 
 +  - Another item 
 +    - Just use indention for deeper levels 
 +  - That's it
  
-===== Listes ===== 
-DokuWiki prend en charge les listes ordonnées et non ordonnées. Pour créer un élément de liste, indentiez votre texte de deux espaces et utilisez un ''*'' pour les listes non ordonnées ou un ''-'' pour les listes ordonnées. 
-  * Voici une liste 
-  * Le deuxième élément 
-    * Vous pouvez avoir différents niveaux 
-  * Un autre élément 
-  - La même liste mais ordonnée 
-  - Un autre élément 
-    - Utilisez simplement l'indentation pour des niveaux plus profonds 
-  - C'est tout 
 <code> <code>
-  * Voici une liste +  * This is a list 
-  * Le deuxième élément +  * The second item 
-    * Vous pouvez avoir différents niveaux +    * You may have different levels 
-  * Un autre élément +  * Another item 
-  - La même liste mais ordonnée + 
-  - Un autre élément +  - The same list but ordered 
-    - Utilisez simplement l'indentation pour des niveaux plus profonds +  - Another item 
-  - C'est tout+    - Just use indention for deeper levels 
 +  - That's it
 </code> </code>
-Consultez également la [[doku>faq:lists|FAQ sur les éléments de liste]]. 
  
-===== Conversions de texte ===== +Also take a look at the [[doku>faq:lists|FAQ on list items]]. 
-DokuWiki peut convertir certains caractères ou chaînes de caractères prédéfinis en images ou en autre texte ou HTML. + 
-La conversion de texte en image est principalement effectuée pour les smileys. Et la conversion de texte en HTML est utilisée pour les remplacements typographiques, mais peut être configurée pour utiliser d'autres balises HTML également.+===== Text Conversions ===== 
 + 
 +DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML. 
 + 
 +The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacements, but can be configured to use other HTML as well. 
 + 
 +==== Text to Image Conversions ==== 
 + 
 +DokuWiki converts commonly used [[wp>emoticon]]s to their graphical equivalents. Those [[doku>Smileys]] and other images can be configured and extended. Here is an overview of Smileys included in DokuWiki:
  
-==== Conversions de texte en image ==== 
-DokuWiki convertit les [[wp>emoticon]]s couramment utilisés en leurs équivalents graphiques. Ces [[doku>Smileys]] et autres images peuvent être configurés et étendus. Voici un aperçu des smileys inclus dans DokuWiki : 
   * 8-) %%  8-)  %%   * 8-) %%  8-)  %%
   * 8-O %%  8-O  %%   * 8-O %%  8-O  %%
Ligne 176: Ligne 254:
   * DELETEME %% DELETEME %%   * DELETEME %% DELETEME %%
  
-==== Conversions de texte en HTML ==== +==== Text to HTML Conversions ==== 
-Typographie : [[DokuWiki]] peut convertir des caractères de texte simples en leurs entités typographiquement correctes. Voici un exemple de caractères reconnus.+ 
 +Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters. 
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
 "He thought 'It's a man's world'..." "He thought 'It's a man's world'..."
 +
 <code> <code>
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
 "He thought 'It's a man's world'..." "He thought 'It's a man's world'..."
 </code> </code>
-Il est possible de faire de même pour produire tout type de HTML, il suffit de l'ajouter au fichier de [[doku>entities|motifs]]. 
-Il y a trois exceptions qui ne proviennent pas de ce fichier de motifs : l'entité de multiplication (640x480), les 'guillemets simples' et "les guillemets doubles". Elles peuvent être désactivées via une [[doku>config:typography|option de configuration]]. 
  
-===== Citations ===== +The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>entities|pattern file]]. 
-Parfois, vous souhaitez marquer un texte pour montrer qu'il s'agit d'une réponse ou d'un commentaire. Vous pouvez utiliser la syntaxe suivante :+ 
 +There are three exceptions which do not come from that pattern file: multiplication entity (640x480), 'single' and "double quotes". They can be turned off through a [[doku>config:typography|config option]]. 
 + 
 +===== Quoting ===== 
 + 
 +Some times you want to mark some text to show it's a reply or comment. You can use the following syntax: 
 <code> <code>
-Je pense que nous devrions le faire +I think we should do it 
-> Non, nous ne devrions pas + 
->> Eh bien, je dis que nous devrions +> No we shouldn't 
-> Vraiment ? + 
->> Oui ! +>> Well, I say we should 
->>> Alors faisons-le !+ 
 +> Really? 
 + 
 +>> Yes! 
 + 
 +>>> Then lets do it!
 </code> </code>
-Je pense que nous devrions le faire 
-> Non, nous ne devrions pas 
->> Eh bien, je dis que nous devrions 
-> Vraiment ? 
->> Oui ! 
->>> Alors faisons-le ! 
  
-===== Tableaux ===== +I think we should do it 
-DokuWiki prend en charge une syntaxe simple pour créer des tableaux. + 
-^ En-tête 1      ^ En-tête 2       ^ En-tête 3          ^ +> No we shouldn't 
-| Ligne 1 Col 1  | Ligne 1 Col 2   | Ligne 1 Col 3      | + 
-| Ligne 2 Col 1  | fusion de colonnes (notez le double pipe) || +>> Well, I say we should 
-| Ligne 3 Col 1  | Ligne 3 Col 2   | Ligne 3 Col 3      | + 
-Les lignes de tableau doivent commencer et se terminer par un ''|'' pour les lignes normales ou un ''^'' pour les en-têtes. +> Really? 
-  ^ En-tête 1      ^ En-tête 2       ^ En-tête 3          ^ + 
-  | Ligne 1 Col 1  | Ligne 1 Col 2   | Ligne 1 Col 3      | +>> Yes! 
-  | Ligne 2 Col 1  | fusion de colonnes (notez le double pipe) || + 
-  | Ligne 3 Col 1  | Ligne 3 Col 2   | Ligne 3 Col 3      | +>>> Then lets do it! 
-Pour connecter des cellules horizontalement, laissez simplement la cellule suivante complètement vide comme montré ci-dessus. Assurez-vous d'avoir toujours le même nombre de séparateurs de cellules ! + 
-Les en-têtes de tableau verticaux sont également possibles. +===== Tables ===== 
-|              ^ En-tête 1            ^ En-tête 2          ^ + 
-^ En-tête 3    | Ligne 1 Col 2          | Ligne 1 Col 3      | +DokuWiki supports a simple syntax to create tables. 
-^ En-tête 4    | pas de fusion cette fois |                    | + 
-^ En-tête 5    | Ligne 2 Col 2          | Ligne 2 Col 3      | +^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
-Comme vous pouvez le voir, c'est le séparateur de cellule avant une cellule qui décide de la mise en forme : +| Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
-  |              ^ En-tête 1            ^ En-tête 2          ^ +| Row 2 Col 1    | some colspan (note the double pipe) || 
-  ^ En-tête 3    | Ligne 1 Col 2          | Ligne 1 Col 3      | +| Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        | 
-  ^ En-tête 4    | pas de fusion cette fois |                    | + 
-  ^ En-tête 5    | Ligne 2 Col 2          | Ligne 2 Col 3      | +Table rows have to start and end with a ''|'' for normal rows or a ''^'' for headers. 
-Vous pouvez avoir des fusions de lignes (cellules connectées verticalement) en ajoutant ''%%:::%%'' dans les cellules en dessous de celle à laquelle elles doivent se connecter. + 
-^ En-tête 1      ^ En-tête 2                  ^ En-tête 3          ^ +  ^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
-| Ligne 1 Col 1  | cette cellule s'étend verticalement | Ligne 1 Col 3      | +  | Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
-| Ligne 2 Col 1  | :::                        | Ligne 2 Col 3      | +  | Row 2 Col 1    | some colspan (note the double pipe) || 
-| Ligne 3 Col 1  | :::                        | Ligne 2 Col 3      | +  | Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        | 
-En dehors de la syntaxe de fusion de lignes, ces cellules ne doivent pas contenir autre chose. + 
-  ^ En-tête 1      ^ En-tête 2                  ^ En-tête 3          ^ +To connect cells horizontally, just make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators! 
-  | Ligne 1 Col 1  | cette cellule s'étend verticalement | Ligne 1 Col 3      | + 
-  | Ligne 2 Col 1  | :::                        | Ligne 2 Col 3      | +Vertical tableheaders are possible, too. 
-  | Ligne 3 Col 1  | :::                        | Ligne 2 Col 3      | + 
-Vous pouvez également aligner le contenu des tableaux. Il suffit d'ajouter au moins deux espaces à l'extrémité opposée de votre texte : ajoutez deux espaces à gauche pour aligner à droite, deux espaces à droite pour aligner à gauche et au moins deux espaces aux deux extrémités pour centrer le texte. +|              ^ Heading 1            ^ Heading 2          ^ 
-^           Tableau avec alignement           ^^^ +^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        | 
-|         droite|    centré     |gauche         | +^ Heading 4    | no colspan this time |                    | 
-|gauche          |         droite|    centré     | +^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        | 
-| xxxxxxxxxxxx   | xxxxxxxxxxxx  | xxxxxxxxxxxx  | + 
-Voici à quoi cela ressemble dans la source : +As you can see, it's the cell separator before a cell which decides about the formatting: 
-  ^           Tableau avec alignement           ^^^ + 
-  |         droite|    centré     |gauche         | +  |              ^ Heading 1            ^ Heading 2          ^ 
-  |gauche          |         droite|    centré     | +  ^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        | 
-  | xxxxxxxxxxxx   | xxxxxxxxxxxx  | xxxxxxxxxxxx  | +  ^ Heading 4    | no colspan this time |                    | 
-Remarque : L'alignement vertical n'est pas pris en charge.+  ^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        | 
 + 
 +You can have rowspans (vertically connected cells) by adding ''%%:::%%'' into the cells below the one to which they should connect. 
 + 
 +^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ 
 +| Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
 +| Row 2 Col 1    | :::                        | Row 2 Col 3        | 
 +| Row 3 Col 1    | :::                        | Row 2 Col 3        | 
 + 
 +Apart from the rowspan syntax those cells should not contain anything else. 
 + 
 +  ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ 
 +  | Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
 +  | Row 2 Col 1    | :::                        | Row 2 Col 3        | 
 +  | Row 3 Col 1    | :::                        | Row 2 Col 3        | 
 + 
 +You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text. 
 + 
 +^           Table with alignment           ^^^ 
 +|         right|    center    |left          | 
 +|left          |         right|    center    | 
 +| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | 
 + 
 +This is how it looks in the source: 
 + 
 +  ^           Table with alignment           ^^^ 
 +  |         right|    center    |left          | 
 +  |left          |         right|    center    | 
 +  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | 
 + 
 +Note: Vertical alignment is not supported. 
 + 
 +===== No Formatting ===== 
 + 
 +If you need to display text exactly like it is typed (without any formatting), enclose the area either with ''%%<nowiki>%%'' tags or even simpler, with double percent signs ''<nowiki>%%</nowiki>''.
  
-===== Pas de mise en forme ===== 
-Si vous devez afficher du texte exactement comme il est tapé (sans aucune mise en forme), encadrez la zone soit avec des balises ''%%<nowiki>%%'' ou même plus simplement, avec des doubles pourcentages ''<nowiki>%%</nowiki>''. 
 <nowiki> <nowiki>
-Voici un texte qui contient des adresses comme celle-ci : http://www.splitbrain.org et **mise en forme**, mais rien n'est fait avec.+This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
 </nowiki> </nowiki>
-Il en va de même pour %%//__ce__ texte// avec un smiley ;-)%%.+The same is true for %%//__this__ text// with a smiley ;-)%%. 
   <nowiki>   <nowiki>
-  Voici un texte qui contient des adresses comme celle-ci : http://www.splitbrain.org et **mise en forme**, mais rien n'est fait avec.+  This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
   </nowiki>   </nowiki>
-  Il en va de même pour %%//__ce__ texte// avec un smiley ;-)%%.+  The same is true for %%//__this__ text// with a smiley ;-)%%. 
 + 
 +===== Code Blocks ===== 
 + 
 +You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags ''%%<code>%%'' or ''%%<file>%%''. 
 + 
 +  This is text is indented by two spaces.
  
-===== Blocs de code ===== 
-Vous pouvez inclure des blocs de code dans vos documents soit en les indentant d'au moins deux espaces (comme utilisé pour les exemples précédents) soit en utilisant les balises ''%%<code>%%'' ou ''%%<file>%%''. 
-  Ce texte est indenté de deux espaces. 
 <code> <code>
-Voici du code préformaté, tous les espaces sont conservés : comme              <-ceci+This is preformatted code all spaces are preserved: like              <-this
 </code> </code>
 +
 <file> <file>
-C'est à peu près la même chose, mais vous pourriez l'utiliser pour montrer que vous avez cité un fichier.+This is pretty much the same, but you could use it to show that you quoted a file.
 </file> </file>
-Ces blocs ont été créés par cette source : + 
-    Ce texte est indenté de deux espaces.+Those blocks were created by this source: 
 + 
 +    This is text is indented by two spaces. 
   <code>   <code>
-  Voici du code préformaté, tous les espaces sont conservés : comme              <-ceci+  This is preformatted code all spaces are preserved: like              <-this
   </code>   </code>
 +
   <file>   <file>
-  C'est à peu près la même chose, mais vous pourriez l'utiliser pour montrer que vous avez cité un fichier.+  This is pretty much the same, but you could use it to show that you quoted a file.
   </file>   </file>
  
-==== Mise en évidence de la syntaxe ==== +==== Syntax Highlighting ==== 
-[[wiki:DokuWiki]] peut mettre en évidence le code source, ce qui le rend plus facile à lire. Il utilise le [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- donc tout langage pris en charge par GeSHi est pris en charge. La syntaxe utilise les mêmes blocs de code et de fichier décrits dans la section précédente, mais cette fois le nom de la syntaxe de langage à mettre en évidence est inclus dans la balise, par exemple ''<nowiki><code java></nowiki>'' ou ''<nowiki><file java></nowiki>''.+ 
 +[[wiki:DokuWiki]] can highlight sourcecode, which makes it easier to read. It uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supported. The syntax uses the same code and file blocks described in the previous section, but this time the name of the language syntax to be highlighted is included inside the tag, e.g. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''. 
 <code java> <code java>
 /** /**
- * La classe HelloWorldApp implémente une application qui + * The HelloWorldApp class implements an application that 
- * affiche simplement "Hello World!" sur la sortie standard.+ * simply displays "Hello World!" to the standard output.
  */  */
 class HelloWorldApp { class HelloWorldApp {
     public static void main(String[] args) {     public static void main(String[] args) {
-        System.out.println("Hello World!"); // Affiche la chaîne.+        System.out.println("Hello World!"); //Display the string.
     }     }
 } }
 </code> </code>
-Les chaînes de langage suivantes sont actuellement reconnues : //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic// 
-Il existe des [[doku>syntax_highlighting|options avancées]] supplémentaires disponibles pour la mise en évidence de la syntaxe, telles que la mise en évidence de lignes ou l'ajout de numéros de ligne. 
  
-==== Blocs de code téléchargeables ==== +The following language strings are currently recognized: //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic// 
-Lorsque vous utilisez la syntaxe ''%%<code>%%'' ou ''%%<file>%%'' comme ci-dessus, vous pouvez vouloir rendre le code affiché disponible pour téléchargement également. Vous pouvez le faire en spécifiant un nom de fichier après le code de langage comme ceci :+ 
 +There are additional [[doku>syntax_highlighting|advanced options]] available for syntax highlighting, such as highlighting lines or adding line numbers. 
 + 
 +==== Downloadable Code Blocks ==== 
 + 
 +When you use the ''%%<code>%%'' or ''%%<file>%%'' syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this: 
 <code> <code>
-<file php mon_exemple.php> +<file php myexample.php> 
-<?php echo "bonjour le monde!"; ?>+<?php echo "hello world!"; ?>
 </file> </file>
 </code> </code>
-<file php mon_exemple.php> + 
-<?php echo "bonjour le monde!"; ?>+<file php myexample.php> 
 +<?php echo "hello world!"; ?>
 </file> </file>
-Si vous ne voulez aucune mise en évidence mais souhaitez un fichier téléchargeable, spécifiez un tiret (''-'') comme code de langage : ''%%<code - monfichier.foo>%%''. 
  
-===== Agrégation de flux RSS/ATOM ===== +If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%<code - myfile.foo>%%''. 
-[[DokuWiki]] peut intégrer des données provenant de flux XML externes. Pour analyser les flux XML, [[http://simplepie.org/|SimplePie]] est utilisé. Tous les formats compris par SimplePie peuvent également être utilisés dans DokuWiki. Vous pouvez influencer le rendu avec plusieurs paramètres supplémentaires séparés par des espaces : + 
-^ Paramètre  ^ Description ^ +===== RSS/ATOM Feed Aggregation ===== 
-| un nombre quelconque | sera utilisé comme nombre maximum d'éléments à afficher, par défaut 8 | +[[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://simplepie.org/|SimplePie]] is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters: 
-| reverse    | afficher les derniers éléments du flux en premier | + 
-| author     | afficher les noms des auteurs des éléments | +^ Parameter  ^ Description ^ 
-| date       | afficher les dates des éléments | +| any number | will be used as maximum number items to show, defaults to 8 | 
-| description| afficher la description de l'élément. Toutes les balises HTML seront supprimées | +| reverse    | display the last items in the feed first | 
-| nosort     | ne pas trier les éléments du flux | +| author     | show item authors names | 
-| //n//[dhm] | période de rafraîchissement, où d=jours, h=heures, m=minutes. (ex. 12h = 12 heures). | +| date       | show item dates | 
-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. [[wiki:DokuWiki]] essaiera généralement de fournir une version mise en cache d'une page, ce qui est évidemment inapproprié lorsque la page contient du contenu externe dynamique. Le paramètre indique à [[wiki:DokuWiki]] de rerendre la page si elle est plus ancienne que la période de rafraîchissement depuis le dernier rendu de la page. +| description| show the item description. All HTML tags will be stripped | 
-Par défaut, le flux sera trié par date, les éléments les plus récents en premier. Vous pouvez le trier par les plus anciens en premier en utilisant le paramètre ''reverse'', ou afficher le flux tel quel avec ''nosort''. +| nosort     | do not sort the items in the feed | 
-**Exemple :**+| //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | 
 + 
 +The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered. 
 + 
 +By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the ''reverse'' parameter, or display the feed as is with ''nosort''. 
 + 
 +**Example:** 
   {{rss>http://slashdot.org/index.rss 5 author date 1h }}   {{rss>http://slashdot.org/index.rss 5 author date 1h }}
 +
 {{rss>http://slashdot.org/index.rss 5 author date 1h }} {{rss>http://slashdot.org/index.rss 5 author date 1h }}
  
-===== Macros de contrôle ===== + 
-Certaines syntaxes influencent la manière dont DokuWiki rend une page sans créer de sortie. Les macros de contrôle suivantes sont disponibles :+===== Control Macros ===== 
 + 
 +Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble: 
 ^ Macro           ^ Description | ^ Macro           ^ Description |
-| %%~~NOTOC~~%%   | Si cette macro est trouvée sur la page, aucune table des matières ne sera créée | +| %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created | 
-| %%~~NOCACHE~~%% | DokuWiki met en cache toute la sortie par défaut. Parfois, cela peut ne pas être souhaité (par exemple, lorsque la syntaxe %%<php>%% ci-dessus est utilisée), l'ajout de cette macro forcerait DokuWiki à rerendre une page à chaque appel |+| %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call | 
 + 
 +===== Syntax Plugins ===== 
 + 
 +DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:
  
-===== Plugins de syntaxe ===== 
-La syntaxe de DokuWiki peut être étendue par des [[doku>plugins|Plugins]]. La manière dont les plugins installés sont utilisés est décrite sur leurs pages de description appropriées. Les plugins de syntaxe suivants sont disponibles dans cette installation particulière de DokuWiki : 
 ~~INFO:syntaxplugins~~ ~~INFO:syntaxplugins~~