====== Syntaxe de mise en forme ====== [[doku>DokuWiki]] supporte un langage de balisage simple, qui tente de rendre les fichiers de données aussi lisibles que possible. Cette page contient toutes les syntaxes possibles que vous pouvez utiliser lors de l'édition des pages. Il suffit de consulter la source de cette page en cliquant sur "Editer cette page". Si vous voulez essayer quelque chose, il suffit d'utiliser la page [[fr:playground:playground|playground]] page. Le balisage plus simple est facilement accessible via [[doku>toolbar|quickbuttons]], également. ===== Mise en forme de texte de base ===== DokuWiki supporte **bold**, //italic//, __underlined__ and ''monospaced'' des textes de qualité. Bien entendu, vous pouvez **__//''combiner''//__** tous ces éléments. DokuWiki supporte **bold**, //italique//, __underlined__ and ''monospaced'' des textes de qualité. Bien entendu, vous pouvez **__//''combiner''//__** tous ces éléments. Vous pouvez utiliser souscrire à et superscriptégalement. Vous pouvez utiliser subscript et superscriptégalement. Vous pouvez marquer quelque chose comme supprimé de la même manière. Vous pouvez marquer quelque chose comme supprimé de la même manière. **Les paragraphes** sont créés à partir de lignes vierges. Si vous voulez **forcer une nouvelle ligne** sans paragraphe, vous pouvez utiliser deux barres obliques inverses suivies d'un espace blanc ou de la fin de la ligne. Voici un texte avec quelques sauts de ligne.\\ Notez que les deux anti-slashs ne sont reconnus qu'à la fin d'une ligne\\ ou suivies d'un\\ un espace blanc \\ceci se produit sans cela. Voici un peu de texte avec quelques ruptures de lignes\\ Notez que les deux anti-slashs ne sont reconnus qu'à la fin d'une ligne\\ ou suivies d'un\\ un espace blanc \\ceci se produit sans cela. Vous ne devriez utiliser des lignes de caractères forcées que si c'est vraiment nécessaire. ===== Liens ===== DokuWiki supporte plusieurs façons de créer des liens. ==== Externe ==== Les liens externes sont reconnus automatiquement : http://www.google.com or simply www.google.com - Vous pouvez également définir le texte du lien : [[http://www.google.com|This Points de liaison avec google]]. Les adresses e-mail comme celle-ci : sont reconnus, également. DokuWiki supporte plusieurs façons de créer des liens. Les liens externes sont reconnus de manière automatique : http://www.google.com or simply www.google.com - You can set texte de lien aussi : [[http://www.google.com|This Link points to google]]. Email Les adresses comme celle-ci : sont reconnues, elles aussi. ==== Interne ==== Les liens internes sont créés à l'aide de brackets carrés. Vous pouvez soit simplement donner un [[wiki:pagename]] soit utiliser un lien supplémentaire. [[wiki:pagename|link text]]. Les liens internes sont créés à l'aide de brackets carrés. Vous pouvez soit simplement donner a [[wiki:pagename]] or use an additional [[wiki:pagename|link text]]. [[doku>pagename|Les pagenames Wiki]] sont automatiquement convertis en lowercase, les caractères spéciaux ne sont pas autorisés. Vous pouvez utiliser [[some:namespaces]] en utilisant une colonne dans le nom de pagen. You can use [[some:namespaces]] by using a colon in the pagename. Pour plus de détails sur les espaces de noms, voir [[doku>namespaces]] . Le lien vers une section spécifique est également possible. Il suffit d'ajouter le nom de la section derrière un caractère de hachage comme on le connaît en HTML. Ce lien vers [[wiki:syntax#internal|cette section]]. Ce lien vers [[wiki:syntax#internal|cette section]]. Notes : * Les liens vers [[wiki:syntax|pages existantes]] sont affichés dans un style différent de [[wiki:nonexisting]] ones. * DokuWiki n'utilise pas [[wp>CamelCase]] pour créer automatiquement des liens par défaut, mais ce comportement peut être activé dans le fichier [[doku>config]] . Hint : Si DokuWiki est un lien, alors il est activé. * Quand le titre d'une section est modifié, son signet change aussi. Ne vous fiez donc pas trop aux liens de section. ==== Interwiki ==== DokuWiki supporte [[doku>Interwiki]] liens. Ce sont des liens rapides vers d'autres wikis. Par exemple, ceci est un lien vers la page de Wikipedia sur les wikis : [[wp>Wiki]] . DokuWiki supporte [[doku>Interwiki]] liens. Ce sont des liens rapides vers d'autres wikis. Par exemple, ceci est un lien vers la page about Wikis de Wikipedia : [[wp>Wiki]] . ==== Partage de Windows ==== Les partages Windows comme [[\\server\share|ce]] sont reconnues, elles aussi. Veuillez noter que cela n'a de sens que dans un groupe d'utilisateurs homogène comme une entreprise [[wp>Intranet]] . Les partages Windows comme [[\\server\share|]] sont reconnues, elles aussi. Notes : * Pour des raisons de sécurité, la navigation directe des partages de fenêtres ne fonctionne que dans Microsoft Internet Explorer par défaut (et uniquement dans la "zone locale"). * Pour Mozilla et Firefox, elle peut être activée par le biais de différentes solutions de contournement mentionnées dans la [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Base de connaissances]]. Toutefois, il y aura toujours un avertissement JavaScript concernant l'ouverture d'un partage Windows. Pour supprimer ce message d'avertissement (pour tous les utilisateurs), insérez la ligne suivante dans le fichier ''conf/lang/en/lang.php'' (plus de détails sur [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]) : ==== Liens d'image ==== Vous pouvez également utiliser une image pour faire un lien vers une autre page interne ou externe en combinant la syntaxe pour les liens et les [[wiki:deprecated#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 de l'image est la seule syntaxe de formatage acceptée dans les noms de liens. L'ensemble des [[wiki:deprecated#images_and_other_files|image]] et [[wiki:deprecated#links|link]] syntaxe est supportée (y compris le redimensionnement d'image, les images internes et externes et les URL et 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 différents d'en-têtes pour structurer votre contenu. Si vous avez plus de trois en-têtes, une table des matières est automatiquement générée -- cela peut être désactivé en incluant la chaîne de caractères ''~~NOTOC~~'' dans le document. ==== Tête de ligne niveau 3 ==== === Tête de ligne niveau 4 === == Headline niveau 5 == ==== Tête de ligne niveau 3 ==== === Tête de ligne niveau 4 === == Tête de ligne niveau 5 == En utilisant quatre ou plus de couches, vous pouvez créer une ligne horizontale : ---- ===== Fichiers multimédias ===== Vous pouvez inclure des fichiers externes et internes [[doku>images|images, vidéos et fichiers audio]] avec des brackets curly. En option, vous pouvez spécifier leur taille. Taille réelle : {{wiki:dokuwiki-128.png}} Redimensionner à la largeur donnée : {{wiki:dokuwiki-128.png?50}} Resize to given width and height((si le ratio d'aspect de la largeur et de la hauteur données ne correspond pas à celui de l'image, elle sera recadrée au nouveau ratio 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 à une largeur donnée : {{wiki:dokuwiki-128.png?50}} Resize to given width and height : {{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 }} Of course, you can add a title (displayed as a tooltip by most browsers), too. {{ wiki:dokuwiki-128.png |Voici le titre}} {{ wiki:dokuwiki-128.png |This is the caption}} Pour lier une image à une autre page, voir [[wiki:deprecated#Image Links]] ci-dessus. ==== Formats de médias pris en charge ==== DokuWiki peut intégrer directement les formats de mé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 média supporté, il sera affiché comme un lien à la place. 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 repli ==== Malheureusement, tous les navigateurs ne comprennent pas tous les formats vidéo et audio. Pour remédier à ce problème, tu peux télécharger ton fichier dans différents formats pour une compatibilité maximale avec le navigateur. Par exemple, considérez cette vidéo mp4 intégrée : {{wiki:video.mp4|Une vidéo amusante}} Lorsque vous téléchargez un ''video.webm'' et ''video.ogv'' à côté de la vidéo référencée ''video.mp4''DokuWiki les ajoutera automatiquement comme alternatives pour que l'un des trois fichiers soit compris par votre navigateur. De plus, DokuWiki supporte une image "poster" qui sera affichée avant que la vidéo ne commence. Cette image doit avoir le même nom de fichier que la vidéo et être un fichier jpg ou png. Dans l'exemple ci-dessus, un ''video.jpg'' fonctionnerait. ===== Listes ===== Dokuwiki supporte les listes ordonnées et non ordonnées. Pour créer un élément de liste, indiquez votre texte par deux espaces et utilisez un ''*'' pour les listes non ordonnées ou un ''-'' pour les listes ordonnées. * This is a list * The second item * Vous pouvez avoir des niveaux différents * Un autre objet - La même liste mais arrangée - Un autre objet - Il suffit d'utiliser l'indention pour les niveaux inférieurs - C'est ça * This is a list * The second item * You may have different levels * Another item - The same list but ordered - Another item - Just use indention for deeper levels - That's it Aussi, consultez la [[doku>faq:lists|FAQ sur la liste des articles]]. ===== Conversions de texte ===== DokuWiki peut convertir certains caractères ou chaînes prédéfinis en images ou autres textes ou HTML. La conversion texte-image se fait principalement pour les smileys. Et la conversion texte vers HTML est utilisée pour les remplacements de typographie, mais peut être configurée pour utiliser d'autres HTML également. ==== Conversions de texte en image ==== DokuWiki convertit des [[wp>emoticon]] s couramment utilisés en leurs équivalents graphiques. Ces [[doku>Smileys]] et autres images peuvent être configurées et étendues. 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 texte vers HTML ==== Typographie : [[fr:wiki:dokuwiki]] peut convertir de simples caractères de texte en leurs entités typographiquement correctes. Voici un exemple de caractères reconnus. -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..." -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..." La même chose peut être faite pour produire n'importe quel type de HTML, il suffit de l'ajouter au fichier [[doku>entities|fichier modèle]]. Il y a trois exceptions qui ne proviennent pas de ce fichier modèle : l'entité de multiplication (640x480), les 'citations simples' et les 'citations doubles'. Elles peuvent être désactivées par l'intermédiaire de l'option [[doku>config:typography|option de configuration]]. ===== Quoting ===== Parfois, vous voulez marquer un texte pour indiquer qu'il s'agit d'une réponse ou d'un commentaire. Vous pouvez utiliser la syntaxe suivante : I think we should do it > No we shouldn't >> Well, I say we should > Really? >> Yes! >>> Then lets do it! Je pense que nous devrions le faire > No we shouldn't >> Eh bien, je dis que nous devrions > Really ? >> Yes ! >>> Then lets do it ! ===== Tables ===== DokuWiki supporte une syntaxe simple pour créer des tables. ^ En-tête 1 ^ En-tête 2 ^ En-tête 3 ^ | Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 | | Row 2 Col 1 | quelques colspan (notez la double pipe) || | rangée 3 col 1 | Row 3 Col 2 | Row 3 Col 3 | Les rangées de tableaux doivent commencer et finir par un ''|'' pour les rangées normales ou a ''^'' pour les en-têtes. ^ En-tête 1 ^ En-tête 2 ^ En-tête 3 ^ | Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 | | Row 2 Col 1 | quelques colspan (notez la double pipe) || | rangée 3 col 1 | Row 3 Col 2 | Row 3 Col 3 | Pour connecter les cellules horizontalement, il suffit de faire en sorte que la cellule suivante soit complètement vide comme indiqué ci-dessus. Veillez à toujours avoir la même quantité de séparateurs de cellules ! Les en-têtes de table verticaux sont également possibles. | ^ Tête 1 ^ Tête 2 ^ ^ Tête 3 | Row 1 Col 2 | Row 1 Col 3 | ^ tête 4 | pas de colspan cette fois | | ^ Tête 5 | rangée 2 col 2 | Rang 2 Col 3 | Comme vous pouvez le voir, c'est le séparateur de cellules qui précède une cellule qui décide du formatage : | ^ En-tête 1 ^ En-tête 2 ^ ^ Tête 3 | Row 1 Col 2 | Row 1 Col 3 | ^ tête 4 | pas de colspan cette fois | | ^ Tête 5 | Rang 2 Col 2 | Rang 2 Col 3 | Vous pouvez avoir des rowspans (cellules connectées verticalement) en ajoutant ''%%:::%%'' dans les cellules en dessous de celle à laquelle elles doivent se connecter. ^ En-tête 1 ^ En-tête 2 ^ Tête 3 ^ | rangée 1 col 1 | this cell spans vertically | Rangée 1 Col 3 | | Row 2 Col 1 | :: : | Row 2 Col 3 | | Row 3 Col 1 | :: : | Row 2 Col 3 | Hormis la syntaxe rowspan, ces cellules ne doivent contenir rien d'autre. ^ En-tête 1 ^ En-tête 2 ^ En-tête 3 ^ | rangée 1 col 1 | this cell spans vertically | Rangée 1 Col 3 | | Row 2 Col 1 | :: : | Row 2 Col 3 | | Row 3 Col 1 | :: : | Row 2 Col 3 | Vous pouvez aussi aligner le contenu du tableau. Il suffit d'ajouter au moins deux espaces blancs aux extrémités opposées de votre texte : ajoutez deux espaces à gauche pour l'alignement à droite, deux espaces à droite pour l'alignement à gauche et deux espaces au moins aux deux extrémités pour le texte centré. ^ Tableau avec alignement ^^^ | droite| centre |left | |left | droit| center | | xxxxxxxxxx | xxxxxxxxxx | xxxxxxxxxx | Voici ce qu'il en est dans la source : ^ Tableau avec alignement ^^^ | droite| centre |left | |left | droite| center | | xxxxxxxxxx | xxxxxxxxxx | xxxxxxxxxx | Remarque : L'alignement vertical n'est pas pris en charge. ===== Pas de mise en forme ===== Si vous avez besoin d'afficher le texte exactement tel qu'il est typé (sans aucun formatage), entourez la zone soit avec ''%%%%'' ou encore plus simple, avec des signes double percent ''%%''. Il s'agit d'un texte qui contient des adresses comme celle-ci : http://www.splitbrain.org et **formatage**mais rien n'est fait avec. La même chose est vraie pour %%.//__ce__ texte// avec un smiley ;-)%%. Il s'agit d'un texte qui contient des adresses comme celle-ci : http://www.splitbrain.org et **formatage**mais rien n'est fait avec. La même chose est vraie pour %%.//__ce__ texte// avec un smiley ;-)%%. ===== Blocs de code ===== Vous pouvez inclure des blocs de code dans vos documents, soit en les désignant par au moins deux espaces (comme utilisé pour les exemples précédents), soit en utilisant les balises ''%%%%'' or ''%%%%''. This is text is indented by two spaces. This is preformatted code all spaces are preserved: like <-this This is pretty much the same, but you could use it to show that you quoted a file. Ces blocs ont été créés par cette source : This is text is indented by two spaces. This is preformatted code all spaces are preserved: like <-this This is pretty much the same, but you could use it to show that you quoted a file. ==== Mise en évidence de la syntaxe ==== [[fr:wiki:dokuwiki]] permet de mettre en évidence le code source, ce qui le rend plus facile à lire. Il utilise le [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- donc n'importe quel langage supporté par GeSHi est supporté. La syntaxe utilise le même code et les mêmes blocs de fichiers 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 ex. '''' or ''''. /** * The HelloWorldApp class implements an application that * simply displays "Hello World!" to the standard output. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Hello World!"); //Display the string. } } The following language strings are currently recognized: //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// There are additional [[doku>syntax_highlighting|advanced options]] available for syntax highlighting, such as highlighting lines or adding line numbers. ==== Downloadable Code Blocks ==== When you use the ''%%%%'' or ''%%%%'' syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this: Si vous ne voulez pas de mise en évidence mais que vous voulez un fichier téléchargeable, spécifiez un dash (''-'') comme code de langue : ''%%%%''. ===== Agrégation de flux RSS/ATOM ===== [[fr:wiki:dokuwiki]] peut intégrer des données provenant de flux XML externes. Pour l'analyse des flux XML, [[http://simplepie.org/|SimplePie]] est utilisé. Tous les formats compris par SimplePie peuvent être utilisés dans DokuWiki. Vous pouvez influencer le rendu par plusieurs paramètres supplémentaires séparés par des espaces : ^ Paramètre ^ Description ^ | any number | will be used as the maximum number items to show, defaults to 8 | | reverse | afficher en premier les derniers éléments du flux | | auteur | afficher les noms des auteurs des articles | | date | show item dates | | description| afficher la description de l'article. Toutes les balises HTML seront supprimées | | nosort | ne trie pas les éléments dans le flux | | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | La période de rafraîchissement par défaut est de 4 heures. Toute valeur inférieure à 10 minutes sera traitée comme 10 minutes. [[fr:wiki:dokuwiki]] tentera généralement de fournir une version cachée d'une page, ce qui est évidemment inapproprié si la page contient un contenu externe dynamique. Le paramètre indique à [[fr:wiki:dokuwiki]] de relancer la page s'il y a plus de //période de rafraîchissement// depuis que la page a été rendue pour la dernière fois. Par défaut, le flux est trié par date, les éléments les plus récents en premier. Vous pouvez la trier par le plus ancien en utilisant l'option ''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 façon dont DokuWiki rend 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 cache toutes les sorties par défaut. Parfois, ce n'est pas nécessaire (par exemple, lorsque la %% ...%% syntaxe ci-dessus est utilisée), l'ajout de cette macro forcera DokuWiki à rendre 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 syntaxiques suivants sont disponibles dans cette installation particulière de DokuWiki : ~~INFO:syntaxplugins~~