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:syntaxe [Le 11/09/2022, 13:16] – Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892) moths-artwiki:syntaxe [Le 21/09/2026, 21:25] (Version actuelle) – fix lien interne krodelabestiole
Ligne 1: Ligne 1:
 {{tag>wiki}} {{tag>wiki}}
  
-----+====== Syntaxe de mise en page ======
  
 +[[:DokuWiki]] utilise un langage de balises simple, qui essaie de rendre les fichiers de données aussi lisibles que possible. Cette page contient la description des éléments de syntaxe possibles que vous pourrez utiliser en modifiant les pages. Regardez simplement le source de cette page en cliquant sur le bouton « Éditer cette page » dans le menu de gauche. Si vous souhaitez essayer quelque chose, rendez-vous dans le [[:playground:playground|bac à sable]]. Les balises les plus simples sont facilement accessibles depuis la barre d'outils d'édition.
  
-====== Syntaxe de mise en page ======+<note important> 
 +FIXME
  
-[[:wiki:DokuWiki]] utilise un **langage de balises simple**, qui essaie de rendre les fichiers de données aussi lisibles que possible. Cette page contient la description des éléments de syntaxe possibles que vous pourrez utiliser en modifiant les pages. Regardez simplement le source de cette page en cliquant sur le bouton « Éditer cette page » dans le menu de gauche. Si vous souhaitez essayer quelque chose, rendez-vous dans le [[:playground:playground|bac à sable]]. Les balises les plus simples sont facilement accessibles depuis la barre d'outils d'édition.+Le format [[wpfr>markdown]] arrive sur DokuWiki, et celui-ci est beaucoup plus simple et lisible ! 
 +</note>
  
 Afin de faciliter la création et la modification des pages de la documentation nous recommandons l'utilisation de nos [[:wiki:modele|modèles]], et des [[:wiki:mini-tutoriels]] (boutons d'insertion dans la barre d'outils). De plus pour lier plus facilement les pages entre elles nous utilisons un système de [[:wiki:tags]] à mettre en début de toutes nos pages. Afin de faciliter la création et la modification des pages de la documentation nous recommandons l'utilisation de nos [[:wiki:modele|modèles]], et des [[:wiki:mini-tutoriels]] (boutons d'insertion dans la barre d'outils). De plus pour lier plus facilement les pages entre elles nous utilisons un système de [[:wiki:tags]] à mettre en début de toutes nos pages.
  
-===== Bouton de la fenêtre d'écriture du texte===== +===== Boutons en haut de la zone d'écriture du texte ===== 
-les chapitres suivants montrent les details de la syntaxe , mais on n'est pas obligé de tout écrire : y  a des bouton en haut de la fenêtre qui facillitent l’écriture+ 
 +Les chapitres suivants montrent les détails de la syntaxe, mais on n'est pas obligé de tout écrire : il y a des boutons en haut de la zone (champ ?) d'écriture du texte qui facilitent l’écriture. 
 ===== Mise en forme de texte simple ===== ===== Mise en forme de texte simple =====
  
 DokuWiki permet des textes en //italique//, **gras**, __souligné__ et ''à espace fixe'' (pour du code en ligne). DokuWiki permet des textes en //italique//, **gras**, __souligné__ et ''à espace fixe'' (pour du code en ligne).
 Bien sûr, vous pouvez aussi les **__//''combiner''//__**. Bien sûr, vous pouvez aussi les **__//''combiner''//__**.
 +
 +<note warning>
 +Cependant sur le [[:web]], du texte souligné correspond à des //liens//. En pratique on ne devrait donc à-peu-près jamais utiliser ce formatage ! Le bouton a d'ailleurs été volontairement supprimé de l'interface d'édition.
 +
 +Pour plus d'information, voir les [[:wiki:recommandations]]. 
 +</note>
  
 <code> <code>
Ligne 22: Ligne 33:
 Bien sûr, vous pouvez aussi les **__//''combiner''//__** Bien sûr, vous pouvez aussi les **__//''combiner''//__**
 </code> </code>
- 
  
 Vous pouvez aussi utiliser <sub>indice</sub> et <sup>exposant</sup>. Vous pouvez aussi utiliser <sub>indice</sub> et <sup>exposant</sup>.
 <code>Vous pouvez aussi utiliser <sub>indice</sub> et <sup>exposant</sup>.</code> <code>Vous pouvez aussi utiliser <sub>indice</sub> et <sup>exposant</sup>.</code>
- 
  
 De plus, vous pouvez marquer du contenu comme <del>supprimé</del>. De plus, vous pouvez marquer du contenu comme <del>supprimé</del>.
 <code>De plus, vous pouvez marquer du contenu comme <del>supprimé</del>.</code> <code>De plus, vous pouvez marquer du contenu comme <del>supprimé</del>.</code>
  
 +<note warning>
 +Le wiki n'étant pas une copie d'école, il est très rare que du texte rayé soit désirable et pertinent, en tout cas pas sur le long terme. Or aucun autre contributeur ou administrateur ne devrait être censé passer derrière ce que chacun écrit.
  
-**Les paragraphes** sont créés depuis les lignes vides. Si vous souhaitez **forcer un saut de ligne** sans paragraphe, vous pouvez utiliser deux antislashes suivis par une espace ou une fin de ligne.+Mieux vaut donc simplement //supprimer// le contenu obsolète ! Les anciennes versions de chaque page sont de toute façon toujours sauvegardées et restent accessibles.
  
-Voilà du texte avec des sauts de ligne\\ remarquez que les +Le bouton a d'ailleurs été volontairement supprimé de l'interface d'édition.
-deux antislashes sont seulement reconnus en fin de ligne\\ +
-ou suivis par\\ une espace ; \\Voici le résultat dans le cas contraire !.+
  
-<code>Voilà du texte avec des sauts de ligne\\ remarquez que les +Pour plus d'information, voir les [[:wiki:recommandations]].  
-deux antislashes sont seulement reconnus en fin de ligne\\ +</note>
-ou suivis par\\ une espace ; \\Voici le résultat dans le cas contraire !.</code>+
  
-Vous devriez forcer des sauts de ligne uniquement si c'est **réellement** nécessaire.+**Les paragraphes** sont créés depuis les lignes vides. Si vous souhaitez **forcer un saut de ligne** sans paragraphe, vous pouvez utiliser deux antislashes suivis par une espace ou une fin de ligne.
  
 +Voici du texte avec des sauts de ligne.\\ Remarquez que les
 +deux antislashes ''%%\%%'' sont seulement reconnus en fin de ligne\\
 +ou suivis par\\ une espace ; \\Voici le résultat dans le cas contraire !
 +
 +<code>
 +Voici du texte avec des sauts de ligne.\\ Remarquez que les
 +deux antislashes ''%%\%%'' sont seulement reconnus en fin de ligne\\
 +ou suivis par\\ une espace ; \\Voici le résultat dans le cas contraire !
 +</code>
 +
 +Ne forcer des sauts de ligne que quand strictement nécessaire : pour un nouveau paragraphe, il suffit de sauter une ligne.
  
 ===== Éléments de mise en page ===== ===== Éléments de mise en page =====
Ligne 56: Ligne 75:
   === Titre niveau 4 ===   === Titre niveau 4 ===
   == Titre niveau 5 ==   == Titre niveau 5 ==
 +
 +Ces niveaux correspondent aux balises ''<h1>'' à ''<h5>'' du langage [[wpfr>Hypertext_Markup_Language|HTML]] (voir [[https://developer.mozilla.org/fr/docs/Web/HTML/Reference/Elements/Heading_Elements|Heading Elements]]).
  
 ==== Les listes ==== ==== Les listes ====
Ligne 82: Ligne 103:
   - Et voilà   - Et voilà
 </code> </code>
- 
  
 ==== Les citations ==== ==== Les citations ====
Ligne 160: Ligne 180:
   |gauche        |       droite|    centré     |   |gauche        |       droite|    centré     |
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
- 
- 
  
 ===== Les Liens ===== ===== Les Liens =====
  
 DokuWiki propose plusieurs moyens de créer des liens. DokuWiki propose plusieurs moyens de créer des liens.
- 
  
 ==== Externes ==== ==== Externes ====
Ligne 182: Ligne 199:
 reconnues. reconnues.
 </code> </code>
- 
  
 ==== Internes ==== ==== Internes ====
Ligne 219: Ligne 235:
   * Lorsque le titre d'une section est modifié, alors le //bookmark// change aussi. Donc ne comptez pas trop sur les  liens de section.   * Lorsque le titre d'une section est modifié, alors le //bookmark// change aussi. Donc ne comptez pas trop sur les  liens de section.
 </note> </note>
- 
  
 ==== Interwiki ==== ==== Interwiki ====
Ligne 247: Ligne 262:
   * [[apps>cat]]  accès à https://apps.ubuntu.com   * [[apps>cat]]  accès à https://apps.ubuntu.com
 </code> </code>
- 
- 
  
 ==== Liens images ==== ==== Liens images ====
Ligne 258: Ligne 271:
 <code>[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]</code> <code>[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]</code>
  
-NB : la mise en forme image est la seule syntaxe de mise en forme acceptée comme nom du lien. +<note>La mise en forme image est la seule syntaxe de mise en forme acceptée comme nom du lien.</note>
- +
  
 ==== Redirection ==== ==== Redirection ====
Ligne 275: Ligne 286:
  
 <note importante>**N.B. :** Les redirections en cascade ont été désactivées, car elles sont dangereuses (risque de boucle).</note> <note importante>**N.B. :** Les redirections en cascade ont été désactivées, car elles sont dangereuses (risque de boucle).</note>
- 
- 
- 
- 
  
 ===== Les insertions d'éléments de syntaxe ===== ===== Les insertions d'éléments de syntaxe =====
Ligne 284: Ligne 291:
 ==== Les images ==== ==== Les images ====
  
-<note help>Pour les images, des informations supplémentaires sont disponibles sur la [[:wiki:ajout_image|page d'ajout des images]].</note>+<note tip>Pour les images, des informations supplémentaires sont disponibles sur la [[:wiki:ajout_image|page d'ajout des images]].</note>
  
 Vous pouvez inclure des [[doku>images]] externes et internes entre des accolades doubles. Vous pouvez spécifier leur taille en pixel après un ? (facultatif). Vous pouvez inclure des [[doku>images]] externes et internes entre des accolades doubles. Vous pouvez spécifier leur taille en pixel après un ? (facultatif).
Ligne 330: Ligne 337:
 Si vous spécifiez un nom de fichier (externe ou interne) qui n'est pas une image (''gif,jpeg,png''), alors il sera affiché comme un lien et non comme une image. Si vous spécifiez un nom de fichier (externe ou interne) qui n'est pas une image (''gif,jpeg,png''), alors il sera affiché comme un lien et non comme une image.
  
 +=== Mode clair / sombre ===
 +
 +Une modification propre à ubuntu-fr a été implémentée : on peut utiliser les descriptions ''%%|Icône light}}%%'' et ''%%|Icône dark}}%%'' pour afficher une image respectivement en mode clair uniquement ou en mode sombre uniquement.
 +
 +Voir le logo GNOME en exemple : [[:GNOME]].
  
 ==== Un trait de séparation ==== ==== Un trait de séparation ====
-En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale (Il faut sauter une ligne avant et après pour que cela fonctionne) :+ 
 +En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale (il faut sauter une ligne avant pour que cela fonctionne) :
  
 ---- ----
Ligne 364: Ligne 377:
 ==== Typographie ==== ==== Typographie ====
  
-[[DokuWiki]] peut convertir de simples caractères de texte brut en leurs entités typographiques correctes. Voici un exemple des caractères reconnus.+[[:DokuWiki]] peut convertir de simples caractères de texte brut en leurs entités typographiques correctes. Voici un exemple des caractères reconnus.
  
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
-"He thought 'It's a man's world'..." 
  
 <code> <code>
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
-"He thought 'It's a man's world'..." 
 </code> </code>
  
-NB : Ces conversions peuvent être interdites dans le fichier de configuration. +<note> 
 +Certains remplacements de caractères sont spécifiques au wiki ubuntu-fr : 
 +  * ''%%\_%%'' est remplacé par une [[wpfr>espace insécable]] (qui empêche le retour à la ligne entre deux mots). 
 +</note>
  
 ==== Notes de pied de page ==== ==== Notes de pied de page ====
Ligne 414: Ligne 427:
 </code> </code>
  
- +[[:DokuWiki]] peut surligner du code source, ce qui facilite sa lecture. Il utilise le Generic Syntax Highlighter
-[[DokuWiki]] peut surligner du code source, ce qui facilite sa lecture. Il utilise le Generic Syntax Highlighter+
 [[http://qbnz.com/highlighter/|GeSHi]] -- donc n'importe quel langage reconnu par GeSHi est supporté. La syntaxe est la même que dans le bloc de code dans la section précédent, mais cette fois le nom du langage utilisé est insérée dans le tag. Ex : ''%%<code java>%%''. [[http://qbnz.com/highlighter/|GeSHi]] -- donc n'importe quel langage reconnu par GeSHi est supporté. La syntaxe est la même que dans le bloc de code dans la section précédent, mais cette fois le nom du langage utilisé est insérée dans le tag. Ex : ''%%<code java>%%''.
  
Ligne 439: Ligne 451:
 Ceci est pratiquement la même chose, mais vous pouvez l'utiliser pour montrer que vous avez cité un fichier. Ceci est pratiquement la même chose, mais vous pouvez l'utiliser pour montrer que vous avez cité un fichier.
 </file> </file>
-ou mieux encore ** //file - chemin/fichier// **+ou mieux encore **//file - chemin/fichier//**
 <file - /etc/fichier> <file - /etc/fichier>
 Comme cela il n'y a pas d’ambiguïté sur le fichier à modifier, à éviter si ça se répète trop, on peut le mettre alors que sur le premier extrait! Comme cela il n'y a pas d’ambiguïté sur le fichier à modifier, à éviter si ça se répète trop, on peut le mettre alors que sur le premier extrait!
Ligne 510: Ligne 522:
 </code> </code>
  
 +==== Les boîtes ====
  
 +Pour aller plus loin que les notes encadrées, nous avons également un type boite très paramétrable, ce qui lui permet de pouvoir faire de belles choses, mais également des choses beaucoup moins agréables. Son utilisation sera contrôlée. N'en abusez pas.
  
 +<note important>La prise en compte des styles a été restreinte sur ubuntu-fr pour garantir l'homogénéité graphique du site.</note>
  
-==== Les boîtes ==== +<box>Une boîte simple</box> 
-Pour aller plus loin que les notes encadrées, nous avons également un type boite très paramétrable, ce qui lui permet de pouvoir faire de belles choses, mais également des choses beaucoup moins agréables. Son utilisation sera contrôlée. N'en abusez pas. +<code><box>Une boîte simple</box></code>
- +
-<box> Une boîte simple </box> +
-<code><box> Une boîte simple </box></code>+
  
 La syntaxe complète : La syntaxe complète :
Ligne 526: Ligne 538:
 <box 75% round orange|Une boite complète>Texte de contenu</box|Avec une légende> <box 75% round orange|Une boite complète>Texte de contenu</box|Avec une légende>
  
-si vous désirez insérer du texte non formaté — du type « page de code bash » ou pour afficher une page écran du terminal — on inclura des balises %%<file> texte non formaté </file>%% entre les balises « box » ; \\+Pour insérer du texte non formaté -- de type code -- ou pour afficher une page écran du terminal -- inclure des balises ''%%<file> texte non formaté </file>%%'' entre les balises ''box'' ; \\
 ce qui donne : ce qui donne :
 <code><box 75% round orange|Une boite complète> <code><box 75% round orange|Une boite complète>
Ligne 543: Ligne 555:
 </box|Avec une légende> </box|Avec une légende>
  
-**%%<box largeur classes couleurs | titre> Texte de contenu </box|légende>%%**+''%%<box largeur classes couleurs | titre> Texte de contenu </box|légende>%%''
  
-  * largeur -- une largeur en em, px ou %+  * largeur -- une largeur en ''em'', ''px'' ou ''%''
   * classes -- une ou plusieurs classes d'affichage parmi :   * classes -- une ou plusieurs classes d'affichage parmi :
-    * round -- coins arrondis +    * ''round'' -- coins arrondis 
-    * blue -- thème bleu +    * ''blue'' -- thème bleu 
-    * red -- thème rouge +    * ''red'' -- thème rouge 
-    * green -- thème vert +    * ''green'' -- thème vert 
-    * orange -- thème orange +    * ''orange'' -- thème orange 
-    * left -- alignement à gauche +    * ''left'' -- alignement à gauche 
-    * right -- alignement à droite +    * ''right'' -- alignement à droite 
-  * couleurs — 1 à 4 couleurs en hex CSS ou en RGB (exemples #F00 #fcab94 rgb(255,255,0)). Si moins de 4 couleurs sont indiquées, la première est utilisée partout. Les couleurs agissent dans l'ordre sur les éléments suivants.+  * couleurs -- 1 à 4 couleurs CSS en hexadécimal ou en RGB (exemples ''#F00'', ''#fcab94'', ou ''rgb(255,255,0)''). Si moins de 4 couleurs sont indiquées, la première est utilisée partout. Les couleurs agissent dans l'ordre sur les éléments suivants.
     * fond du contenu     * fond du contenu
     * fond du titre     * fond du titre
Ligne 560: Ligne 572:
     * bordures     * bordures
   * titre -- texte affiché au dessus du contenu de la boîte.   * titre -- texte affiché au dessus du contenu de la boîte.
-  * légende — texte affiché en dessous du contenu de la boîte.+  * légende -- texte affiché en dessous du contenu de la boîte.
  
 ===== Voir aussi ===== ===== Voir aussi =====
  
-  * **(fr)** [[http://www.dokuwiki.org/fr:wiki:syntax|Guide de la syntaxe sur www.dokuwiki.org]] +  * [[https://www.dokuwiki.org/fr:wiki:syntax|Guide officiel de la syntaxe DokuWiki]] 
-  * **(en)** [[http://www.dokuwiki.org/syntax|Guide de la syntaxe sur www.dokuwiki.org]]+  * [[:wiki:Recommandations]]
  
wiki/syntaxe.1662894971.txt.gz · Dernière modification : de moths-art
CC Attribution-Noncommercial-Share Alike 4.0 International Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : CC Attribution-Noncommercial-Share Alike 4.0 International