| |
| fr:wiki:syntax [2025/06/19 20:18] – Automatic push translation domele | fr:wiki:syntax [2026/08/03 19:10] (Version actuelle) – Automatic push translation domele |
|---|
| ====== Syntaxe de formatage ====== | ====== ======de la syntaxe de mise en forme |
| |
| [[doku>DokuWiki]] supporte un langage de balisage simple, qui tente de rendre les fichiers de données aussi lisibles que possible. Cette page contient toutes les syntaxes possibles que vous pouvez utiliser lors de l'édition des pages. Jetez simplement un coup d'œil à la source de cette page en cliquant sur "Editer cette page". Si vous voulez essayer quelque chose, utilisez simplement la page [[playground:playground|terrain de jeu]]. Les balises les plus simples sont facilement accessibles via [[doku>toolbar|boutons rapides]]. | prend en charge un langage de balisage simple, qui vise à rendre les fichiers de données aussi lisibles que possible. Cette page répertorie toutes les syntaxes que vous pouvez utiliser lors de la modification des pages. Il vous suffit de consulter le code source de cette page en cliquant sur « Modifier cette page ». Si vous souhaitez tester quelque chose, utilisez simplement la[[doku>DokuWiki]] [[playground:playground|page d'entraînement]]. Les balises les plus simples sont également facilement accessibles via [[doku>toolbar|boutons rapides]]. |
| |
| ===== Formatage du texte de base ===== | ===== Mise en forme de base du texte ===== |
| |
| DokuWiki supporte les caractères **gras**, //italique//, __souligné__ et ''monospaced'' textes. Bien entendu, vous pouvez **__//''combiner''//__** tous ces éléments. | DokuWiki prend en charge **le gras**, //italique//, __souligné__ et ''textes monospacés'' . Bien sûr, vous pouvez **__//''combiner''//__** toutes ces options. |
| |
| DokuWiki supporte les caractères **gras**, //italique//, __souligné__ et ''monospaced'' textes. | DokuWiki prend en charge **le gras**, //italique//, __souligné__ et ''textes à espacement fixe'' . |
| Bien entendu, vous pouvez **__//''combiner''//__** tous ces éléments. | Bien sûr, vous pouvez **__//''combiner''//__** toutes ces options. |
| |
| Vous pouvez utiliser <sub>indice</sub> et <sup>exposant</sup>également. | Notez que les balises de mise en forme doivent encadrer directement le texte, donc ''%%** gras **%%'' avec des espaces à l'intérieur des balises ne sera pas mis en forme. |
| |
| Vous pouvez utiliser l <sub>indice</sub> et <sup>exposant</sup>également. | Vous pouvez utiliser <sub>des indices</sub> et <sup>l'exposant</sup>. |
| | |
| | Vous pouvez également utiliser <sub>l'indice</sub> et <sup>l'exposant</sup>également. |
| |
| Vous pouvez marquer quelque chose comme <del>supprimé</del> également. | Vous pouvez marquer quelque chose comme <del>supprimé</del> également. |
| |
| Vous pouvez marquer quelque chose comme <del>supprimé</del> également. | Vous pouvez également marquer un élément comme <del>supprimé</del> également. |
| |
| **Les paragraphes** sont créés à partir de lignes vierges. 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. | **Les paragraphes** sont créés à partir de lignes vides. Si vous souhaitez **forcer un saut de ligne** sans créer de paragraphe, vous pouvez utiliser deux barres obliques inversées suivies d’un espace ou de la fin de ligne. |
| |
| Voici du texte avec des sauts de ligne\\ Notez que les | Voici un texte comportant des sauts de ligne\\ Notez que les |
| ne sont reconnus qu'en fin de ligne.\\ | deux barres obliques inversées ne sont reconnues qu’à la fin d’une ligne\\ |
| ou suivis d'un\\ d'un espace blanc \\ce qui n'est pas le cas ici. | ou s’ils sont suivis d’\\ un espace \\; sans cela, cela ne fonctionne pas. |
| |
| Voici du texte avec des sauts de ligne\\ Notez que les | Voici un texte comportant des sauts de ligne\\ Notez que les |
| ne sont reconnus qu'en fin de ligne.\\ | deux barres obliques inversées ne sont reconnues qu'à la fin d'une ligne\\ |
| ou suivis d'un\\ d'un espace blanc \\ce qui n'est pas le cas ici. | ou lorsqu'ils sont suivis d'\\ un espace \\cela se produit sans cela. |
| |
| Vous ne devriez utiliser des lignes de séparation forcées que si cela est vraiment nécessaire. | Vous ne devriez utiliser les sauts de ligne forcés qu’en cas de réelle nécessité. |
| |
| ===== Liens ===== | ===== Liens ===== |
| |
| DokuWiki permet de créer des liens de différentes manières. | DokuWiki prend en charge plusieurs façons de créer des liens. |
| |
| ==== Externes ==== | ==== Liens externes ==== |
| |
| 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|This Le lien pointe vers google]]. Les adresses électroniques comme celle-ci : <[email protected]> sont également reconnues. | 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|This Le lien pointe vers google]]. Les adresses e-mail comme celle-ci : <[email protected]> sont également reconnues. |
| |
| DokuWiki prend en charge plusieurs façons de créer des liens. Les liens externes sont reconnus | DokuWiki prend en charge plusieurs façons de créer des liens. Les liens externes sont reconnus |
| automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez également définir | automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez également définir |
| texte du lien : [[http://www.google.com|This Le lien pointe vers google]]. Les adresses | le texte du lien : [[http://www.google.com|This Le lien pointe vers google]]. Les adresses e-mail |
| comme celle-ci : <[email protected]> sont également reconnues. | comme celle-ci : <[email protected]> sont également reconnues. |
| |
| ==== Interne ==== | ==== Liens internes ==== |
| |
| Les liens internes sont créés en utilisant des crochets. Vous pouvez soit donner un simple [[en:wiki:pagename]] , soit utiliser un texte de lien supplémentaire [[en:wiki:pagename|texte de lien supplémentaire]]. | Les liens internes sont créés à l’aide de crochets. Vous pouvez soit indiquer simplement un [[de:wiki:pagename]] , soit utiliser un [[de:wiki:pagename|texte de lien]]. |
| |
| Les liens internes sont créés à l'aide de crochets. Vous pouvez soit donner | Les liens internes sont créés à l'aide de crochets. Vous pouvez soit indiquer simplement |
| un [[en:wiki:pagename]] ou utiliser un texte de lien supplémentaire [[en:wiki:pagename|texte de lien]]. | une [[de:wiki:pagename]] , soit utiliser un [[de:wiki:pagename|]]. |
| |
| [[doku>pagename|Les noms de pages wiki]] sont automatiquement convertis en minuscules, les caractères spéciaux ne sont pas autorisés. | [[doku>pagename|Les noms de pages Wiki]] sont automatiquement convertis en minuscules ; les caractères spéciaux ne sont pas autorisés. |
| |
| Vous pouvez utiliser [[some:namespaces]] en utilisant un deux-points dans le nom de domaine. | Vous pouvez utiliser [[some:namespaces]] en insérant deux points dans le nom de la page. |
| |
| Vous pouvez utiliser [[some:namespaces]] en utilisant un deux-points dans le nom de domaine. | Vous pouvez utiliser [[some:namespaces]] en insérant deux points dans le nom de la page. |
| |
| Pour plus de détails sur les espaces de noms, voir [[doku>namespaces]] . | Pour plus de détails sur les espaces de noms, consultez [[doku>namespaces]] . |
| |
| Il est également possible de créer un lien vers une section spécifique. Il suffit d'ajouter le nom de la section derrière un caractère dièse, comme en HTML. Ce lien renvoie à [[en:wiki:syntax#internal|cette section]]. | Il est également possible de créer un lien vers une section spécifique. Il suffit d'ajouter le nom de la section après le signe dièse, comme en HTML. Cela crée un lien vers [[fr:wiki:syntax#internal|cette section]]. |
| |
| Ce lien renvoie à [[en:wiki:syntax#internal|cette section]]. | Ce lien renvoie vers [[fr:wiki:syntax#internal|cette section]]. |
| |
| Notes : | Remarques : |
| |
| * Les liens vers les pages [[en:wiki:syntax|pages existantes]] sont affichés dans un style différent de ceux de [[en:wiki:nonexisting]] . | * Les liens vers [[fr:wiki:syntax|des pages existantes]] s’affichent dans un style différent de celui des liens [[de:wiki:nonexisting]] . |
| * 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]] . Indice : si DokuWiki est un lien, alors il est activé. | * Par défaut, DokuWiki n’utilise pas [[wp>CamelCase]] pour créer automatiquement des liens, mais ce comportement peut être activé dans le fichier [[doku>config]] . Astuce : si « DokuWiki » est un lien, cela signifie que cette fonctionnalité est activée. |
| * Lorsque le titre d'une section est modifié, son signet change également. Ne comptez donc pas trop sur les liens de section. | * Lorsque le titre d’une section est modifié, son signet change également. Ne vous fiez donc pas trop aux liens vers les sections. |
| |
| ==== Interwiki ==== | ==== Interwiki ==== |
| |
| DokuWiki supporte les liens [[doku>Interwiki]] . Il s'agit de liens rapides vers d'autres Wikis. Par exemple, voici un lien vers la page de Wikipedia sur les 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 consacrée aux wikis : [[wp>Wiki]] . |
| |
| DokuWiki supporte les liens [[doku>Interwiki]] . Il s'agit de liens rapides vers d'autres Wikis. | 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 Wikipedia sur les Wikis : [[wp>Wiki]] . | Par exemple, voici un lien vers la page Wikipédia consacrée aux wikis : [[wp>Wiki]] . |
| |
| ==== Partage de Windows ==== | ==== Partages Windows ==== |
| |
| Les partages Windows comme [[\\server\share|cette]] sont également reconnus. Veuillez noter que ces partages n'ont de sens que dans un groupe d'utilisateurs homogène tel qu'une entreprise [[wp>Intranet]] . | Les partages Windows tels que [[\\server\share|celui-ci]] sont également reconnus. Veuillez noter que ceux-ci n’ont de sens que dans un groupe d’utilisateurs homogène, comme un [[wp>Intranet d’entreprise]]. |
| |
| Les partages Windows comme [[\\server\share|comme]] sont également reconnus. | Les partages Windows tels que [[\\server\share|celle-ci]] sont également reconnus. |
| |
| Notes : | Remarques : |
| |
| * Pour des raisons de sécurité, l'exploration directe des partages Windows ne fonctionne par défaut que dans Microsoft Internet Explorer (et uniquement dans la "zone locale"). | * Pour des raisons de sécurité, la navigation directe vers des partages Windows ne fonctionne par défaut que dans Microsoft Internet Explorer (et uniquement dans la « zone locale »). |
| * Pour Mozilla et Firefox, elle peut être activée par le biais d'une solution de contournement mentionnée dans la [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Base de connaissances]]. Cependant, il y aura toujours un avertissement JavaScript lors de la tentative d'ouverture d'un partage Windows. Pour supprimer cet avertissement (pour tous les utilisateurs), ajoutez la ligne suivante dans ''conf/lang/fr/lang.php'' (pour plus de détails, voir [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localisation]]) : <code - conf/lang/en/lang.php> | * Pour Mozilla et Firefox, cette fonctionnalité peut être activée grâce à différentes solutions de contournement mentionnées dans la [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Base de connaissances]]. Cependant, un avertissement JavaScript s'affichera toujours lors de la tentative d'ouverture d'un partage Windows. Pour supprimer cet avertissement (pour tous les utilisateurs), ajoutez 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|localisation]]) : <code - conf/lang/en/lang.php> |
| <?php | <?php |
| /** | /** |
| </code> | </code> |
| |
| ==== Liens d'image ==== | ==== Liens vers des images ==== |
| |
| 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 [[en:wiki:syntax#images_and_other_files|images]] (voir ci-dessous) comme suit : | 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 celle des [[fr:wiki:syntax#images_and_other_files|d'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}}]] |
| |
| Remarque : la mise en forme de l'image est la seule syntaxe de mise en forme acceptée dans les noms de liens. | Remarque : la mise en forme des images est la seule syntaxe de mise en forme acceptée dans les noms de liens. |
| |
| L'ensemble de l'image [[en:wiki:syntax#images_and_other_files|image]] et [[en:wiki:syntax#links|lien]] (y compris le redimensionnement de l'image, les images internes et externes, les URL et les liens interwiki). | L'image entière [[fr:wiki:syntax#images_and_other_files|]] d’image et [[fr:wiki:syntax#links|]] de lien est prise en charge (y compris le redimensionnement des images, les images internes et externes, les URL et les liens interwiki). |
| |
| ===== Notes de bas de page ===== | ===== 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. | Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en utilisant des doubles parenthèses. |
| |
| ===== Sectionnement ===== | ===== Structuration en sections ===== |
| |
| 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 - ceci peut être désactivé en incluant la chaîne de caractères ''<nowiki>~~NOTOC~~</nowiki>'' dans le document. | 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 — cette fonctionnalité peut être désactivée en incluant la chaîne ''<nowiki>~~NOTOC~~</nowiki>'' dans le document. |
| |
| ==== Titre Niveau 3 ==== | ==== Titre de niveau 3 ==== |
| === Titre Niveau 4 === | === Titre de niveau 4 === |
| == Titre niveau 5 == | == Titre de niveau 5 == |
| |
| ==== Titre niveau 3 ==== | ==== Titre de niveau 3 ==== |
| === Titre niveau 4 === | === Titre de niveau 4 === |
| == Titre niveau 5 == | == Titre de niveau 5 == |
| |
| En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale : | En utilisant au moins quatre tirets, vous pouvez créer une ligne horizontale : |
| |
| ---- | ---- |
| ===== Fichiers multimédias ===== | ===== Fichiers multimédias ===== |
| |
| Vous pouvez inclure des images, des vidéos et des fichiers audio externes et internes [[doku>images|externes et internes, des vidéos et des fichiers audio]] avec des crochets. Vous pouvez également spécifier la taille de ces fichiers. | Vous pouvez inclure des [[doku>images|]] à l’aide d’accolades. Vous pouvez éventuellement spécifier leur taille. |
| |
| Taille réelle : {{wiki:dokuwiki-128.png}} | Taille réelle : {{wiki:dokuwiki-128.png }} |
| |
| Redimensionner à la largeur donnée : {{wiki:dokuwiki-128.png?50}} | Redimensionner à la largeur indiquée : {{wiki:dokuwiki-128.png?50 }} |
| |
| Redimensionner à la largeur et à la hauteur données ((lorsque le rapport d'aspect de la largeur et de la hauteur données ne correspond pas à celui de l'image, celle-ci sera recadrée au nouveau rapport avant d'être redimensionnée)) : {{wiki:dokuwiki-128.png?200x50}} | Redimensionnement à une largeur et une hauteur données (lorsque le rapport hauteur/largeur de la largeur et de la hauteur indiquées ne correspond pas à celui de l’image, celle-ci sera recadrée selon le nouveau rapport avant le redimensionnement) : {{wiki:dokuwiki-128.png?200x50}} |
| |
| Redimensionnement d'une image externe : {{https://www.php.net/images/php.gif?200x50}} | Image externe redimensionnée : {{https://www.php.net/images/php.gif?200x50}} |
| |
| Taille réelle : {{wiki:dokuwiki-128.png}} | Taille réelle : {{wiki:dokuwiki-128.png }} |
| Redimensionner à la largeur donnée : {{wiki:dokuwiki-128.png?50}} | Redimensionner à la largeur indiquée : {{wiki:dokuwiki-128.png?50 }} |
| Redimensionner à la largeur et à la hauteur données : {{wiki:dokuwiki-128.png?200x50}} | Redimensionner à la largeur et à la hauteur indiquées : {{wiki:dokuwiki-128.png?200x50}} |
| Image externe redimensionnée : {{https://www.php.net/images/php.gif?200x50}} | Image externe redimensionnée : {{https://www.php.net/images/php.gif?200x50}} |
| |
| |
| En utilisant des espaces blancs à gauche ou à droite, vous pouvez choisir l'alignement. | En utilisant des espaces à gauche ou à droite, vous pouvez choisir l'alignement. |
| |
| {{ wiki:dokuwiki-128.png}} | {{ wiki:dokuwiki-128.png}} |
| |
| {{wiki:dokuwiki-128.png }} | {{wiki:dokuwiki-128.png }} |
| |
| {{ wiki:dokuwiki-128.png }} | {{ wiki:dokuwiki-128.png }} |
| |
| {{ wiki:dokuwiki-128.png}} | {{ wiki:dokuwiki-128.png }} |
| {{wiki:dokuwiki-128.png }} | {{wiki:dokuwiki-128.png }} |
| {{ wiki:dokuwiki-128.png }} | {{ wiki:dokuwiki-128.png }} |
| |
| Bien entendu, vous pouvez également ajouter un titre (affiché sous forme d'info-bulle par la plupart des navigateurs). | Vous pouvez également définir explicitement l'alignement à l'aide d'un ''?left'', ''?right'' ou ''?center'' . Ce paramètre a priorité sur l'alignement par espaces ci-dessus et peut être combiné avec une taille. |
| |
| {{ wiki:dokuwiki-128.png |Voici la légende}} | {{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). |
| | |
| | {{ wiki:dokuwiki-128.png |Voici la légende :}} |
| |
| {{ wiki:dokuwiki-128.png |Voici la légende}} | {{ wiki:dokuwiki-128.png |Voici la légende}} |
| |
| Pour lier une image à une autre page, voir [[en:wiki:syntax#Image Links]] ci-dessus. | Pour créer un lien vers une autre page à partir d’une image, consultez [[fr:wiki:syntax#Image Links]] ci-dessus. |
| |
| ==== Formats de médias pris en charge ==== | ==== Formats multimédias pris en charge ==== |
| |
| DokuWiki peut intégrer directement les formats de médias suivants. | DokuWiki peut intégrer directement les formats multimédias suivants. |
| |
| | Image | ''gif'', ''jpg'', ''png'' | | | Image | ''gif'', ''jpg'', ''png'' | |
| | Vidéo | ''webm'', ''ogv'', ''mp4'' | | | Vidéo | ''webm'', ''ogv'', ''mp4''| |
| | Audio | ''ogg'', ''mp3'', ''wav'' | | | | audio ''ogg'', ''mp3'', ''wav'' | |
| | 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 affiché sous forme de lien. | Si vous indiquez un nom de fichier qui n'est pas un format multimédia pris en charge, celui-ci s'affichera alors sous forme de lien. |
| |
| En ajoutant ''?linkonly'' vous fournissez un lien vers le média sans l'afficher en ligne | En ajoutant ''?linkonly'' , vous fournissez un lien vers le fichier multimédia sans l'afficher directement dans la page |
| |
| {{wiki:dokuwiki-128.png?linkonly}} | {{wiki:dokuwiki-128.png?linkonly }} |
| |
| {{wiki:dokuwiki-128.png?linkonly}} Il s'agit simplement d'un lien vers l'image. | {{wiki:dokuwiki-128.png?linkonly}} Il s'agit simplement d'un lien vers l'image. |
| |
| ==== Formats de repli ==== | ==== Formats de secours ==== |
| |
| Malheureusement, tous les navigateurs ne comprennent pas tous les formats vidéo et audio. Pour atténuer ce problème, vous pouvez télécharger votre fichier dans différents formats afin d'assurer une compatibilité maximale avec les navigateurs. | Malheureusement, tous les navigateurs ne prennent pas en charge tous les formats vidéo et audio. Pour pallier ce problème, vous pouvez mettre en ligne votre fichier dans différents formats afin d'assurer une compatibilité maximale avec les navigateurs. |
| |
| Prenons l'exemple de cette vidéo mp4 intégrée : | Prenons par exemple cette vidéo mp4 intégrée : |
| |
| {{en:wiki:video.mp4|Une vidéo amusante}} | {{de:wiki:video.mp4|Une vidéo amusante}} |
| |
| Lorsque vous téléchargez un fichier ''video.webm'' et ''video.ogv'' à côté du fichier ''video.mp4''DokuWiki les ajoutera automatiquement comme alternatives afin que l'un des trois fichiers soit compris par votre navigateur. | Lorsque vous téléchargez une ''fichier vidéo .webm'' et ''video.ogv'' à côté du fichier ''video.mp4'', DokuWiki les ajoutera automatiquement en tant qu’alternatives afin que l’un des trois fichiers soit pris en charge par votre navigateur. |
| | |
| En outre, DokuWiki prend en charge une image "poster" qui sera affichée avant le début de la vidéo. Cette image doit avoir le même nom de fichier que la vidéo et être un fichier jpg ou png. Dans l'exemple ci-dessus, un fichier ''video.jpg'' fonctionnerait. | |
| |
| | De plus, DokuWiki prend en charge une image « d'affiche » qui s'affichera avant le démarrage de la vidéo. Cette image doit porter le même nom de fichier que la vidéo et être au format jpg ou png. Dans l'exemple ci-dessus, un fichier ''video.jpg'' conviendrait. |
| ===== Listes ===== | ===== Listes ===== |
| |
| Dokuwiki supporte 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 balise ''*'' pour les listes non ordonnées ou un ''-'' pour les listes ordonnées. | 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 balise ''*'' pour les listes non ordonnées ou un ''-'' pour les listes ordonnées. |
| |
| * Ceci est une liste | * Voici une liste |
| * Le deuxième élément | * Le deuxième élément |
| * Vous pouvez avoir différents niveaux | * Vous pouvez avoir différents niveaux |
| * Un autre élément | * Un autre élément |
| |
| - La même liste mais ordonnée | - La même liste, mais ordonnée |
| - Autre élément | - Un autre élément |
| - Il suffit d'utiliser l'indention pour les niveaux plus profonds | - Il suffit d'utiliser l'indentation pour les niveaux plus profonds |
| - C'est tout | - C'est tout |
| |
| </code> | </code> |
| |
| Jetez également un coup d'œil à la [[doku>faq:lists|FAQ sur les éléments de la liste]]. | Consultez également la [[doku>faq:lists|FAQ sur les éléments de liste]]. |
| |
| ===== Conversions de texte ===== | ===== Conversions de texte ===== |
| |
| DokuWiki peut convertir certains caractères ou chaînes de caractères prédéfinis en images ou autres textes ou HTML. | DokuWiki peut convertir certains caractères ou chaînes prédéfinis en images, en autre texte ou en code HTML. |
| |
| La conversion de texte en image est principalement utilisée pour les smileys. Et la conversion de texte en HTML est utilisée pour les remplacements de typographie, mais peut être configurée pour utiliser d'autres HTML également. | La conversion de texte en image est principalement utilisée pour les smileys. Quant à la conversion de texte en HTML, elle sert à remplacer des éléments typographiques, mais peut être configurée pour utiliser d’autres éléments HTML également. |
| |
| ==== Conversions texte-image ==== | ==== Conversions de texte en image ==== |
| |
| DokuWiki convertit les images [[wp>emoticon]] couramment utilisées en leurs équivalents graphiques. Ces [[doku>Smileys]] et d'autres images peuvent être configurées et étendues. Voici un aperçu des Smileys inclus dans DokuWiki : | DokuWiki convertit les [[wp>emoticon]] s couramment utilisés en leurs équivalents graphiques. Ces [[doku>Smileys]] et autres images peuvent être configurées et étendues. Voici un aperçu des smileys inclus dans DokuWiki : |
| |
| * 8-) %% 8-) %% | * 8-) %% 8-) %% |
| * 8-O %% 8-O %% | * 8-O %% 8-O %% |
| * :-( %% :-( %% | * :-( %% :-( %% |
| * :-) %% :-) %% | * :-) %% :-) %% |
| * =) %% =) %% | * =) %% = ) %% |
| * :-/ %% :-/ %% | * :-/ %% :-/ %% |
| * :-\ %% :-\ %% | * :-\ %% :-\ %% |
| * :-? %% :-? %% | * :-? %% :-? %% |
| * :-D %% :-D %% | * :-D %% :-D %% |
| * :-P %% :-P %% | * :-P %% :-P %% |
| * :-O %% :-O %% | * :-O %% :-O %% |
| * :-X %% :-X %% | * :-X %% :-X %% |
| * :-| %% :-| %% | * :-| %% :-| %% |
| * ;-) %% ;-) %% | * ;-) %% ;-) %% |
| * ^_^ %% ^_^ %% | * ^_^ %% ^_^ %% |
| * m( %% m( %% | * m( %% m( %% |
| * :?: %% :?: %% | * :?: %% :?: %% |
| * :!: %% :!: %% | * :!: %% :!: %% |
| * LOL %% LOL %% | * LOL %% LOL %% |
| * FIXME %% FIXME %% | * FIXME %% FIXME %% |
| * DELETEME %% DELETEME %% | * DELETEME %% DELETEME %% |
| | ==== Conversions de texte en HTML ==== |
| |
| ==== Conversions texte vers HTML ==== | Typographie : [[de:wiki:dokuwiki]] permet de convertir des caractères de texte simples en entités typographiques correctes. Voici un exemple de caractères reconnus. |
| |
| Typographie : [[en:wiki:dokuwiki]] peut convertir des caractères de texte simples en leurs entités typographiquement correctes. Voici un exemple de caractères reconnus. | -> <- <->=> <= <=> >> << -- --- 640x480 (c) (tm) (r) |
| | |
| -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | |
| "He thought 'It's a man's world'..." | "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 fichier de motifs [[doku>entities|fichier de motifs]]. | La même procédure peut être utilisée pour générer n'importe quel type de code HTML ; il suffit de l'ajouter au [[doku>entities|fichier de modèles]]. |
| |
| Il existe trois exceptions qui ne proviennent pas de ce fichier de motifs : l'entité de multiplication (640x480), les "guillemets simples" et les "guillemets doubles". Elles peuvent être désactivées par l'intermédiaire d'une option de configuration [[doku>config:typography|option de configuration]]. | Il existe trois exceptions qui ne proviennent pas de ce fichier de modèles : l’entité de multiplication (640x480), les « guillemets simples » et les « guillemets doubles ». Elles peuvent être désactivées via une [[doku>config:typography|option de configuration]]. |
| |
| ===== Citations ===== | ===== Citations ===== |
| |
| Il arrive que vous souhaitiez marquer un texte pour indiquer qu'il s'agit d'une réponse ou d'un commentaire. Vous pouvez utiliser la syntaxe suivante : | Il arrive parfois que l’on souhaite mettre en évidence un texte pour indiquer qu’il s’agit d’une réponse ou d’un commentaire. Vous pouvez utiliser la syntaxe suivante : |
| |
| <code> | <code> |
| </code> | </code> |
| |
| Je pense que nous devrions le faire | Je pense qu’on devrait le faire |
| |
| > Non, nous ne devrions pas | > Non, on ne devrait pas |
| |
| >> Eh bien, je dis que nous devrions le faire | >> Eh bien, moi je dis qu’on devrait |
| |
| > Vraiment ? | > Vraiment ? |
| >> Oui ! | >> Oui ! |
| |
| >>> Alors faisons-le ! | >>> Alors allons-y ! |
| |
| ===== Tables ===== | ===== Tableaux ===== |
| |
| DokuWiki supporte une syntaxe simple pour créer des tableaux. | DokuWiki prend en charge une syntaxe simple pour créer des tableaux. |
| |
| ^ Rubrique 1 ^ Titre 2 ^ Titre 3 ^ | ^ Titre 1 ^ Titre 2 ^ Titre 3 ^ |
| | Ligne 1 Col 1 | Ligne 1 Col 2 | Ligne 1 Col 3 | | | Ligne 1 Colonne 1 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | |
| | Ligne 2 Col 1 | quelques colspan (notez le double tuyau) || | | Ligne 2 Colonne 1 | colspan (notez la double barre verticale) || |
| | Ligne 3 Col 1 | Ligne 3 Col 2 | Ligne 3 Col 3 | | | Ligne 3 Colonne 1 | Ligne 3 Colonne 2 | Ligne 3 Colonne 3 | |
| |
| Les lignes du tableau doivent commencer et se terminer par un ''|'' pour les lignes normales ou un ''^'' pour les en-têtes. | Les lignes du tableau doivent commencer et se terminer par un ''|'' pour les lignes normales ou par un ''^'' pour les en-têtes. |
| |
| ^ Titre 1 ^ Titre 2 ^ Titre 3 ^ | ^ En-tête 1 ^ Titre 2 ^ Titre 3 ^ |
| | Ligne 1 Col 1 | Ligne 1 Col 2 | Ligne 1 Col 3 | | | Ligne 1 Colonne 1 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | |
| | Ligne 2 Col 1 | quelques colspan (notez le double tuyau) || | | Ligne 2 Colonne 1 | colspan (notez le double bar) || |
| | Ligne 3 Col 1 | Ligne 3 Col 2 | Ligne 3 Col 3 | | | Ligne 3 Colonne 1 | Ligne 3 Colonne 2 | Ligne 3 Colonne 3 | |
| |
| Pour relier des cellules horizontalement, il suffit de vider complètement la cellule suivante, comme indiqué ci-dessus. Veillez à toujours avoir le même nombre de séparateurs de cellules ! | Pour relier des cellules horizontalement, il suffit de laisser la cellule suivante entièrement vide, comme indiqué ci-dessus. Veillez à toujours utiliser le même nombre de séparateurs de cellules ! |
| |
| Les en-têtes de table verticaux sont également possibles. | Il est également possible d'ajouter des en-têtes de tableau verticaux. |
| |
| | ^ Titre 1 ^ Titre 2 ^ | | ^ En-tête 1 ^ En-tête 2 ^ |
| ^ Rubrique 3 | Ligne 1 Col 2 | Ligne 1 Col 3 | | ^ En-tête 3 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | |
| ^ Titre 4 | pas de colspan cette fois | | | ^ Titre 4 | pas de colspan cette fois-ci | | |
| ^ Titre 5 | Ligne 2 Col 2 | Ligne 2 Col 3 | | ^ Titre 5 | Ligne 2, colonne 2 | Ligne 2, colonne 3 | |
| |
| Comme vous pouvez le constater, c'est le séparateur de cellules avant une cellule qui décide de la mise en forme : | Comme vous pouvez le constater, c'est le séparateur de cellule situé avant une cellule qui détermine la mise en forme : |
| |
| | ^ Titre 1 ^ Titre 2 ^ | | ^ Titre 1 ^ Titre 2 ^ |
| ^ Rubrique 3 | Ligne 1 Col 2 | Ligne 1 Col 3 | | ^ Titre 3 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | |
| ^ Titre 4 | pas de colspan cette fois | | | ^ Titre 4 | pas de colspan cette fois-ci | | |
| ^ Titre 5 | Ligne 2 Col 2 | Ligne 2 Col 3 | | ^ Titre 5 | Ligne 2, colonne 2 | Ligne 2, colonne 3 | |
| |
| Vous pouvez avoir des interlignes (cellules connectées verticalement) en ajoutant ''%%:::%%'' dans les cellules situées en dessous de celle à laquelle elles doivent être reliées. | Vous pouvez créer des « rowspans » (cellules reliées verticalement) en ajoutant ''%%:::%%'' dans les cellules situées sous celle à laquelle elles doivent être reliées. |
| |
| ^ Titre 1 ^ Titre 2 ^ Titre 3 ^ | ^ Titre 1 ^ Titre 2 ^ Titre 3 ^ |
| | Ligne 1 Col 1 | cette cellule s'étend verticalement | Ligne 1 Col 3 | | | Ligne 1 Colonne 1 | cette cellule s'étend verticalement | Ligne 1 Colonne 3 | |
| | Ligne 2 Col 1 | :: : | Ligne 2 Col 3 | | | Ligne 2 Colonne 1 | ::: | Ligne 2, colonne 3 | |
| | Ligne 3 Col 1 | :: : | Ligne 2 Col 3 | | | Ligne 3 Colonne 1 | ::: | Ligne 2 Colonne 3 | |
| |
| En dehors de la syntaxe de l'interligne, ces cellules ne doivent contenir rien d'autre. | Hormis la syntaxe « rowspan », ces cellules ne doivent rien contenir d'autre. |
| |
| ^ Titre 1 ^ Titre 2 ^ Titre 3 ^ | ^ Titre 1 ^ Titre 2 ^ Titre 3 ^ |
| | Ligne 1 Col 1 | cette cellule s'étend verticalement | Ligne 1 Col 3 | | | Ligne 1 Colonne 1 | cette cellule s'étend verticalement sur | Ligne 1 Colonne 3 | |
| | Ligne 2 Col 1 | :: : | Ligne 2 Col 3 | | | Ligne 2, colonne 1 | ::: | Ligne 2 Colonne 3 | |
| | Ligne 3 Col 1 | :: : | Ligne 2 Col 3 | | | Ligne 3 Colonne 1 | ::: | Ligne 2 Colonne 3 | |
| |
| Vous pouvez également aligner le contenu du tableau. Il vous suffit d'ajouter 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é. | Vous pouvez également aligner le contenu du tableau. Il suffit d'ajouter 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 au moins deux espaces à chaque extrémité pour centrer le texte. |
| |
| ^ Tableau avec alignement ^^^ | ^ Tableau avec alignement ^^^ |
| | à droite| centre |gauche | | | à droite| centré |à gauche | |
| |gauche | droite| centre | | |à gauche | à droite| au centre | |
| | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | |
| |
| Voici à quoi cela ressemble dans la source : | Voici à quoi cela ressemble dans le code source : |
| |
| ^ Tableau avec alignement ^^^ | ^ Tableau avec alignement ^^^ |
| | à droite| centre |gauche | | | à droite| au centre |à gauche | |
| |gauche | droite| centre | | |gauche | à droite| centre | |
| | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | |
| |
| Note : L'alignement vertical n'est pas pris en charge. | Remarque : l'alignement vertical n'est pas pris en charge. |
| |
| ===== Pas de formatage ===== | ===== Pas de mise en forme ===== |
| |
| Si vous souhaitez afficher le texte tel qu'il est tapé (sans aucune mise en forme), entourez la zone de l'un ou l'autre des éléments suivants ''%%<nowiki>%%'' ou, plus simplement encore, par des doubles signes de pourcentage ''<nowiki>%%</nowiki>''. | Si vous souhaitez afficher le texte exactement tel qu'il est saisi (sans aucune mise en forme), encadrez la zone avec ''%%<nowiki>%%'' ou, plus simplement encore, entre deux signes pourcentage ''<nowiki>%%</nowiki>''. |
| |
| <nowiki> | <nowiki> |
| Il s'agit d'un texte qui contient des adresses comme celle-ci : http://www.splitbrain.org et **mise en forme**mais rien n'est fait avec. | Voici un texte contenant des adresses de ce type : http://www.splitbrain.org et **mise en forme**, mais aucune modification n'est appliquée. |
| </nowiki> | </nowiki> |
| Il en va de même pour %%//__ce__ texte// avec un smiley ;-)%%. | Il en va de même pour %%//__ce__ texte// contenant un smiley ;-)%%. |
| |
| <nowiki> | <nowiki> |
| Il s'agit d'un texte qui contient des adresses comme celle-ci : http://www.splitbrain.org et **mise en forme**mais rien n'est fait avec. | Voici un texte qui contient des adresses comme celle-ci : http://www.splitbrain.org et **la mise en forme**, mais aucune modification n'est appliquée. |
| </nowiki> | </nowiki> |
| Il en va de même pour %%//__ce__ texte// avec un smiley ;-)%%. | Il en va de même pour %%//__ce__ texte// contenant un smiley ;-)%%. |
| |
| ===== Blocs de code ===== | ===== Blocs de code ===== |
| |
| Vous pouvez inclure des blocs de code dans vos documents en les indentant d'au moins deux espaces (comme dans les exemples précédents) ou en utilisant les balises ''%%<code>%%'' or ''%%<file>%%''. | Vous pouvez inclure des blocs de code dans vos documents soit en les indentant d’au moins deux espaces (comme dans les exemples précédents), soit en utilisant les balises ''%%<code>%%'' or ''%%<file>%%''. |
| |
| This is text is indented by two spaces. | This is text is indented by two spaces. |
| </file> | </file> |
| |
| Ces blocs ont été créés par cette source : | Ces blocs ont été créés à partir de cette source : |
| |
| Ce texte est indenté de deux espaces. | Ce texte est indenté de deux espaces. |
| ==== Mise en évidence de la syntaxe ==== | ==== Mise en évidence de la syntaxe ==== |
| |
| [[wiki:dokuwiki]] peut mettre en évidence le code source, ce qui en facilite la lecture. Il utilise le [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- donc n'importe quel langage supporté par GeSHi est supporté. 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>'' or ''<nowiki><file java></nowiki>''. | [[wiki:dokuwiki]] permet de mettre en évidence le code source, ce qui facilite sa lecture. Il utilise le [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter — ainsi, tous les langages pris en charge par GeSHi sont pris en charge. La syntaxe utilise les mêmes blocs de code et de fichiers que ceux décrits dans la section précédente, mais cette fois-ci, le nom du langage à mettre en évidence est inclus à l'intérieur de la balise, par exemple : ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''. |
| |
| <code java> | <code java> |
| </file> | </file> |
| |
| Si vous ne souhaitez pas de mise en évidence mais que vous voulez un fichier téléchargeable, indiquez un tiret (''-'') comme code de langue : ''%%<code - myfile.foo>%%''. | Si vous ne souhaitez pas de mise en évidence mais voulez un fichier téléchargeable, indiquez un tiret (''-'') comme code de langage : ''%%<code - myfile.foo>%%''. |
| |
| ===== Agrégation de flux RSS/ATOM ===== | ===== Agrégation de flux RSS/ATOM ===== |
| [[en:wiki:dokuwiki]] peut intégrer des données provenant de flux XML externes. Pour l'analyse des 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 en utilisant plusieurs paramètres supplémentaires séparés par des espaces : | [[de:wiki: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 pris en charge par SimplePie peuvent également être utilisés dans DokuWiki. Vous pouvez modifier le rendu à l’aide de plusieurs paramètres supplémentaires séparés par des espaces : |
| |
| ^ Paramètre ^ Description ^ | ^ Paramètre ^ Description ^ |
| | n'importe quel nombre | sera utilisé comme nombre maximum d'éléments à afficher, la valeur par défaut est 8 | | | any number | will be used as maximum number items to show, defaults to 8 | |
| | inverser | affiche les derniers éléments du flux en premier | | | reverse | afficher en premier les derniers éléments du flux | |
| | auteur | affiche le nom de l'auteur de l'article | | | author | afficher les noms des auteurs des éléments | |
| | date | afficher les dates de l'article | | | date | afficher les dates des éléments | |
| | description| affiche la description de l'article. Toutes les balises HTML seront supprimées | | | description| afficher la description de l'élément. Toutes les balises HTML seront supprimées | |
| | ne pas trier | ne pas trier les éléments du flux | | | nosort | ne pas trier les éléments du flux | |
| | //n//[dhm] | période de rafraîchissement, où d=jours, h=heures, m=minutes (par exemple 12h = 12 heures). | | | //n//[dhm] | période de rafraîchissement, où d=jours, h=heures, m=minutes. (par ex. 12h = 12 heures). | |
| |
| La période de rafraîchissement est fixée par défaut à 4 heures. Toute valeur inférieure à 10 minutes sera traitée comme 10 minutes. [[wiki:dokuwiki]] essaie généralement de fournir une version mise en cache d'une page, ce qui n'est évidemment pas le cas lorsque la page contient un contenu externe dynamique. Ce paramètre indique à [[wiki:dokuwiki]] de réafficher la page s'il s'agit d'un délai supérieur à //période de rafraîchissement// que la page a été rendue pour la dernière fois. | La période de rafraîchissement est fixée par défaut à 4 heures. Toute valeur inférieure à 10 minutes sera considérée comme égale à 10 minutes. [[wiki:dokuwiki]] tentera généralement de fournir une version mise en cache d’une page ; cela n’est évidemment pas approprié lorsque la page contient du contenu externe dynamique. Le paramètre indique à [[wiki:dokuwiki]] de réafficher la page si cela fait plus de //période de rafraîchissement// s'est écoulé depuis le dernier affichage de la page. |
| |
| Par défaut, le flux est trié par date, les éléments les plus récents en premier. Vous pouvez le trier par le plus ancien en utilisant le paramètre ''inverse'' ou afficher le flux tel quel avec ''nosort''. | Par défaut, le flux est trié par date, les éléments les plus récents apparaissant en premier. Vous pouvez le trier en commençant par les plus anciens à l'aide du paramètre ''paramètre « reverse », ou afficher le flux tel quel avec le'' , ou afficher le flux tel quel avec ''nosort''. |
| |
| **Exemple :** | **Exemple :** |
| ===== Macros de contrôle ===== | ===== Macros de contrôle ===== |
| |
| Certaines syntaxes influencent la façon dont DokuWiki rend une page sans créer de sortie elle-même. Les macros de contrôle suivantes sont disponibles : | Certaines syntaxes influencent la manière dont DokuWiki affiche une page sans générer de sortie en soi. Les macros de contrôle suivantes sont disponibles : |
| |
| ^ Macro ^ Description | | Macro «^ » ^ Description | |
| | %%~~NOTOC~~%% | Si cette macro est présente sur la page, aucune table des matières ne sera créée. | | | %%~~NOTOC~~%% | Si cette macro est présente sur la page, aucune table des matières ne sera créée | |
| | %%~~NOCACHE~~%% | DokuWiki met en cache tous les résultats par défaut. Parfois, cela n'est pas souhaité (par exemple, lorsque la syntaxe %%<php>%% ci-dessus), l'ajout de cette macro forcera DokuWiki à restituer une page à chaque appel. | | | %%~~NOCACHE~~%% | DokuWiki met en cache toute la sortie par défaut. Cela peut parfois ne pas être souhaité (par exemple lorsque la syntaxe %%<php>%% ci-dessus) ; l'ajout de cette macro forcera DokuWiki à réafficher une page à chaque appel | |
| |
| ===== Plugins de syntaxe ===== | ===== Plugins de syntaxe ===== |
| |
| La syntaxe de DokuWiki peut être étendue par des [[doku>plugins|Plugins]]. La manière dont les plugins installés sont utilisés est décrite dans leurs pages de description respectives. Les plugins de syntaxe suivants sont disponibles dans cette installation particulière de DokuWiki : | La syntaxe de DokuWiki peut être étendue grâce à [[doku>plugins|des plugins]]. L'utilisation des plugins installés est décrite sur leurs pages de description respectives. Les plugins de syntaxe suivants sont disponibles dans cette installation particulière de DokuWiki : |
| |
| ~~INFO:syntaxplugins~~ | ~~INFO:syntaxplugins~~ |
| |
