| Prochaine révision | Révision précédente |
| wiki:syntax [2025/05/14 08:57] – créée - modification externe 127.0.0.1 | wiki:syntax [2026/05/17 08:15] (Version actuelle) – [Headline Level 3] chs |
|---|
| ====== Formatting Syntax ====== | ====== Syntaxe de formatage ====== |
| |
| [[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. | [[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]]. |
| |
| ===== Basic Text Formatting ===== | ===== Formatage de base du texte ===== |
| |
| 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é)''. Bien entendu, vous pouvez //''combiner''// tous ces formats. |
| |
| DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. | DokuWiki prend en charge le texte en gras, //italique//, souligné et en ''chasse fixe (monospacé)''. |
| Of course you can **__//''combine''//__** all these. | Bien entendu, vous pouvez //''combiner''// tout cela. |
| |
| You can use <sub>subscript</sub> and <sup>superscript</sup>, too. | Vous pouvez également utiliser des indices subscript et des exposants superscript. |
| |
| You can use <sub>subscript</sub> and <sup>superscript</sup>, too. | Vous pouvez également utiliser des <sub>indices</sub> et des <sub>exposants</sub>. |
| |
| You can mark something as <del>deleted</del> as well. | Vous pouvez tout aussi bien marquer un élément comme <del>supprimé</del>. |
| |
| You can mark something as <del>deleted</del> as well. | Vous pouvez tout aussi bien marquer un élément comme <del>supprimé</del>. |
| |
| **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. | 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. |
| |
| This is some text with some linebreaks\\ Note that the | Ceci est un texte avec des retours à la ligne\\ Notez que les |
| two backslashes are only recognized at the end of a line\\ | deux antislashs ne sont reconnus qu'en fin de ligne\\ |
| or followed by\\ a whitespace \\this happens without it. | ou suivis par\\ un espace \\ceci se produit sans cela. |
| |
| This is some text with some linebreaks\\ Note that the | Ceci est un texte avec des retours à la ligne\\ Notez que les |
| two backslashes are only recognized at the end of a line\\ | deux antislashs ne sont reconnus qu'en fin de ligne\\ |
| or followed by\\ a whitespace \\this happens without it. | ou suivis par\\ un espace \\ceci se produit sans cela. |
| |
| You should use forced newlines only if really needed. | Vous ne devriez utiliser les retours à la ligne forcés que si cela est vraiment nécessaire. |
| |
| ===== Links ===== | ===== Liens ===== |
| |
| DokuWiki supports multiple ways of creating links. | DokuWiki prend en charge plusieurs méthodes pour créer des liens. |
| | ==== Liens externes ==== |
| |
| ==== External ==== | 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. |
| |
| External links are recognized automagically: http://www.google.com or simply www.google.com - You can set the link text as well: [[http://www.google.com|This Link points to google]]. Email addresses like this one: <andi@splitbrain.org> are recognized, too. | DokuWiki prend en charge plusieurs méthodes pour créer des liens. 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. External links are recognized | ==== Liens internes ==== |
| automagically: http://www.google.com or simply www.google.com - You can set | |
| link text as well: [[http://www.google.com|This Link points to google]]. Email | |
| addresses like this one: <andi@splitbrain.org> are recognized, too. | |
| |
| ==== Internal ==== | 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]]. |
| |
| Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]]. | 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]]. |
| |
| Internal links are created by using square brackets. You can either just give | Les [[doku>pagename|noms de pages Wiki]] sont automatiquement convertis en minuscules, et les caractères spéciaux ne sont pas autorisés. |
| a [[pagename]] or use an additional [[pagename|link text]]. | |
| |
| [[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed. | Vous pouvez utiliser des [[some:namespaces|espaces de noms]] en insérant deux-points dans le nom de la page. |
| |
| You can use [[some:namespaces]] by using a colon in the pagename. | Vous pouvez utiliser des [[some:namespaces]] en insérant des deux-points dans le nom de la page. |
| | |
| | Pour plus de détails sur les espaces de noms, consultez [[doku>namespaces|les espaces de noms]]. |
| |
| You can use [[some:namespaces]] by using a colon in the pagename. | 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]]. |
| |
| For details about namespaces see [[doku>namespaces]]. | Ceci mène à [[syntax#internal|cette section]]. |
| | |
| 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: | Notes: |
| |
| * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones. | * Les liens vers les [[syntax|pages existantes]] s'affichent dans un style différent des liens vers les pages [[nonexisting|non existantes]]. |
| * 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. | * 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é. |
| * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much. | * Lorsque le titre d'une section est modifié, son ancrage change aussi. Ne comptez donc pas trop sur les liens vers les sections. |
| ==== Interwiki ==== | ==== Interwiki ==== |
| |
| 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. 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. | DokuWiki prend en charge les liens [[doku>Interwiki]]. Il s'agit de liens rapides vers d'autres wikis. |
| For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]]. | Par exemple, voici un lien vers la page de Wikipédia concernant les wikis : [[wp>Wiki]]. |
| | ==== Partages Windows ==== |
| |
| ==== Windows Shares ==== | 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: | Notes: |
| |
| * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"). | * 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 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> | * 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> |
| <?php | <?php |
| /** | /** |
| </code> | </code> |
| |
| ==== Image Links ==== | ==== Liens sur image ==== |
| |
| 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 pointer vers une autre page interne ou externe en combinant la syntaxe des liens et celle des [[#images_and_other_files|images]] (voir ci-dessous) comme ceci : |
| |
| [[http://php.net|{{wiki:dokuwiki-128.png}}]] | [[http://php.net|{{wiki:dokuwiki-128.png}}]] |
| [[http://php.net|{{wiki:dokuwiki-128.png}}]] | [[http://php.net|{{wiki:dokuwiki-128.png}}]] |
| |
| Please note: The image formatting is the only formatting syntax accepted in link names. | Veuillez noter : le formatage d'image est la seule syntaxe de formatage acceptée dans les noms de liens. |
| | |
| 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). | |
| | |
| ===== Footnotes ===== | |
| |
| You can add footnotes ((This is a footnote)) by using double parentheses. | L'ensemble de la syntaxe des [[#images_and_other_files|images]] et des [[#links|liens]] est pris en charge (y compris le redimensionnement des images, les images internes et externes, les URL et les liens interwiki). |
| | ===== Notes de bas de page ===== |
| |
| You can add footnotes ((This is a footnote)) by using double parentheses. | Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en utilisant des doubles parenthèses. |
| |
| ===== Sectioning ===== | Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en utilisant des |
| | doubles parenthèses. |
| | ===== Niveaux de titres ===== |
| |
| 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. | Vous pouvez utiliser jusqu'à cinq niveaux de titres différents 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. |
| |
| ==== Headline Level 3 ==== | ==== Titre niveau 3 ==== |
| === Headline Level 4 === | === Titre niveau 4 === |
| == Headline Level 5 == | == Titre niveau 5 == |
| |
| ==== Headline Level 3 ==== | ==== Titre niveau 3 ==== |
| === Headline Level 4 === | === Titre niveau 4 === |
| == Headline Level 5 == | == Titre niveau 5 == |
| |
| By using four or more dashes, you can make a horizontal line: | En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale : |
| |
| ---- | ---- |