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:56] – [Mise en forme de texte simple] typos 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 53: Ligne 53:
  
 Voici 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> <code>
 Voici 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> </code>
Ligne 103: Ligne 103:
   - Et voilà   - Et voilà
 </code> </code>
- 
  
 ==== Les citations ==== ==== Les citations ====
Ligne 181: 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 203: Ligne 199:
 reconnues. reconnues.
 </code> </code>
- 
  
 ==== Internes ==== ==== Internes ====
Ligne 240: 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 268: 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 279: 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 296: 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 305: 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 351: 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 388: 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 437: 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 533: 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 549: 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 566: 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 583: 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.1789998994.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