====== 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 : ---- ---- ===== 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 indices et exposants. Vous pouvez aussi utiliser des indices et exposants. **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à * 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à ===== 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 : 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 : 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.