Différences

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

--- wiki:syntaxe [Le 24/07/2017, 20:46] – [Interwiki] L'Africain
+++ wiki:syntaxe [Le 04/08/2026, 12:46] (Version actuelle) – [Les titres] explication h1 h5 krodelabestiole
@@ Ligne 10: / Ligne 10: @@
 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 =====
@@ Ligne 32: / 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 ; \\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
 deux antislashes sont seulement reconnus en fin de ligne\\
-ou suivis par\\ un espace ; \\Voici le résultat dans le cas contraire !.</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 56: / Ligne 56: @@
   === Titre niveau 4 ===
   == 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 ====
@@ Ligne 170: / Ligne 172: @@
 ==== 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.
+<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 223: / Ligne 226: @@
 DokuWiki propose les liens [[doku>interwiki|Interwiki]]. Ce sont des liens rapides vers d'autres Wikis. Par exemple :
-  * [[gufr>desktop]] accès à http://guide.ubuntu-fr.org
+  * [[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
+  * [[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/
@@ Ligne 236: / Ligne 239: @@
 DokuWiki propose les liens [[doku>wiki:interwiki|Interwiki]].
 Ce sont des liens rapides vers d'autres Wikis. Par exemple :
-  * [[gufr>desktop]] accès à http://guide.ubuntu-fr.org
+  * [[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
+  * [[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/
@@ Ligne 290: / Ligne 293: @@
 {{wiki:dokuwiki-128.png}}
 Redimension à une largeur donnée :
 {{wiki:dokuwiki-128.png?50}}
@@ Ligne 296: / Ligne 299: @@
 {{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 363: / Ligne 366: @@
 ==== 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)
@@ Ligne 373: / Ligne 376: @@
 </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 ====
@@ Ligne 394: / Ligne 399: @@
 ==== 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>''.
+Exemples :
+  * Exemple 1 : le tag ''nowiki'' fait que <nowiki>**ce texte n'est pas rendu en gras**</nowiki>, malgré les astérisques.
-<nowiki>
+  * Exemple 2 : le tag ''nowiki'' fait que l'URL <nowiki>http://www.google.fr</nowiki> n'est pas rendue comme un lien.
-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>
-<nowiki>
+  * Exemple 3 :
-http://www.google.fr
+    * 3a : KO : ''--force'' : du code //inline// avec un double trait d'union qui perd son double trait d'union au rendu ;
-</nowiki>
+    * 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>%%'' (refermé par la balise ''%%</code>%%'').
@@ Ligne 517: / Ligne 523: @@
 <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>%%**
@@ Ligne 541: / Ligne 568: @@
 ===== Voir aussi =====
-  * **(fr)** [[http://www.dokuwiki.org/fr:syntax|Guide de la syntaxe sur www.dokuwiki.org]]
+  * **(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]]

Différences

Outils de la page

Outils du site

Divers