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
Prochaine révision
Révision précédente
wiki:syntax [2021/06/22 20:49] – [Syntax Highlighting] adminwiki:syntax [2022/08/13 21:35] (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 languagewhich 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 choseutilisez 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 =====+You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
  
-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 mark something as <del>deleted</delas well.
  
-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 videsSi vous souhaitez **forcer une nouvelle ligne** sans paragraphevous pouvez utiliser deux barres obliques inverses suivies d'un espace ou d'une fin de ligne.+**Paragraphs** are created from blank linesIf you want to **force a newline** without a paragraphyou can use two backslashes followed by a whitespace or the end of line.
  
-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\\ +This is some text with some linebreaks\\ Note that the 
-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\\ +two backslashes are only recognized at the end of a line\\ 
-ou suivi par\\ un espace \\voila ce qui se produit se produit sans espace.</code>+or followed by\\ a whitespace \\this happens without it.
  
-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 =====+You should use forced newlines only if really needed.
  
-DokuWiki prend en charge plusieurs méthodes pour créer des liens.+===== Links =====
  
-==== Externe ====+DokuWiki supports multiple ways of creating 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.+==== External ====
  
-<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 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.
  
-==== Interne ====+  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.
  
-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.+==== Internal ====
  
-[[doku>pagename|Les noms de pages Wiki]] sont automatiquement convertis en minuscules, les caractères spéciaux ne sont pas autorisés.+Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]].
  
-<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]].+[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.
  
-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]].+You can use [[some:namespaces]] by using a colon in the pagename.
  
-<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>+
  
 +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 wikisPar 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]] linksThese are quick links to other WikisFor 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, tooPlease 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]]. Cependantil 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]]. Howeverthere will still be a JavaScript warning about trying to open a Windows ShareTo 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 92:
 $lang['js']['nosmblinks'] = ''; $lang['js']['nosmblinks'] = '';
 </code> </code>
-</WRAP> 
  
 +==== Image Links ====
  
-==== Liens d'images ====+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:
  
-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}}]]+  [[http://php.net|{{wiki:dokuwiki-128.png}}]]
  
-Remarque Le format image est la seule syntaxe de mise en forme acceptée dans les noms de liens.+[[http://php.net|{{wiki:dokuwiki-128.png}}]]
  
-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). +Please note: The image formatting is the only formatting syntax accepted in link names.
-===== 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. +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).
--> <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 =====+===== Footnotes =====
  
-Vous pouvez utiliser jusqu'à cinq niveaux différents de titres pour structurer votre contenuSi vous avez plus de trois titresune 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 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 contentIf you have more than three headlinestable 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 123:
   == Headline Level 5 ==   == Headline Level 5 ==
  
-En utilisant quatre tirets ou plusvous pouvez créer une ligne horizontale +By using four or more dashesyou can make a horizontal line
-<code - >----</code>->+
 ---- ----
  
-===== Fichiers multimédias =====+===== Media Files =====
  
-Vous pouvez inclure des [[doku>images|images externes et internesdes vidéos et des fichiers audio]] entre crochetsEn option, vous pouvez spécifier leur taille.+You can include external and internal [[doku>images|images, videos and audio files]] with curly bracketsOptionally 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://secure.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://secure.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 153:
 {{ 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 }}
  
-Bien sûrvous pouvez également ajouter un titre (affiché sous forme d'info-bulle par la plupart des navigateurs).+Of courseyou 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 174:
 | Flash | ''swf''                    | | Flash | ''swf''                    |
  
-Si vous spécifiez un nom de fichier qui n'est pas un format multimédia pris en chargeil 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. 
 + 
 +By adding ''?linkonly'' you provide a link to the media without displaying it inline 
 + 
 +  {{wiki:dokuwiki-128.png?linkonly}}
  
-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.+{{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image.
  
-==== Formats de secours ====+==== 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 194:
 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éesPour créer un élément de listeindentez 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 listsTo create a list itemindent 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 typographiemais 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 replacementsbut 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 graphiquesCes [[doku>Smileys]] et autres images peuvent être configurés et étendusVoici un aperçu des Smileys inclus dans DokuWiki :+DokuWiki converts commonly used [[wp>emoticon]]s to their graphical equivalentsThose [[doku>Smileys]] and other images can be configured and extendedHere is an overview of Smileys included in DokuWiki:
  
   * 8-) %%  8-)  %%   * 8-) %%  8-)  %%
Ligne 223: Ligne 247:
   * ;-) %%  ;-)  %%   * ;-) %%  ;-)  %%
   * ^_^ %%  ^_^  %%   * ^_^ %%  ^_^  %%
 +  * m(  %%  m(   %%
   * :?: %%  :?:  %%   * :?: %%  :?:  %%
   * :!: %%  :!:  %%   * :!: %%  :!:  %%
Ligne 229: 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 correctesVoici un exemple de caractères reconnus.+Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entitiesHere 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 commentaireVous pouvez utiliser la syntaxe suivante :+Some times you want to mark some text to show it'a reply or commentYou 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 bienje dis que nous devrions+>> WellI say we should
  
-Ah bon?+Really?
  
 >> Yes! >> Yes!
Ligne 263: Ligne 288:
 </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 bienje dis que nous devrions+>> WellI 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 horizontalementil suffit de rendre la cellule suivante complètement vide, comme indiqué ci-dessusAssurez-vous d'avoir toujours la même quantité de séparateurs de cellules !+To connect cells horizontallyjust make the next cell completely empty as shown aboveBe 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 voirc'est le séparateur de cellule avant une cellule qui décide de la mise en forme :+As you can seeit'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 tableauAjoutez simplement au moins deux espaces à l'extrémité opposée de votre texte ajoutez deux espaces à gauche pour aligner à droitedeux 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, tooJust add at least two whitespaces at the opposite end of your textAdd two spaces on the left to align righttwo 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.+NoteVertical 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 simplementavec 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 simplerwith 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édentsou 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 examplesor 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 preservedlike              <-this
 </code> </code>
  
 <file> <file>
-C'est à peu près la même chosemais vous pouvez l'utiliser pour montrer que vous avez cité un fichier.+This is pretty much the samebut 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 preservedlike              <-this
   </code>   </code>
  
   <file>   <file>
-  C'est à peu près la même chosemais vous pouvez l'utiliser pour montrer que vous avez cité un fichier.+  This is pretty much the samebut 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 sourcece qui le rend plus facile à lireIl utilise le surligneur de syntaxe générique [[http://qbnz.com/highlighter/|GeSHi]] -- donc tout langage pris en charge par GeSHi est pris en chargeLa syntaxe utilise les mêmes blocs de code et de fichier décrits dans la section précédentemais cette fois le nom de la syntaxe du langage à mettre en évidence est inclus à l'intérieur de la balisepar ex. ''<nowiki><code java></nowiki>'' ou ''<nowiki><file java></nowiki>''.+[[wiki:DokuWiki]] can highlight sourcecodewhich makes it easier to readIt uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supportedThe 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 tage.g. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.
  
 <code java> <code java>
Ligne 393: Ligne 418:
 </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 syntaxiquecomme la coloration de lignes ou l'ajout de numéros de ligne.+There are additional [[doku>syntax_highlighting|advanced options]] available for syntax highlightingsuch as highlighting lines or adding line numbers.
  
 ==== Downloadable Code Blocks ==== ==== Downloadable Code Blocks ====
Ligne 412: Ligne 437:
  
 If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%<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>%%''.
 +
  
 ===== Embedding HTML and PHP ===== ===== Embedding HTML and PHP =====
Ligne 464: Ligne 490:
  
 ===== RSS/ATOM Feed Aggregation ===== ===== 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: [[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:
  
Ligne 485: Ligne 510:
  
 {{rss>http://slashdot.org/index.rss 5 author date 1h }} {{rss>http://slashdot.org/index.rss 5 author date 1h }}
 +
  
 ===== Control Macros ===== ===== Control Macros =====