Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

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
wiki:syntax [2021/06/22 21:02] – [Syntax Plugins] adminwiki:syntax [2026/07/22 13:44] (Version actuelle) – modification externe 127.0.0.1
Ligne 1: Ligne 1:
-====== Syntaxe de formatage ======+====== Formatting Syntax ======
  
-[[doku>DokuWiki]] utilise un langage de balisage simple, qui rend les fichiers de données aussi lisibles que possible.+[[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.
  
-Cette page présente toutes les syntaxes utilisables lors de l'édition des pages.+===== Basic Text Formatting =====
  
-Pour essayer quelque chose, utilisez la page du [[playground:playground|bac à sable]].+DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
  
-Des [[doku>toolbar|boutons]] donnent un accès direct au balisage simplifié.+  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. 
 +  Of course you can **__//''combine''//__** all these.
  
-===== Formatage de base du texte =====+Note that the formatting markers have to directly enclose the text, so ''%%** bold **%%'' with spaces inside the markers will not be formatted.
  
-DokuWiki prend en charge les textes en **gras**, en //italique//, __soulignés__ et en ''espace unique''. Vous pouvez bien sûr **__//''combiner''//__** toutes ces options.<code - >DokuWiki prend en charge les textes en **gras**, en //italique//, __soulignés__ et en ''espace unique''. +You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
-Vous pouvez bien sûr **__//''combiner''//__** toutes ces options.</code>+
  
-Vous pouvez également utiliser <sub>subscript</sub> et <sup>superscript</sup>.<code - >Vous pouvez également utiliser <sub>subscript</sub> et <sup>superscript</sup>.</code>+  You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
  
-Vous pouvez également marquer quelque chose comme <del>supprimé</del>.<code - >Vous pouvez également marquer quelque chose comme <del>supprimé</del>.</code>+You can mark something as <del>deleted</del> as well.
  
-**Les paragraphes** sont créés à partir de lignes vides. Si vous souhaitez **forcer une nouvelle ligne** sans paragraphe, vous pouvez utiliser deux barres obliques inverses suivies d'un espace ou d'une fin de ligne.+  You can mark something as <del>deleted</del> as well.
  
-Ceci est du texte avec des sauts de ligne\\ Notez que les deux barres obliques inverses ne sont reconnues qu'à la fin d'une ligne\\ +**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.
-ou suivi par\\ un espace \\voila ce qui se produit se produit sans espace.<code - >Ceci est du texte avec des sauts de ligne\\ Notez que les deux barres obliques inverses ne sont reconnues qu'à la fin d'une ligne\\ +
-ou suivi par\\ un espace \\voila ce qui se produit se produit sans espace.</code>+
  
-Vous ne devez utiliser les sauts de ligne forcés que si c'est vraiment nécessaire.+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.
  
-===== Liens =====+  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.
  
-DokuWiki prend en charge plusieurs méthodes pour créer des liens.+You should use forced newlines only if really needed.
  
-==== Externe ====+===== Links =====
  
-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 supports multiple ways of creating links.
  
-<code - >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.</code>+==== External ====
  
-==== Interne ====+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.
  
-Les liens internes sont créés à l'aide de crochets. Vous pouvez soit simplement donner un [[pagename]], soit utiliser un [[pagename|texte du lien]] supplémentaire.+  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.
  
-[[doku>pagename|Les noms de pages Wiki]] sont automatiquement convertis en minuscules, les caractères spéciaux ne sont pas autorisés.+==== Internal ====
  
-<code - >Vous pouvez utiliser [[some:namespaces]] en utilisant deux points dans le nom de la page.</code>-> Vous pouvez utiliser [[some:namespaces]] en utilisant deux points dans le nom de la page.+Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]].
  
-Pour plus de détails sur les espaces de noms, voir [[doku>namespaces]].+  Internal links are created by using square brackets. You can either just give 
 +  a [[pagename]] or use an additional [[pagename|link text]].
  
-Il est également possible de créer un lien vers une section spécifique. Ajoutez simplement le nom de la section derrière un # :<code - >Cela renvoie à [[syntaxe#interne|cette section]].</code> -> Cela renvoie à [[syntaxe#interne|cette section]].+[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.
  
-<WRAP center round info 60%> +You can use [[some:namespaces]] by using a colon in the pagename.
-  * Les liens vers les [[syntaxe|pages existantes]] sont affichés dans un style différent de ceux des [[pages inexistantes]]. +
-  * 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 il est activé. +
-  * Lorsque le titre d'une section est modifié, son signet change également. Alors ne comptez pas trop sur les liens de section. +
-</WRAP>+
  
 +  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 ====
  
-<code - >DokuWiki prend en charge les liens [[doku>Interwiki]]. Ce sont des liens rapides vers d'autres wikis. Par exemple, il s'agit d'un lien vers la page de Wikipédia sur les wikis : [[wp>Wiki]].</code>-> DokuWiki prend en charge les liens [[doku>Interwiki]]. Ce sont des liens rapides vers d'autres wikis. Par exemple, il s'agit d'un lien vers la page de Wikipédia sur les wikis : [[wp>Wiki]].+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]].
  
-  +  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]].
  
-==== Partages Windows ====+==== Windows Shares ====
  
-<code - >Les partages Windows comme [[\server\share|this]] sont également reconnus.</code>Veuillez noter que ceux-ci n'ont de sens que dans un groupe d'utilisateurs homogène comme un [[wp>Intranet]] d'entreprise.+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.+  Windows Shares like [[\\server\share|this]] are recognized, too.
  
-<WRAP center round info 60%> +Notes: 
-  * Pour des raisons de sécurité, la navigation directe sur les partages Windows ne fonctionne que dans Microsoft Internet Explorer par défaut (et uniquement dans la "zone locale"). + 
-  * Pour Mozilla et Firefox, il 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), mettez la ligne suivante dans ''conf/lang/en/lang.php'' (plus de détails sur [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]) :<code - conf/lang/en/lang.php>+  * 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
 /** /**
Ligne 77: Ligne 94:
 $lang['js']['nosmblinks'] = ''; $lang['js']['nosmblinks'] = '';
 </code> </code>
-</WRAP> 
  
 +==== Image Links ====
 +
 +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}}]]
  
-==== Liens d'images ====+Please note: The image formatting is the only formatting syntax accepted in link names.
  
-Vous pouvez également utiliser une image pour créer un lien vers une autre page interne ou externe en combinant la syntaxe des liens et des [[#images_and_other_files|images]] (voir ci-dessous) comme ceci :<code - >[[http://php.net|{{wiki:dokuwiki-128.png}}]]</code> -> [[http://php.net|{{wiki:dokuwiki-128.png}}]]+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).
  
-Remarque : Le format image est la seule syntaxe de mise en forme acceptée dans les noms de liens.+===== Footnotes =====
  
-L'intégralité de la syntaxe [[#images_and_other_files|image]] et [[#links|link]] est prise en charge (y compris le redimensionnement des images, les images et URL internes et externes et les liens interwiki). +You can add footnotes ((This is a footnote)) by using double parentheses.
-===== Notes de bas de page =====+
  
-Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en utilisant des doubles parenthèses. +  You can add footnotes ((This is a footnote)) by using double parentheses.
--> <code - >Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en utilisant des doubles parenthèses.</code>+
  
-===== Sectionnement =====+===== Sectioning =====
  
-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.+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 3 ====
Ligne 104: Ligne 125:
   == Headline Level 5 ==   == Headline Level 5 ==
  
-En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale : +By using four or more dashes, you can make a horizontal line: 
-<code - >----</code>->+
 ---- ----
  
-===== Fichiers multimédias =====+===== Media Files =====
  
-Vous pouvez inclure des [[doku>images|images externes et internes, des vidéos et des fichiers audio]] entre crochets. En option, vous pouvez spécifier leur taille.+You can include external and internal [[doku>images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them.
  
-Taille réelle:                        {{wiki:dokuwiki-128.png}}+Real size:                        {{wiki:dokuwiki-128.png}}
  
-Redimensionner à une largeur donnée :            {{wiki:dokuwiki-128.png?50}}+Resize to given width:            {{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, il sera recadré au nouveau rapport avant le redimensionnement)): {{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://secure.php.net/images/php.gif?200x50}}+Resized external image:           {{https://www.php.net/images/php.gif?200x50}}
  
-<code - >Taille réelle :                        {{wiki:dokuwiki-128.png}} +  Real size:                        {{wiki:dokuwiki-128.png}} 
-Redimensionner à une largeur donnée:            {{wiki:dokuwiki-128.png?50}} +  Resize to given width:            {{wiki:dokuwiki-128.png?50}} 
-Redimensionner à la largeur et à la hauteur données : {{wiki:dokuwiki-128.png?200x50}} +  Resize to given width and height: {{wiki:dokuwiki-128.png?200x50}} 
-Image externe redimensionnée :           {{https://secure.php.net/images/php.gif?200x50}}</code>+  Resized external image:           {{https://www.php.net/images/php.gif?200x50}}
  
-En utilisant des espaces à gauche ou à droite, vous pouvez choisir l'alignement.+ 
 +By using left or right whitespaces you can choose the alignment.
  
 {{ wiki:dokuwiki-128.png}} {{ wiki:dokuwiki-128.png}}
Ligne 133: Ligne 155:
 {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }}
  
-<code - >{{ wiki:dokuwiki-128.png}} +  {{ wiki:dokuwiki-128.png}} 
-{{wiki:dokuwiki-128.png }} +  {{wiki:dokuwiki-128.png }} 
-{{ wiki:dokuwiki-128.png }}</code>+  {{ wiki:dokuwiki-128.png }} 
 + 
 +You can also set the alignment explicitly with a ''?left'', ''?right'' or ''?center'' parameter. This takes precedence over the whitespace alignment above and can be combined with a size. 
 + 
 +{{wiki:dokuwiki-128.png?100&right}} 
 + 
 +  {{wiki:dokuwiki-128.png?100&right}}
  
-Bien sûr, vous pouvez également ajouter un titre (affiché sous forme d'info-bulle par la plupart des navigateurs).+Of course, you can add a title (displayed as a tooltip by most browsers), too.
  
 {{ wiki:dokuwiki-128.png |This is the caption}} {{ wiki:dokuwiki-128.png |This is the caption}}
  
-<code - >{{ wiki:dokuwiki-128.png |This is the caption}}</code>+  {{ wiki:dokuwiki-128.png |This is the caption}}
  
-Pour lier une image à une autre page, voir [[#Liens d'images]] ci-dessus.+For linking an image to another page see [[#Image Links]] above.
  
-==== Formats multimédias pris en charge ====+==== Supported Media Formats ====
  
-DokuWiki peut intégrer directement les formats multimédias suivants.+DokuWiki can embed the following media formats directly.
  
 | Image | ''gif'', ''jpg'', ''png''  | | Image | ''gif'', ''jpg'', ''png''  |
Ligne 154: Ligne 182:
 | Flash | ''swf''                    | | Flash | ''swf''                    |
  
-Si vous spécifiez un nom de fichier qui n'est pas un format multimédia pris en charge, il sera alors affiché sous forme de lien.+If you specify a filename that is not a supported media format, then it will be displayed as a link instead.
  
-En ajoutant ''?linkonly'', vous fournissez un lien vers le média sans l'afficher en ligne<code - >{{wiki:dokuwiki-128.png?linkonly}}</code>-> {{wiki:dokuwiki-128.png?linkonly}} Ceci est juste un lien vers l'image.+By adding ''?linkonly'' you provide a link to the media without displaying it inline
  
-==== Formats de secours ====+  {{wiki:dokuwiki-128.png?linkonly}} 
 + 
 +{{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image. 
 + 
 +==== Fallback Formats ====
  
 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. 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.
Ligne 170: Ligne 202:
 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. 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.
  
-===== Listes =====+===== Lists =====
  
-Dokuwiki prend en charge les listes ordonnées et non ordonnées. Pour créer un élément de liste, indentez votre texte de deux espaces et utilisez une ''*'' pour les listes non ordonnées ou un ''-'' pour les listes ordonnées.+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.
  
-  * Ceci est 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 article+  * Another item
  
-  - La même liste mais ordonnée +  - The same list but ordered 
-  - Un autre élément +  - Another item 
-    - Utilisez simplement l'indentation pour les niveaux plus profonds +    - Just use indention for deeper levels 
-  - C'est tout+  - That's it
  
 <code> <code>
-  * Ceci est 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 article+  * Another item
  
-  - La même liste mais ordonnée +  - The same list but ordered 
-  - Un autre élément +  - Another item 
-    - Utilisez simplement l'indentation pour les niveaux plus profonds +    - Just use indention for deeper levels 
-  - C'est tout+  - That's it
 </code> </code>
  
-Jetez également un œil à la [[doku>faq:lists|FAQ sur les éléments de liste]].+Also take a look at the [[doku>faq:lists|FAQ on list items]].
  
-===== Conversions de texte =====+===== Text Conversions =====
  
-DokuWiki peut convertir certains caractères ou chaînes prédéfinis en images, autre texte ou HTML.+DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML.
  
-La conversion de texte en image concerne surtout les smileys. Et la conversion de texte en HTML est utilisée pour les remplacements de typographie, mais peut également être configurée pour utiliser d'autres 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.
  
-==== Conversions de texte en image ====+==== Text to Image Conversions ====
  
-DokuWiki convertit les [[wp>émoticônes]] 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 :+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:
  
   * 8-) %%  8-)  %%   * 8-) %%  8-)  %%
Ligne 223: Ligne 255:
   * ;-) %%  ;-)  %%   * ;-) %%  ;-)  %%
   * ^_^ %%  ^_^  %%   * ^_^ %%  ^_^  %%
 +  * m(  %%  m(   %%
   * :?: %%  :?:  %%   * :?: %%  :?:  %%
   * :!: %%  :!:  %%   * :!: %%  :!:  %%
Ligne 229: Ligne 262:
   * 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)
-"Il pensait 'C'est un monde d'hommes'..."+"He thought 'It's a man's world'..."
  
 <code> <code>
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
-"Il pensait 'C'est un monde d'hommes'..."+"He thought 'It's a man's world'..."
 </code> </code>
  
-La même chose peut être faite pour produire n'importe quel type de HTML, il suffit de l'ajouter au [[doku>entities|pattern file]].+The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>entities|pattern file]].
  
-Trois exceptions ne proviennent pas de ce fichier de modèle : signe de multiplication (640x480), "guillemets simple" et "guillemets doubles". Ils peuvent être désactivés via une [[doku>config:typography|config option]].+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]].
  
-===== Citations =====+===== Quoting =====
  
-Parfois, vous voulez marquer un texte pour montrer qu'il s'agit d'une réponse ou d'un commentaire. Vous pouvez utiliser la syntaxe suivante :+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 qu'on devrait le faire+I think we should do it
  
-> Non, nous ne devrions pas+> No we shouldn't
  
->> Eh bien, je dis que nous devrions+>> Well, I say we should
  
-> Ah bon?+> Really?
  
 >> Yes! >> Yes!
Ligne 263: Ligne 296:
 </code> </code>
  
-je pense qu'on devrait le faire+I think we should do it
  
-> Non, nous ne devrions pas+> No we shouldn't
  
->> Eh bien, je dis que nous devrions+>> Well, I say we should
  
-> Ah bon?+> Really?
  
->> Oui!+>> Yes!
  
->>> Alors faisons-le !+>>> Then lets do it!
  
-===== Tableaux =====+===== Tables =====
  
-DokuWiki prend en charge une syntaxe simple pour créer des tableaux.+DokuWiki supports a simple syntax to create tables.
  
-^ Titre 1      ^ Titre 2       ^ Titre 3          ^ +^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
-| Ligne 1 Col 1    | Ligne 1 Col 2     | Ligne 1 Col 3        | +| Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
-| Ligne 2 Col 1    | fusion de colonnes (notez le double pipe) || +| Row 2 Col 1    | some colspan (note the double pipe) || 
-| Ligne 3 Col 1    | Ligne 3 Col 2     | Ligne 3 Col 3        |+| Row 3 Col 1    | Row 3 Col 2     | Row 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.+Table rows have to start and end with a ''|'' for normal rows or a ''^'' for headers.
  
-  ^ Titre 1      ^ Titre 2       ^ Titre 3          ^ +  ^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
-  | Ligne 1 Col 1    | Ligne 1 Col 2     | Ligne 1 Col 3        | +  | Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
-  | Ligne 2 Col 1    | fusion de colonnes (notez le double pipe) || +  | Row 2 Col 1    | some colspan (note the double pipe) || 
-  | Ligne 3 Col 1    | Ligne 3 Col 2     | Ligne 3 Col 3        |+  | Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |
  
-Pour connecter des cellules horizontalement, il suffit de rendre la cellule suivante complètement vide, comme indiqué ci-dessus. Assurez-vous d'avoir toujours la même quantité de séparateurs de cellules !+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!
  
-Les en-têtes de table verticaux sont également possibles.+Vertical tableheaders are possible, too.
  
-|              ^ Titre 1            ^ Titre 2          ^ +|              ^ Heading 1            ^ Heading 2          ^ 
-^ Titre 3    | Ligne 1 Col 2          | Ligne 1 Col 3        | +^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        | 
-^ Titre 4    | pas de fusion cette fois |                    | +^ Heading 4    | no colspan this time |                    | 
-^ Titre 5    | Ligne 2 Col 2          | Ligne 2 Col 3        |+^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |
  
-Comme vous pouvez le voir, c'est le séparateur de cellule avant une cellule qui décide de la mise en forme :+As you can see, it's the cell separator before a cell which decides about the formatting:
  
-  |              ^ Titre 1            ^ Titre 2          ^ +  |              ^ Heading 1            ^ Heading 2          ^ 
-  ^ Titre 3    | Ligne 1 Col 2          | Ligne 1 Col 3        | +  ^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        | 
-  ^ Titre 4    | pas de fusion cette fois |                    | +  ^ Heading 4    | no colspan this time |                    | 
-  ^ Titre 5    | Ligne 2 Col 2          | Ligne 2 Col 3        |+  ^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |
  
-Vous pouvez connecter verticalement des cellules en ajoutant ''%% :::%%'' dans les cellules en dessous de celle à laquelle elles doivent se connecter.+You can have rowspans (vertically connected cells) by adding ''%%:::%%'' into the cells below the one to which they should connect.
  
-^ Titre 1      ^ Titre 2                  ^ Titre 3          ^ +^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ 
-| Ligne 1 Col 1    | cette cellule s'étend verticalement | Ligne 1 Col 3        | +| Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
-| Ligne 2 Col 1    | :::                        | Ligne 2 Col 3        | +| Row 2 Col 1    | :::                        | Row 2 Col 3        | 
-| Ligne 3 Col 1    | :::                        | Ligne 2 Col 3        |+| Row 3 Col 1    | :::                        | Row 2 Col 3        |
  
-En dehors de la syntaxe de fusion de lignes, ces cellules ne doivent rien contenir d'autre.+Apart from the rowspan syntax those cells should not contain anything else.
  
-  ^ Titre 1      ^ Titre 2                  ^ Titre 3          ^ +  ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ 
-  | Ligne 1 Col 1    | cette cellule s'étend verticalement | Ligne 1 Col 3        | +  | Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
-  | Ligne 2 Col 1    | :::                        | Ligne 2 Col 3        | +  | Row 2 Col 1    | :::                        | Row 2 Col 3        | 
-  | Ligne 3 Col 1    | :::                        | Ligne 2 Col 3        |+  | Row 3 Col 1    | :::                        | Row 2 Col 3        |
  
-Vous pouvez également aligner le contenu du tableau. Ajoutez simplement 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 deux espaces au moins aux deux extrémités pour un texte centré.+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.
  
-^           Tableau avec alignement           ^^^ +^           Table with alignment           ^^^ 
-|         droite|    centre    |gauche          | +|         right|    center    |left          | 
-|gauche          |         droite|    centre    |+|left          |         right|    center    |
 | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-Voici à quoi cela ressemble dans la source :+This is how it looks in the source:
  
-  ^           Tableau avec alignement           ^^^ +  ^           Table with alignment           ^^^ 
-  |         droite|    centre    |gauche          | +  |         right|    center    |left          | 
-  |gauche          |         droite|    centre    |+  |left          |         right|    center    |
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-Remarque : l'alignement vertical n'est pas pris en charge.+Note: Vertical alignment is not supported.
  
-===== Pas de formatage =====+===== No Formatting =====
  
-Si vous avez besoin d'afficher du texte exactement comme il est tapé (sans aucun formatage), entourez la zone avec des balises ''%%<nowiki>%%'' ou encore plus simplement, avec des signes de pourcentage double ''<nowiki>%%</nowiki>''.+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>''.
  
 <nowiki> <nowiki>
-Ceci est un texte qui contient des adresses comme ceci: http://www.splitbrain.org et **mise en forme**, mais rien ne se fait+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 est de même pour %%//__ce__ texte// avec un smiley ;-)%%.+The same is true for %%//__this__ text// with a smiley ;-)%%.
  
   <nowiki>   <nowiki>
-  Ceci est un texte qui contient des adresses comme ceci: http://www.splitbrain.org et **mise en forme**, mais rien ne se fait avec elle.+  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 est de même pour %%//__ce__ texte// avec un smiley ;-)%%.+  The same is true for %%//__this__ text// with a smiley ;-)%%.
  
-===== Blocs de code =====+===== Code Blocks =====
  
-Vous pouvez inclure des blocs de code dans vos documents en les indentant d'au moins deux espaces (comme utilisé pour les exemples précédents) ou en utilisant les balises ''%%<code>%%'' or ''%%<file>%%''.+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>%%''.
  
-  Ce texte est indenté par deux espaces.+  This is text is indented by two spaces.
  
 <code> <code>
-Il s'agit de code préformaté, tous les espaces sont conservés : comme             <-this+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 pouvez 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 :+Those blocks were created by this source:
  
-  Ce texte est indenté par deux espaces.+    This is text is indented by two spaces.
  
   <code>   <code>
-  Il s'agit de 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 pouvez 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>
  
-==== Coloration syntaxique ====+==== Syntax Highlighting ====
  
-[[wiki:DokuWiki]] peut mettre en évidence le code source, ce qui le rend plus facile à lire. Il utilise le surligneur de syntaxe générique [[http://qbnz.com/highlighter/|GeSHi]] -- 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 du langage à mettre en évidence est inclus à l'intérieur de la balise, par ex. ''<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>
Ligne 393: Ligne 426:
 </code> </code>
  
-Les langages suivants sont actuellement reconnus: //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//+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//
  
-Des [[doku>syntax_highlighting|options avancées]] supplémentaires sont disponibles pour la coloration syntaxique, comme la coloration de lignes ou l'ajout de numéros de ligne.+There are additional [[doku>syntax_highlighting|advanced options]] available for syntax highlighting, such as highlighting lines or adding line numbers.
  
-==== Blocs de code téléchargeables ====+==== Downloadable Code Blocks ====
  
-Lorsque vous utilisez la syntaxe ''%%<code>%%'' ou ''%%<file>%%'' comme ci-dessus, vous souhaiterez peut-être également rendre le code affiché disponible au téléchargement. Vous pouvez le faire en spécifiant un nom de fichier après le code de langue comme ceci :+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>
Ligne 411: Ligne 444:
 </file> </file>
  
-Si vous ne voulez pas de surbrillance mais voulez un fichier téléchargeable, spécifiez un tiret (''-'') comme code de langage : ''%%<code - myfile.foo>%%''.+If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%<code - myfile.foo>%%''.
  
-===== Intégration de HTML et PHP =====+===== RSS/ATOM Feed Aggregation ===== 
 +[[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:
  
-Vous pouvez intégrer du code HTML ou PHP brut dans vos documents en utilisant les balises ''%%<html>%%'' ou ''%%<php>%%''. (Utilisez des balises majuscules si vous devez inclure des éléments de niveau bloc.)+^ Parameter  ^ Description ^ 
 +| any number | will be used as maximum number items to show, defaults to 8 | 
 +| reverse    | display the last items in the feed first | 
 +| author     | show item authors names | 
 +| date       | show item dates | 
 +| description| show the item description. All HTML tags will be stripped | 
 +| nosort     | do not sort the items in the feed | 
 +| //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |
  
-Exemple HTML :+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.
  
-<code> +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''.
-<html> +
-This is some <span style="color:red;font-size:150%;">inline HTML</span> +
-</html> +
-<HTML> +
-<p style="border:2px dashed red;">And this is some block HTML</p> +
-</HTML> +
-</code>+
  
-<html> +**Example:**
-This is some <span style="color:red;font-size:150%;">inline HTML</span> +
-</html> +
-<HTML> +
-<p style="border:2px dashed red;">And this is some block HTML</p> +
-</HTML> +
- +
-Exemple PHP : +
- +
-<code> +
-<php> +
-echo 'The PHP version: '; +
-echo phpversion(); +
-echo ' (generated inline HTML)'; +
-</php> +
-<PHP> +
-echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>'; +
-echo '<td>'.phpversion().'</td>'; +
-echo '</tr></table>'; +
-</PHP> +
-</code> +
- +
-<php> +
-echo 'The PHP version: '; +
-echo phpversion(); +
-echo ' (inline HTML)'; +
-</php> +
-<PHP> +
-echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>'; +
-echo '<td>'.phpversion().'</td>'; +
-echo '</tr></table>'; +
-</PHP> +
- +
-<WRAP center round info 60%> +
-L'intégration HTML et PHP est désactivée par défaut dans la configuration. Si désactivé, le code est affiché au lieu d'être exécuté. +
-</WRAP> +
- +
- +
-===== Agrégation de flux RSS/ATOM ===== +
- +
-[[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 par plusieurs paramètres supplémentaires séparés par des espaces : +
- +
-^ Paramètre ^ Description ^ +
-| n'importe quel nombre | sera utilisé comme nombre maximum d'éléments à afficher, la valeur par défaut est 8 | +
-| reverse    | afficher les derniers éléments du flux en premier | +
-| author     | afficher les noms des auteurs des éléments | +
-| date       | afficher les dates des articles | +
-| description| afficher la description de l'article. Si [[doku>config:htmlok|HTML]] est désactivé, toutes les balises seront supprimées | +
-| nosort     | ne pas trier les éléments dans l'alimentation | +
-| //n//[dhm] | période de rafraîchissement, où j=jours, h=heures, m=minutes. (par exemple 12h = 12 heures). | +
- +
-La période d'actualisation est par défaut de 4 heures. Toute valeur inférieure à 10 minutes sera considéré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 réafficher la page si elle est supérieure à //la période de rafraîchissement// depuis le dernier rendu de la page. +
- +
-Par défaut, le flux sera trié par date, les articles les plus récents en premier. Vous pouvez le trier par le plus ancien en premier en utilisant le paramètre ''reverse'', ou afficher le flux tel quel avec ''nosort''. +
- +
-**Exemple:**+
  
   {{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 }}
 +
  
 ===== Control Macros ===== ===== Control Macros =====
  
-Certaines syntaxes influencent la façon dont DokuWiki affiche une page sans créer de sortie lui-même. Les macros de contrôle suivantes sont disponibles :+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 toutes les sorties 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 forcera DokuWiki à réafficher 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 ===== ===== Syntax Plugins =====
  
-La syntaxe de DokuWiki peut être étendue par [[doku>plugins|Plugins]]. La façon 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 :+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:
  
 ~~INFO:syntaxplugins~~ ~~INFO:syntaxplugins~~
  

Piste :