====== Syntaxe de formatage ====== [[doku>DokuWiki]] prend en charge un langage de balisage simple, qui vise à rendre les fichiers de données aussi lisibles que possible. Cette page contient toutes les syntaxes possibles que vous pouvez utiliser lors de la modification des pages. Il suffit de consulter le code source de cette page en cliquant sur « Modifier cette page ». Si vous souhaitez essayer quelque chose, utilisez simplement la page [[playground:playground|playground]]. Le balisage le plus simple est également facilement accessible via les [[doku>toolbar|boutons rapides]]. ===== Formatage de texte de base ===== DokuWiki prend en charge les textes **en gras**, //en italique//, __soulignés__ et “'à espacement fixe”'. Vous pouvez bien sûr **__//“'combiner”'//__** tous ces formats. DokuWiki prend en charge les textes **en gras**, //en italique//, __soulignés__ et “'à espacement fixe”'. Vous pouvez bien sûr **__//“'combiner”'//__** tous ces styles. Vous pouvez également utiliser les balises indice et exposant. Vous pouvez également utiliser indice et exposant. Vous pouvez également marquer quelque chose comme supprimé. Vous pouvez également marquer quelque chose comme supprimé. Les **paragraphes** sont créés à partir de lignes vides. Si vous souhaitez **forcer un saut de ligne** sans paragraphe, vous pouvez utiliser deux barres obliques inversées suivies d'un espace ou de la fin de la ligne. Voici un texte avec quelques sauts de ligne\\ Notez que les deux barres obliques inversées ne sont reconnues qu'à la fin d'une ligne\\ ou suivies d'un espace \\cela se produit sans cela. Vous ne devriez utiliser les sauts de ligne forcés qu'en cas de nécessité absolue. ===== Liens ===== DokuWiki prend en charge plusieurs méthodes de création de liens. ==== Externes ==== Les liens externes sont reconnus automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez également définir le texte du lien : [[http://www.google.com|Ce lien pointe vers Google]]. Les adresses e-mail telles que celle-ci : sont également reconnues. DokuWiki prend en charge plusieurs méthodes pour créer des liens. Les liens externes sont reconnus automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez également définir le texte du lien : [[http://www.google.com|Ce lien pointe vers Google]]. Les adresses e-mail telles que celle-ci : sont également reconnues. ==== Interne ==== Les liens internes sont créés à l'aide de crochets. Vous pouvez soit indiquer simplement un [[nom de page]], soit utiliser un [[nom de page|texte du lien]] supplémentaire. Les liens internes sont créés à l'aide de crochets. Vous pouvez soit indiquer simplement un [[nom de page]], soit utiliser un [[nom de page|texte du lien]] supplémentaire. Les [[doku>noms de page|noms de page Wiki]] sont automatiquement convertis en minuscules, les caractères spéciaux ne sont pas autorisés. Vous pouvez utiliser [[some:namespaces]] en utilisant un deux-points dans le nom de la page. Vous pouvez utiliser [[some:namespaces]] en utilisant deux points dans le nom de la page. Pour plus de détails sur les espaces de noms, voir [[doku>namespaces]]. Il est également possible de créer un lien vers une section spécifique. Il suffit d'ajouter le nom de la section après le caractère dièse, comme dans le langage HTML. Ce lien renvoie à [[syntax#internal|cette section]]. Remarques : * Les liens vers des [[syntaxe|pages existantes]] sont affichés dans un style différent de ceux vers des pages [[inexistantes]]. * DokuWiki n'utilise pas [[wp>CamelCase]] pour créer automatiquement des liens par défaut, mais cette fonctionnalité peut être activée dans le fichier [[doku>config]]. Astuce : si DokuWiki est un lien, cela signifie que cette fonctionnalité est activée. * Lorsque l'en-tête d'une section est modifié, son signet change également. Ne vous fiez donc pas trop aux liens de section. ==== Interwiki ==== DokuWiki prend en charge les liens [[doku>Interwiki]]. Il s'agit de liens rapides vers d'autres wikis. Par exemple, voici un lien vers la page Wikipédia sur les wikis : [[wp>Wiki]]. DokuWiki prend en charge les liens [[doku>Interwiki]]. Il s'agit de liens rapides vers d'autres wikis. Par exemple, voici un lien vers la page Wikipédia consacrée aux wikis : [[wp>Wiki]]. ==== Partages Windows ==== Les partages Windows tels que [[\\server\share|ceci]] sont également reconnus. Veuillez noter que ceux-ci n'ont de sens que dans un groupe d'utilisateurs homogène comme un [[wp>Intranet]] d'entreprise. Les partages Windows comme [[\\server\share|celui-ci]] sont également reconnus. Remarques : * Pour des raisons de sécurité, la navigation directe vers les partages Windows ne fonctionne par défaut que dans Microsoft Internet Explorer (et uniquement dans la « zone locale »). * Pour Mozilla et Firefox, elle peut être activée grâce à différentes solutions de contournement mentionnées dans la [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|base de connaissances Mozilla]]. Cependant, un avertissement JavaScript s'affichera toujours lorsque vous tenterez d'ouvrir un partage Windows. Pour supprimer cet avertissement (pour tous les utilisateurs), ajoutez la ligne suivante dans « conf/lang/en/lang.php » (plus de détails dans [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]) : ==== Liens vers des images ==== Vous pouvez également utiliser une image pour créer un lien vers une autre page interne ou externe en combinant la syntaxe des liens et [[#images_and_other_files|images]] (voir ci-dessous) comme ceci : [[http://php.net|{{wiki:dokuwiki-128.png}}]] [[http://php.net|{{wiki:dokuwiki-128.png}}]] Remarque : le formatage des images est la seule syntaxe de formatage acceptée dans les noms de liens. L'ensemble de la syntaxe [[#images_and_other_files|image]] et [[#links|lien]] est pris en charge (y compris le redimensionnement des images, les images internes et externes, les URL et les liens interwiki). ===== Notes de bas de page ===== Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en utilisant des doubles parenthèses. Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) en utilisant des doubles parenthèses. ===== Sectionnement ===== Vous pouvez utiliser jusqu'à cinq niveaux de titres différents pour structurer votre contenu. Si vous avez plus de trois titres, une table des matières est générée automatiquement. Vous pouvez désactiver cette fonction en incluant la chaîne « ~~NOTOC~~ » dans le document. ==== Titre de niveau 3 ==== === Titre de niveau 4 === == Titre de niveau 5 == ==== Titre de niveau 3 ==== === Titre de niveau 4 === == Titre de niveau 5 == En utilisant quatre tirets ou plus, vous pouvez créer une ligne horizontale : ---- ===== Fichiers multimédias ===== Vous pouvez inclure des [[doku>images|images, vidéos et fichiers audio]] externes et internes à l'aide d'accolades. Vous pouvez également spécifier leur taille. Taille réelle : {{wiki:dokuwiki-128.png}} Redimensionner à la largeur indiquée : {{wiki:dokuwiki-128.png?50}} Redimensionner à la largeur et à la hauteur données ((lorsque le rapport hauteur/largeur de la largeur et de la hauteur données ne correspond pas à celui de l'image, celle-ci sera recadrée au nouveau rapport avant d'être redimensionnée)) : {{wiki:dokuwiki-128.png?200x50}} Image externe redimensionnée : {{https://www.php.net/images/php.gif?200x50}} Taille réelle : {{wiki:dokuwiki-128.png}} Redimensionner à la largeur indiquée : {{wiki:dokuwiki-128.png?50}} Redimensionnement à la largeur et hauteur données : {{wiki:dokuwiki-128.png?200x50}} Image externe redimensionnée : {{https://www.php.net/images/php.gif?200x50}} En utilisant des espaces blancs à gauche ou à droite, vous pouvez choisir l'alignement. {{ 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 également ajouter un titre (affiché sous forme d'info-bulle par la plupart des navigateurs). {{ wiki:dokuwiki-128.png |Ceci est la légende}} {{ wiki:dokuwiki-128.png |Ceci est la légende}} Pour lier une image à une autre page, voir [[#Liens vers des images]] ci-dessus. ==== Formats multimédias pris en charge ==== DokuWiki peut intégrer directement les formats multimédias suivants. | Image | « gif », « jpg », « png » | | Vidéo | « webm », « ogv », « mp4 » | | Audio | “'ogg”', “'mp3”', “'wav”' | | Flash | “'swf”' | Si vous spécifiez un nom de fichier qui n'est pas un format multimédia pris en charge, il s'affichera sous forme de lien. En ajoutant « ?linkonly », vous fournissez un lien vers le média sans l'afficher en ligne. {{wiki:dokuwiki-128.png?linkonly}} {{wiki:dokuwiki-128.png?linkonly}} Il s'agit simplement d'un lien vers l'image. ==== Formats de secours ==== Malheureusement, tous les navigateurs ne prennent pas en charge tous les formats vidéo et audio. Pour pallier ce problème, vous pouvez télécharger votre fichier dans différents formats afin d'optimiser la compatibilité avec les navigateurs. Prenons l'exemple de cette vidéo mp4 intégrée : {{video.mp4|Une vidéo amusante}} Lorsque vous téléchargez un fichier « video.webm » et « video.ogv » à côté du fichier « video.mp4 » référencé, DokuWiki les ajoute automatiquement comme alternatives afin que l'un des trois fichiers soit pris en charge par votre navigateur. De plus, DokuWiki prend en charge une image « poster » qui s'affiche avant le démarrage de la vidéo. Cette image doit avoir le même nom de fichier que la vidéo et être au format jpg ou png. Dans l'exemple ci-dessus, un fichier « video.jpg » fonctionnerait. ===== Listes ===== Dokuwiki prend en charge les listes ordonnées et non ordonnées. Pour créer un élément de liste, indentez votre texte de deux espaces et utilisez un « * » pour les listes non ordonnées ou un « - » pour les listes ordonnées. * Ceci est une liste * Le deuxième élément * Vous pouvez avoir différents niveaux * Un autre élément - La même liste, mais ordonnée - Un autre élément - Utilisez simplement l'indentation pour les niveaux plus profonds - C'est tout * Ceci est une liste * Le deuxième élément * Vous pouvez avoir différents niveaux * Un autre élément - La même liste, mais ordonnée - Un autre élément - Utilisez simplement l'indentation pour les niveaux plus profonds - C'est tout Consultez également la [[doku>faq:lists|FAQ sur les éléments de liste]]. ===== Conversions de texte ===== DokuWiki peut convertir certains caractères ou chaînes prédéfinis en images ou en autre texte ou HTML. La conversion de texte en image est principalement utilisée pour les smileys. La conversion de texte en HTML est utilisée pour les remplacements typographiques, mais peut également être configurée pour utiliser d'autres balises HTML. ==== Conversions de texte en image ==== DokuWiki convertit les [[wp>émoticônes]] couramment utilisées en leurs équivalents graphiques. Ces [[doku>smileys]] et autres images peuvent être configurés et étendus. Voici un aperçu des smileys inclus dans DokuWiki : * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% =) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * m( %% m( %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% FIXME %% * DELETEME %% DELETEME %% ==== Conversions de texte en HTML ==== Typographie : [[DokuWiki]] peut convertir des caractères de texte simples en entités typographiques correctes. Voici un exemple de caractères reconnus. -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) « Il pensait : « C'est un monde d'hommes... » » -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) « Il pensait : « C'est un monde d'hommes... » » La même chose peut être faite pour produire n'importe quel type de HTML, il suffit de l'ajouter au [[doku>entités|fichier de modèles]]. Il existe trois exceptions qui ne proviennent pas de ce fichier de modèles : l'entité de multiplication (640x480), les guillemets simples et les guillemets doubles. Elles peuvent être désactivées via une [[doku>config:typographie|option de configuration]]. ===== Citations ===== Parfois, vous souhaitez marquer un texte pour indiquer qu'il s'agit d'une réponse ou d'un commentaire. Vous pouvez utiliser la syntaxe suivante : Je pense que nous devrions le faire. > Non, nous ne devrions pas. >> Eh bien, je pense que nous devrions. > Vraiment ? >> Oui ! >>> Alors faisons-le ! Je pense que nous devrions le faire. > Non, nous ne devrions pas. >> Eh bien, je pense que nous devrions le faire > Vraiment ? >> Oui ! >>> Alors faisons-le ! ===== Tableaux ===== DokuWiki prend en charge une syntaxe simple pour créer des tableaux. ^ En-tête 1 ^ En-tête 2 ^ En-tête 3 ^ | Ligne 1 Colonne 1 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | | Ligne 2 Colonne 1 | some colspan (notez le double pipe) || | Ligne 3 Colonne 1 | Ligne 3 Colonne 2 | Ligne 3 Colonne 3 | Les lignes du tableau doivent commencer et se terminer par un « | » pour les lignes normales ou un « ^ » pour les en-têtes. ^ En-tête 1 ^ En-tête 2 ^ En-tête 3 ^ | Ligne 1 Colonne 1 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | | Ligne 2 Colonne 1 | some colspan (notez le double pipe) || | Ligne 3 Colonne 1 | Ligne 3 Colonne 2 | Ligne 3 Colonne 3 | Pour relier des cellules horizontalement, il suffit de laisser la cellule suivante complètement vide, comme indiqué ci-dessus. Veillez à toujours avoir le même nombre de séparateurs de cellules ! Il est également possible d'utiliser des en-têtes de tableau verticaux. | ^ En-tête 1 ^ En-tête 2 ^ ^ En-tête 3 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | ^ En-tête 4 | pas de colspan cette fois-ci | | ^ En-tête 5 | Ligne 2 Colonne 2 | Ligne 2 Colonne 3 | Comme vous pouvez le constater, c'est le séparateur de cellules avant une cellule qui détermine la mise en forme : | ^ En-tête 1 ^ En-tête 2 ^ ^ En-tête 3 | Ligne 1 Colonne 2 | Ligne 1 Colonne 3 | ^ En-tête 4 | pas de colspan cette fois-ci | | ^ En-tête 5 | Ligne 2 Colonne 2 | Ligne 2 Colonne 3 | Vous pouvez créer des lignes multiples (cellules reliées verticalement) en ajoutant « %%:::%% » dans les cellules situées sous celles auxquelles elles doivent être reliées. ^ En-tête 1 ^ En-tête 2 ^ En-tête 3 ^ | Ligne 1 Colonne 1 | cette cellule s'étend verticalement | Ligne 1 Colonne 3 | | Ligne 2 Colonne 1 | ::: | Ligne 2 Colonne 3 | | Ligne 3 Colonne 1 | ::: | Ligne 2 Colonne 3 | Hormis la syntaxe rowspan, ces cellules ne doivent contenir aucun autre élément. ^ En-tête 1 ^ En-tête 2 ^ En-tête 3 ^ | Ligne 1 Colonne 1 | cette cellule s'étend verticalement | Ligne 1 Colonne 3 | | Ligne 2 Colonne 1 | ::: | Ligne 2 Colonne 3 | | Ligne 3 Colonne 1 | ::: | Ligne 2 Colonne 3 | Vous pouvez également aligner le contenu du tableau. Il suffit d'ajouter au moins deux espaces à l'extrémité opposée de votre texte : ajoutez deux espaces à gauche pour aligner à droite, deux espaces à droite pour aligner à gauche et au moins deux espaces aux deux extrémités pour centrer le texte. ^ Tableau avec alignement ^^^ | droite| centre |gauche | |gauche | droite| centre | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Voici à quoi cela ressemble dans la source : ^ Tableau avec alignement ^^^ | droite| centre |gauche | |gauche | droite| centre | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Remarque : l'alignement vertical n'est pas pris en charge. ===== Pas de mise en forme ===== Si vous avez besoin d'afficher du texte exactement tel qu'il est saisi (sans aucune mise en forme), encadrez la zone avec les balises « %%%% » ou, plus simplement encore, avec deux signes pour cent « %% ». Ceci est un texte qui contient des adresses telles que : http://www.splitbrain.org et **formatage**, mais rien n'est fait avec. Il en va de même pour %%//__ce__ texte// avec un smiley ;-)%%. Ceci est un texte qui contient des adresses comme ceci : http://www.splitbrain.org et **formatage**, mais rien n'est fait avec. Il en va de même pour %%//__ce__ texte// avec un smiley ;-)%%. ===== Blocs de code ===== Vous pouvez inclure des blocs de code dans vos documents en les indentant d'au moins deux espaces (comme dans les exemples précédents) ou en utilisant les balises “”%%%%“” ou “”%%%%“”. Ce texte est indenté de deux espaces. Il s'agit d'un code préformaté où tous les espaces sont conservés : comme <-ceci C'est à peu près la même chose, mais vous pouvez l'utiliser pour indiquer que vous citez un fichier. Ces blocs ont été créés à partir de cette source : Ce texte est indenté de deux espaces. Il s'agit d'un code préformaté, tous les espaces sont conservés : comme <-ceci C'est à peu près la même chose, mais vous pouvez l'utiliser pour indiquer que vous avez cité un fichier. ==== Mise en évidence de la syntaxe ==== [[wiki:DokuWiki]] peut mettre en évidence le code source, ce qui facilite sa lecture. Il utilise le générateur de syntaxe générique [[http://qbnz.com/highlighter/|GeSHi]] -- ainsi, tous les langages pris en charge par GeSHi sont pris en charge. La syntaxe utilise les mêmes blocs de code et de fichier que ceux décrits dans la section précédente, mais cette fois-ci, le nom de la syntaxe du langage à mettre en évidence est inclus dans la balise, par exemple « » ou « ». /** * La classe HelloWorldApp implémente une application qui * affiche simplement « Hello World ! » sur la sortie standard. */ class HelloWorldApp { public static void main(String[] args) { System.out.println(« Hello World! »); //Affiche la chaîne. } } Les chaînes de caractères suivantes sont actuellement reconnues : //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic// Il existe des [[doku>syntax_highlighting|options avancées]] supplémentaires pour la coloration syntaxique, telles que la mise en évidence des lignes ou l'ajout de numéros de ligne. ==== Blocs de code téléchargeables ==== Lorsque vous utilisez la syntaxe « %%%% » ou « %%%% » comme ci-dessus, vous pouvez également rendre le code affiché disponible au téléchargement. Pour ce faire, spécifiez un nom de fichier après le code de langage, comme ceci : Si vous ne souhaitez pas de mise en évidence mais voulez un fichier téléchargeable, spécifiez un tiret (“”-'“) comme code de langage : ”'%%%%“”. ===== Agrégation de flux RSS/ATOM ===== [[DokuWiki]] peut intégrer des données provenant de flux XML externes. Pour analyser les flux XML, [[http://simplepie.org/|SimplePie]] est utilisé. Tous les formats compris par SimplePie peuvent également être utilisés dans DokuWiki. Vous pouvez influencer le rendu à l'aide de plusieurs paramètres supplémentaires séparés par des espaces : ^ Paramètre ^ Description ^ | n'importe quel nombre | sera utilisé comme nombre maximal d'éléments à afficher, la valeur par défaut est 8 | | reverse | affiche les derniers éléments du flux en premier | | author | affiche les noms des auteurs des éléments | | date | affiche les dates des éléments | | description| affiche la description des éléments. Toutes les balises HTML seront supprimées | | nosort | ne trie pas les éléments du flux | | //n//[dhm] | période de rafraîchissement, où d = jours, h = heures, m = minutes. (par exemple, 12h = 12 heures). | La période de rafraîchissement est de 4 heures par défaut. Toute valeur inférieure à 10 minutes sera considérée comme 10 minutes. [[wiki:DokuWiki]] essaiera généralement de fournir une version mise en cache d'une page, ce qui n'est évidemment pas approprié lorsque la page contient du contenu externe dynamique. Le paramètre indique à [[wiki:DokuWiki]] de réafficher la page si plus de //période de rafraîchissement// s'est écoulée depuis le dernier affichage de la page. Par défaut, le flux sera trié par date, les éléments les plus récents apparaissant en premier. Vous pouvez le trier par ordre chronologique décroissant à l'aide du paramètre « reverse », ou afficher le flux tel quel avec « nosort ». **Exemple :** {{rss>http://slashdot.org/index.rss 5 author date 1h }} {{rss>http://slashdot.org/index.rss 5 author date 1h }} ===== Macros de contrôle ===== Certaines syntaxes influencent la manière dont DokuWiki affiche une page sans créer de sortie elle-même. Les macros de contrôle suivantes sont disponibles : ^ Macro ^ Description | | %%~~NOTOC~~%% | Si cette macro est trouvée sur la page, aucune table des matières ne sera créée | | %%~~NOCACHE~~%% | DokuWiki met en cache toutes les sorties par défaut. Cela peut parfois ne pas être souhaitable (par exemple lorsque la syntaxe %%%% ci-dessus est utilisée). L'ajout de cette macro forcera DokuWiki à réafficher une page à chaque appel | ===== Plugins de syntaxe ===== La syntaxe de DokuWiki peut être étendue par des [[doku>plugins|plugins]]. L'utilisation des plugins installés est décrite dans leurs pages de description respectives. Les plugins de syntaxe suivants sont disponibles dans cette installation particulière de DokuWiki : ~~INFO:syntaxplugins~~