Différences

Ci-dessous, les différences entre deux révisions de la page.

--- wiki:syntaxe [Le 08/06/2010, 23:13]
YoBoY
+++ wiki:syntaxe [Le 11/09/2022, 13:16] (Version actuelle)
moths-art 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)
@@ Ligne 2: / Ligne 2: @@
 ----
 ====== Syntaxe de mise en page ======
@@ Ligne 7: / Ligne 8: @@
 [[: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.
-Afin de faciliter la création et la modification des pages de la documentation nous recommandons l'utilisation de nos [[:wiki: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=====
+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
 ===== Mise en forme de texte simple =====
-DokuWiki supporte les 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''//__**.
 <code>
-DokuWiki supporte les textes en //italique//, **gras**, __souligné__ et
+DokuWiki permet des textes en //italique//, **gras**, __souligné__ et
 ''à espace fixe'' (pour du code en ligne).
 Bien sûr, vous pouvez aussi les **__//''combiner''//__**
@@ Ligne 29: / Ligne 32: @@
-**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 un 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
 deux antislashes sont seulement reconnus en fin de ligne\\
-ou suivis par\\ un espace ; \\cela arrive sinon.
+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
 deux antislashes sont seulement reconnus en fin de ligne\\
-ou suivis par\\ un espace ; \\cela arrive sinon.</code>
+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.
@@ Ligne 106: / Ligne 109: @@
 | Ligne 1 Col 1   | Ligne 1 Col 2     | Ligne 1 Col 3                       |
 | Ligne 2 Col 1   | colonnes fusionnées (notez la double barre verticale)  ||
-| Ligne 3 Col 1   | Ligne 2 Col 2     | Ligne 2 Col 3                       |
+| Ligne 3 Col 1   | Ligne 2 Col 2\\ passage à la ligne     | Ligne 2 Col 3                       |
 Les lignes de tableau doivent commencer et terminer avec un //pipe// ''|'' pour des lignes normales ou avec un ''^'' pour les titres.
+Les deux barres obliques '\\' permettent de passer à la ligne à l'intérieur d'une cellule (marche aussi en dehors des tableaux).
   ^ Titre 1         ^ Titre 2           ^ Titre 3                             ^
   | Ligne 1 Col 1   | Ligne 1 Col 2     | Ligne 1 Col 3                       |
   | Ligne 2 Col 1   | colonnes fusionnées (notez la double barre verticale)  ||
-  | Ligne 3 Col 1   | Ligne 2 Col 2     | Ligne 2 Col 3                       |
+  | Ligne 3 Col 1   | Ligne 2 Col 2\\ passage à la ligne     | Ligne 2 Col 3                       |
 Pour fusionner des cellules horizontalement (//colspan//), rendez simplement la cellule suivante complètement vide comme montré ci-dessus. Assurez-vous d'avoir toujours le même nombre de séparateurs de cellules !
@@ Ligne 165: / Ligne 170: @@
 ==== Externes ====
-Les liens externes sont reconnus automatiquement : http://www.google.fr ou simplement www.google.fr - Vous pouvez aussi donner des noms aux liens : [[http://www.google.fr|Ce lien pointe vers google]]. Les adresses email telles que celle-ci : <toto@foo.bar> sont également reconnues.
+Les liens externes sont reconnus automatiquement : http://www.google.fr ou simplement www.google.fr
+Vous pouvez aussi donner des noms aux liens : [[http://www.google.fr|Ce lien pointe vers google]]. Les adresses email telles que celle-ci : <toto@foo.bar> sont également reconnues.
+<note>Si vous ne donnez pas de noms aux liens et que ceux-ci contiennent des caractères inhabituelles, tel que des paranthèses, ils pourraient être mal reconnus.</note>
 <code>
@@ Ligne 182: / Ligne 190: @@
 <code>
 Les liens internes sont créés en utilisant les crochets. Vous pouvez
-soit juste donner un [[Nom de page]] ou utiliser un
+soit juste donner un [[:Nom de page]] ou utiliser un
-[[nom de page|titre]]. Les pages (//Nom de page//) wiki sont converties
+[[:nom de page|titre]]. Les pages (//Nom de page//) wiki sont converties
 automatiquement en minuscules, les caractères spéciaux ne sont pas
 autorisés ce qui donne //nom_de_page//.
@@ Ligne 208: / Ligne 216: @@
 <note>
   * Les liens vers des [[:wiki:syntaxe|pages existantes]] sont montrés dans un style différent des pages [[:wiki:inexistantes]].
-  * Nous n'utilisont pas la [[wp>CamelCase]] pour utiliser des liens par défaut.
+  * Nous n'utilisons pas le [[wp>CamelCase]] pour utiliser des liens par défaut.
   * Lorsque le titre d'une section est modifié, alors le //bookmark// change aussi. Donc ne comptez pas trop sur les  liens de section.
 </note>
@@ Ligne 215: / Ligne 223: @@
 ==== Interwiki ====
-DokuWiki propose les liens [[doku>interwiki|Interwiki]]. Ce sont des liens rapides vers d'autres Wikis. Par exemple:
+DokuWiki propose les liens [[doku>interwiki|Interwiki]]. Ce sont des liens rapides vers d'autres Wikis. Par exemple :
+  * [[gufr>index]] accès à http://guide.ubuntu-fr.org
   * [[wp>wiki|définition des Wikis dans Wikipedia]] (version anglaise)
   * [[wpfr>wiki|définition des Wikis dans Wikipedia]] (version française)
   * [[google>Wiki]] liens vers une recherche Google.
   * [[pu>dokuwiki]] liens vers une recherche sur http://packages.ubuntu.com/
+  * [[man>commande]] page de manuel en anglais de la commande sur http://man.cx
+  * [[du>accueil]]  accès à  https://help.ubuntu.com/community/
+  * [[wu>accueil]] accès à  https://wiki.ubuntu.com/
+  * [[apps>cat]]  accès à https://apps.ubuntu.com
 <code>
 DokuWiki propose les liens [[doku>wiki:interwiki|Interwiki]].
-Ce sont des liens rapides vers d'autres Wikis. Par exemple:
+Ce sont des liens rapides vers d'autres Wikis. Par exemple :
+  * [[gufr>index]] accès à http://guide.ubuntu-fr.org
   * [[wp>wiki|définition des Wikis dans Wikipedia]] (version anglaise)
   * [[wpfr>wiki|définition des Wikis dans Wikipedia]] (version française)
   * [[google>Wiki]] liens vers une recherche Google.
   * [[pu>dokuwiki]] liens vers une recherche sur http://packages.ubuntu.com/
+  * [[man>commande]] page de manuel en anglais de la commande sur http://man.cx
+  * [[du>accueil]]  accès à  https://help.ubuntu.com/community/
+  * [[wu>accueil]] accès à  https://wiki.ubuntu.com/
+  * [[apps>cat]]  accès à https://apps.ubuntu.com
 </code>
@@ Ligne 272: / Ligne 291: @@
 {{wiki:dokuwiki-128.png}}
 Redimension à une largeur donnée :
 {{wiki:dokuwiki-128.png?50}}
@@ Ligne 278: / Ligne 297: @@
 {{wiki:dokuwiki-128.png?200x50}}
 Image externe redimensionnée :
-{{http://de3.php.net/images/php.gif?200x50}}
+{{http://php.net/images/php.gif?200x50}}
   Taille réelle :
   {{wiki:dokuwiki-128.png}}
   Redimension à une largeur donnée :
   {{wiki:dokuwiki-128.png?50}}
   Redimension à une largeur et une hauteur données :
   {{wiki:dokuwiki-128.png?200x50}}
   Image externe redimensionnée :
-  {{http://de3.php.net/images/php.gif?200x50}}
+  {{http://php.net/images/php.gif?200x50}}
@@ Ligne 313: / Ligne 332: @@
 ==== Un trait de séparation ====
-En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale :
+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) :
 ----
@@ Ligne 376: / Ligne 395: @@
 ==== Texte non analysé ====
-Pour laisser l'analyseur ignorer complètement un bloc (//ie.// ne pas faire de mise en forme dedans), encadrez ce bloc soit avec des tags ''nowiki'' ou encore plus simple, avec des doubles caractères pourcent ''<nowiki>%%</nowiki>''.
+Pour laisser l'analyseur ignorer complètement un bloc (//ie.// ne pas faire de mise en forme dedans), encadrez ce bloc soit avec des tags ''%%<%%nowiki>..</nowiki>'' ou encore plus simple, avec des doubles caractères pourcent ''<nowiki>%%</nowiki>..<nowiki>%%</nowiki>''.
-<nowiki>
+Exemples :
-Voici du texte qui contient des adresses comme ceci :
-http://www.spiltbrain.org et de la **mise en forme**, mais rien ne se passe.
-</nowiki>
+  * Exemple 1 : le tag ''nowiki'' fait que <nowiki>**ce texte n'est pas rendu en gras**</nowiki>, malgré les astérisques.
+  * Exemple 2 : le tag ''nowiki'' fait que l'URL <nowiki>http://www.google.fr</nowiki> n'est pas rendue comme un lien.
+  * Exemple 3 :
+    * 3a : KO : ''--force'' : du code //inline// avec un double trait d'union qui perd son double trait d'union au rendu ;
+    * 3b : OK : ''%%--%%force'' : du code //inline// avec un double trait d'union qui ne perd pas son double trait d'union au rendu, grâce à l'opérateur ''<nowiki>%%</nowiki>'' ;
 ==== Blocs de code ====
-Pour représenter du code source ou des commandes à taper dans un [[:terminal]] on utilise la balise ''code''.
+Pour représenter du code source ou des commandes à taper dans un [[:terminal]] on utilise la balise ''%%<code>%%'' (refermé par la balise ''%%</code>%%'').
 <code>
@@ Ligne 413: / Ligne 434: @@
 ==== Blocs fichiers ====
-Pour représenter le contenu de fichier on utilise la balise ''file''.
+Pour représenter le contenu de fichier on utilise la balise ''file''
 <file>
 Ceci est pratiquement la même chose, mais vous pouvez l'utiliser pour montrer que vous avez cité un fichier.
+</file>
+ou mieux encore ** //file - chemin/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!
 </file>
-On peut également permettre de télécharger le fichier ainsi inséré, de cette façon :
+Cela permet de télécharger le fichier ainsi inséré, et si disponible, ajouter la coloration syntaxique, de cette façon :
 <code>
 <file php myexample.php>
@@ Ligne 430: / Ligne 455: @@
 </file>
-Note : pour ne pas coloré le code, remplacer le nom du langage par un **-**.
+Note : pour ne pas colorer le code, remplacer le nom du langage par un **-**.
@@ Ligne 489: / Ligne 514: @@
 ==== 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.
+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.
 <box> Une boîte simple </box>
 <code><box> Une boîte simple </box></code>
-La syntaxe complète qui peut donner quelque chose comme ça :
+La syntaxe complète :
+<code><box 75% round orange|Une boite complète>Texte de contenu</box|Avec une légende></code>
+qui peut donner quelque chose comme ça :
 <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 » ; \\
+ce qui donne :
+<code><box 75% round orange|Une boite complète>
+<File>
+Texte de contenu
+</file>
+</box|Avec une légende>
+</code>
+Une page écran du terminal apparaîtra alors dans votre page de documentation, selon le modèle suivant:
+<box 75% round orange|Une boite complète>
+<file>
+message du terminal ou code source
+</file>
+</box|Avec une légende>
 **%%<box largeur classes couleurs | titre> Texte de contenu </box|légende>%%**
   * largeur -- une largeur en em, px ou %
-  * classes -- une ou plusieurs classes d'affichage parmis :
+  * classes -- une ou plusieurs classes d'affichage parmi :
     * round -- coins arrondis
     * blue -- thème bleu
@@ Ligne 508: / Ligne 554: @@
     * left -- alignement à gauche
     * 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'odre sur les éléments suivants.
+  * 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.
     * fond du contenu
     * fond du titre
-    * fond du pourtour de la boite
+    * fond du pourtour de la boîte
     * bordures
   * titre -- texte affiché au dessus du contenu de la boîte.
   * légende — texte affiché en dessous du contenu de la boîte.
+===== Voir aussi =====
+  * **(fr)** [[http://www.dokuwiki.org/fr:wiki:syntax|Guide de la syntaxe sur www.dokuwiki.org]]
+  * **(en)** [[http://www.dokuwiki.org/syntax|Guide de la syntaxe sur www.dokuwiki.org]]