Différences

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

--- wiki:syntax [2026/05/17 07:52] – [Partages Windows] chs
+++ wiki:syntax [2026/07/14 10:36] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
-====== Syntaxe de formatage ======
+====== Formatting Syntax ======
-[[doku>DokuWiki]] prend en charge un langage de balisage simple, qui s'efforce de rendre les fichiers de données aussi lisibles que possible. Cette page contient toutes les syntaxes que vous pouvez utiliser lors de l'édition des pages. Jetez simplement un œil au code source de cette page en cliquant sur « Modifier cette page ». Si vous voulez essayer quelque chose, utilisez simplement la page [[playground:playground|bac à sable (playground)]]. Le balisage le plus simple est également facilement accessible via les [[doku>toolbar|boutons de la barre d'outils]].
+[[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.
-===== Formatage de base du texte =====
+===== Basic Text Formatting =====
-DokuWiki prend en charge le texte en gras, //italique//, souligné et en ''chasse fixe (monospacé)''. Bien entendu, vous pouvez //''combiner''// tous ces formats.
+DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
-  DokuWiki prend en charge le texte en gras, //italique//, souligné et en ''chasse fixe (monospacé)''.
+  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts.
-  Bien entendu, vous pouvez //''combiner''// tout cela.
+  Of course you can **__//''combine''//__** all these.
-Vous pouvez également utiliser des indices subscript et des exposants superscript.
+Note that the formatting markers have to directly enclose the text, so ''%%** bold **%%'' with spaces inside the markers will not be formatted.
-  Vous pouvez également utiliser des <sub>indices</sub> et des <sub>exposants</sub>.
+You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
-Vous pouvez tout aussi bien marquer un élément comme <del>supprimé</del>.
+  You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
-  Vous pouvez tout aussi bien marquer un élément comme <del>supprimé</del>.
+You can mark something as <del>deleted</del> as well.
-Les **paragraphes** sont créés par des lignes vides. Si vous souhaitez **forcer un retour à la ligne** sans créer de paragraphe, vous pouvez utiliser deux barres obliques inverses (antislashs) suivies d'un espace ou de la fin de la ligne.
+  You can mark something as <del>deleted</del> as well.
-Ceci est un texte avec des retours à la ligne\\ Notez que les
+**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.
-deux antislashs ne sont reconnus qu'en fin de ligne\\
-ou suivis par\\ un espace \\ceci se produit sans cela.
-  Ceci est un texte avec des retours à la ligne\\ Notez que les
+This is some text with some linebreaks\\ Note that the
-  deux antislashs ne sont reconnus qu'en fin de ligne\\
+two backslashes are only recognized at the end of a line\\
-  ou suivis par\\ un espace \\ceci se produit sans cela.
+or followed by\\ a whitespace \\this happens without it.
-Vous ne devriez utiliser les retours à la ligne forcés que si cela 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 =====
-==== Liens externes ====
-Les liens externes sont reconnus automatiquement (par magie) : 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.
-  DokuWiki prend en charge plusieurs méthodes pour créer des liens. Les liens externes sont reconnus
+==== External ====
-  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.
-==== Liens internes ====
+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 en utilisant des crochets. Vous pouvez soit indiquer simplement un [[pagename]], soit utiliser en plus un [[pagename|texte de lien]].
+  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 en utilisant des crochets. Vous pouvez soit indiquer simplement
+==== Internal ====
-  un [[pagename]], soit utiliser en plus un [[pagename|texte de lien]].
-Les [[doku>pagename|noms de pages Wiki]] sont automatiquement convertis en minuscules, et 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]].
-Vous pouvez utiliser des [[some:namespaces|espaces de noms]] en insérant 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]].
-  Vous pouvez utiliser des [[some:namespaces]] en insérant des deux-points dans le nom de la page.
+[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.
-Pour plus de détails sur les espaces de noms, consultez [[doku>namespaces|les espaces de noms]].
-Créer un lien vers une section spécifique est également possible. Il suffit d'ajouter le nom de la section derrière un caractère dièse (#) comme en HTML. Ceci mène à [[syntax#internal|cette section]].
+You can use [[some:namespaces]] by using a colon in the pagename.
-  Ceci mène à [[syntax#internal|cette section]].
+  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:
-  * Les liens vers les [[syntax|pages existantes]] s'affichent dans un style différent des liens vers les pages [[nonexisting|non existantes]].
+  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones.
-  * DokuWiki n'utilise pas le [[wp>CamelCase]] pour créer des liens automatiquement par défaut, mais ce comportement peut être activé dans le fichier de [[doku>config]]. Astuce : si DokuWiki est un lien, alors c'est activé.
+  * 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.
-  * Lorsque le titre d'une section est modifié, son ancrage change aussi. Ne comptez donc pas trop sur les liens vers les sections.
+  * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.
 ==== Interwiki ====
-DokuWiki prend en charge les liens [[doku>Interwiki]]. Il s'agit de liens rapides vers d'autres wikis. Par exemple, voici un lien vers la page de Wikipédia concernant 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]].
-  DokuWiki prend en charge les liens [[doku>Interwiki]]. Il s'agit de liens rapides vers d'autres wikis.
+==== Windows Shares ====
-  Par exemple, voici un lien vers la page de Wikipédia concernant les wikis : [[wp>Wiki]].
-==== Partages Windows ====
-Les partages Windows comme [[\server\share|celui-ci]] sont également reconnus. Veuillez noter que ceux-ci n'ont de sens que dans un groupe d'utilisateurs homogène tel qu'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]].
-  Les partages Windows comme [[\server\share|celui-ci]] sont également reconnus.
+  Windows Shares like [[\\server\share|this]] are recognized, too.
 Notes:
-  * Pour des raisons de sécurité, l'accès direct aux partages Windows ne fonctionne par défaut que dans Microsoft Internet Explorer (et uniquement dans la « zone locale »).
+  * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone").
-  * Pour Mozilla et Firefox, cela peut être activé via différentes solutions de contournement mentionnées dans la [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|base de connaissances Mozilla]]. Cependant, un avertissement JavaScript concernant la tentative d'ouverture d'un partage Windows s'affichera toujours. Pour supprimer cet avertissement (pour tous les utilisateurs), ajoutez la ligne suivante dans le fichier ''conf/lang/fr/lang.php'' (plus de détails sur la page [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localisation]]) : <code - conf/lang/fr/lang.php>
+  * 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
 /**
@@ Ligne 153: / Ligne 158: @@
   {{wiki:dokuwiki-128.png }}
   {{ 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}}
 Of course, you can add a title (displayed as a tooltip by most browsers), too.