Outils pour utilisateurs

Outils du site


support:syntax_light

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
support:syntax_light [2024/02/06 12:00] – supprimée - modification externe (Date inconnue) 127.0.0.1support:syntax_light [2024/02/06 12:00] (Version actuelle) – ↷ Page déplacée de wiki:syntax_light à support:syntax_light admin
Ligne 1: Ligne 1:
 +====== Syntaxe de mise en page ======
 +
 +Voici un guide basique de la syntaxe de Dokuwiki.
 +Pour un guide plus complet, reportez vous à [[https://www.dokuwiki.org/wiki:syntax|cette page]].
 +
 +
 +===== Découpage en sections =====
 +
 +Vous pouvez utiliser jusqu'à cinq niveaux de titres différents afin de **structurer** le contenu. Si vous avez plus de trois titres, une table des matières est construite automatiquement -- ceci peut être désactivé en incluant la chaîne 
 +''%%~~NOTOC~~%%'' dans le document.
 +
 +  ====== Titre de Page ======
 +  ===== Titre niveau 2 =====
 +  ==== Titre niveau 3 ====
 +  === Titre niveau 4 ===
 +  == Titre niveau 5 ==
 +
 +Il est rare de descendre au delà du niveau 3 de titres. 
 +
 +Note : En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale :
 +<code>----</code>
 +----
 +
 +===== Mise en forme de texte basique =====
 +
 +DokuWiki accepte les textes en **gras**, //italique//, __souligné__ et ''à chasse fixe''. Bien sûr, vous pouvez tous les **__//''combiner''//__**.
 +
 +
 +  DokuWiki accepte les textes en **gras**, //italique//, __souligné__ et ''à chasse fixe''. Bien sûr, vous pouvez tous les **__//''combiner''//__**.
 +
 +Vous pouvez aussi utiliser des <sub>indices</sub> et <sup>exposants</sup>.
 +
 +  Vous pouvez aussi utiliser des <sub>indices</sub> et <sup>exposants</sup>.
 +
 +**Les paragraphes** sont créés à partir des lignes vides. Si vous souhaitez **forcer un saut de ligne** sans paragraphe, vous pouvez utiliser deux contre-obliques "\\" suivies par un espace ou une fin de ligne. 
 +
 +Vous ne devriez forcer des sauts de ligne que si c'est vraiment nécessaire. 
 +
 +===== Listes =====
 +
 +DokuWiki accepte les listes ordonnées et non ordonnées. Pour créer un élément de liste, indentez votre texte par deux espaces et utilisez une ''*'' pour une liste non ordonnée ou un ''-'' pour une liste ordonnée. 
 +
 +  * Ceci est une liste
 +  * Le second élément
 +    * Vous pouvez avoir plusieurs niveaux
 +  * Un autre élément
 +
 +  - La même liste mais ordonnée
 +  - Un autre élément
 +    - Utilisez simplement l'indentation pour des niveaux plus profonds
 +  - Et voilà
 +
 +<code>
 +  * Ceci est une liste
 +  * Le second élément
 +    * Vous pouvez avoir plusieurs niveaux
 +  * Un autre élément
 +
 +  - La même liste mais ordonnée
 +  - Un autre élément
 +    - Utilisez simplement l'indentation pour des niveaux plus profonds
 +  - Et voilà
 +</code>
 +
 +
 +===== Liens =====
 +
 +DokuWiki propose plusieurs moyens pour créer des liens. 
 +
 +==== 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 de courriel comme celle-ci : <andi@splitbrain.org> 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 
 +  de courriel comme celle-ci : <andi@splitbrain.org> sont également reconnues. 
 +
 +==== Internes ====
 +
 +Les liens internes sont créés en utilisant des crochets. Vous pouvez juste utiliser un [[playground:nom_de_page]] ou utiliser un [[playground:nom_de_page|texte de lien]].
 +
 +  Les liens internes sont créés en utilisant des crochets. Vous pouvez juste
 +  utiliser un [[nom_de_page]] ou utiliser un [[nom_de_page|texte de lien]].
 +
 +Les liens vers une section spécifique d'une page sont également possibles (voir la partie [[syntax_light#decoupage_en_sections|Découpage en sections]]). Ajoutez simplement le nom de la section après un caractère dièse comme en HTML. Ce lien renvoie vers [[syntax_light#internes|cette section]].
 +
 +  Ce lien renvoie vers [[syntax_light#internes|cette section]].
 +
 +Notes :
 +
 +  * Les liens vers des [[syntax_light|pages existantes]] sont montrés dans un style différent des liens vers des pages [[playground:inexistantes]].
 +
 +==== Liens images ====
 +
 +Vous pouvez aussi utiliser une image afin de créer un lien vers une autre page interne ou externe en combinant les syntaxes des liens et des [[#Images et autres fichiers|images]] (voir plus bas) comme ceci :
 +
 +  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
 +
 +[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
 +
 +NB : la mise en forme image est la seule syntaxe de mise en forme acceptée comme nom de lien.
 +
 +la totalité des syntaxes d'[[#Images et autres fichiers|image]] et de [[#Liens]] est possible (y compris le redimensionnement d'image, les images internes et externes, les URL et les liens interwikis).
 +
 +===== Images et autres fichiers =====
 +
 +Vous pouvez insérer des [[doku>fr:images|images, fichiers audio et vidéo]] (ou autres fichiers) internes ou externes avec des accolades. Additionnellement, vous pouvez en préciser la taille.
 + 
 +taille originale :                 {{wiki:dokuwiki-128.png}}
 +
 +largeur donnée :                   {{wiki:dokuwiki-128.png?50}}
 +
 +hauteur et largeur données((Si les proportions de l'image ne sont pas respectées, celle-ci sera découpée avant redimensionnement selon les nouvelles proportions)) : {{wiki:dokuwiki-128.png?200x50}}
 +
 +  taille originale :                {{wiki:dokuwiki-128.png}}
 +  largeur donnée :                  {{wiki:dokuwiki-128.png?50}}
 +  hauteur et largeur données :      {{wiki:dokuwiki-128.png?200x50}}
 +
 +
 +Par défaut les images se placent au fil du texte, centrées verticalement.
 +
 +Vous pouvez les aligner avec des espaces à gauche ou à droite :
 +
 +{{ wiki:dokuwiki-128.png}}
 +
 +{{wiki:dokuwiki-128.png }}
 +
 +{{ wiki:dokuwiki-128.png }}
 +
 +  {{ wiki:dokuwiki-128.png}}
 +  {{wiki:dokuwiki-128.png }}
 +  {{ wiki:dokuwiki-128.png }}
 +
 +Bien sûr, vous pouvez ajouter un titre, affiché comme une bulle d'aide par les navigateurs.
 +
 +{{ wiki:dokuwiki-128.png |Ceci est le titre}}
 +
 +  {{ wiki:dokuwiki-128.png |Ceci est le titre}}
 +
 +------ 
 +
 +Les fichiers qui ne sont pas affichables sont représentés uniquement comme un lien de téléchargement.
 +