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 17:20] – [Text to HTML Conversions] 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 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 =====+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</del> as 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 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.+**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.
  
-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 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 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 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 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 3 ====
Ligne 104: Ligne 123:
   == 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 ===== 
 + 
 +You can include external and internal [[doku>images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them.
  
-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.+Real size:                        {{wiki:dokuwiki-128.png}}
  
-Taille réelle:                        {{wiki:dokuwiki-128.png}}+Resize to given width:            {{wiki:dokuwiki-128.png?50}}
  
-Redimensionner à une largeur donnée :            {{wiki:dokuwiki-128.png?50}}+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}}
  
-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}}+Resized external image:           {{https://secure.php.net/images/php.gif?200x50}}
  
-Image externe redimensionnée :           {{https://secure.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://secure.php.net/images/php.gif?200x50}}
  
-<code - >Taille réelle :                        {{wiki:dokuwiki-128.png}} 
-Redimensionner à une largeur donnée:            {{wiki:dokuwiki-128.png?50}} 
-Redimensionner à la largeur et à la hauteur données : {{wiki:dokuwiki-128.png?200x50}} 
-Image externe redimensionnée :           {{https://secure.php.net/images/php.gif?200x50}}</code> 
  
-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û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 174:
 | 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. 
 + 
 +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é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]].
  
 ===== Text Conversions ===== ===== 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.
  
 ==== Text to Image Conversions ==== ==== 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 247:
   * ;-) %%  ;-)  %%   * ;-) %%  ;-)  %%
   * ^_^ %%  ^_^  %%   * ^_^ %%  ^_^  %%
 +  * m(  %%  m(   %%
   * :?: %%  :?:  %%   * :?: %%  :?:  %%
   * :!: %%  :!:  %%   * :!: %%  :!:  %%
Ligne 231: Ligne 256:
 ==== Text to HTML Conversions ==== ==== 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)
Ligne 241: Ligne 266:
 </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]].
  
 ===== Quoting ===== ===== Quoting =====
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 =====

Piste :