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 21/09/2026, 15:52] – +note markdown | +notes éviter rayé et souligné krodelabestiolewiki:syntaxe [Le 21/09/2026, 21:25] (Version actuelle) – fix lien interne krodelabestiole
Ligne 3: Ligne 3:
 ====== Syntaxe de mise en page ====== ====== Syntaxe de mise en page ======
  
-[[: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.+[[: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.
  
 <note important> <note important>
Ligne 43: Ligne 43:
 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. 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.
  
-Mieux vaut donc simplement //supprimer// le contenu obsolète ! Les anciennes version de chaque page sont de toute façon toujours sauvegardées et restent accessibles.+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.
  
 Le bouton a d'ailleurs été volontairement supprimé de l'interface d'édition. Le bouton a d'ailleurs été volontairement supprimé de l'interface d'édition.
Ligne 52: Ligne 52:
 **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. **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.
  
-Voilà du texte avec des sauts de ligne\\ remarquez que les +Voici du texte avec des sauts de ligne.\\ Remarquez que les 
-deux antislashes sont seulement reconnus en fin de ligne\\ +deux antislashes ''%%\%%'' sont seulement reconnus en fin de ligne\\ 
-ou suivis par\\ une espace ; \\Voici le résultat dans le cas contraire !.+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 +<code> 
-deux antislashes sont seulement reconnus en fin de ligne\\ +Voici du texte avec des sauts de ligne.\\ Remarquez que les 
-ou suivis par\\ une espace ; \\Voici le résultat dans le cas contraire !.</code> +deux antislashes ''%%\%%'' sont seulement reconnus en fin de ligne\\ 
- +ou suivis par\\ une espace ; \\Voici le résultat dans le cas contraire ! 
-Vous devriez forcer des sauts de ligne uniquement si c'est **réellement** nécessaire.+</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 102: Ligne 103:
   - Et voilà   - Et voilà
 </code> </code>
- 
  
 ==== Les citations ==== ==== Les citations ====
Ligne 180: 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 202: Ligne 199:
 reconnues. reconnues.
 </code> </code>
- 
  
 ==== Internes ==== ==== Internes ====
Ligne 239: 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 267: 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 278: 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 295: 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 304: 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 350: 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 387: Ligne 380:
  
 -> <- <-> => <= <=> >> << -- --- 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>
  
Ligne 436: 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 532: 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 548: 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 565: 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 582: 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 =====
  
   * [[https://www.dokuwiki.org/fr:wiki:syntax|Guide officiel de la syntaxe DokuWiki]]   * [[https://www.dokuwiki.org/fr:wiki:syntax|Guide officiel de la syntaxe DokuWiki]]
 +  * [[:wiki:Recommandations]]
  
wiki/syntaxe.1789998733.txt.gz · Dernière modification : de krodelabestiole
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