Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

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
Prochaine révision		Révision précédente
Dernière révisionLes deux révisions suivantes
wiki:syntax [2021/06/22 18:25] – [Pas de formatage] adminwiki:syntax [2021/06/22 21:02] – [Syntax Plugins] admin
Ligne 351: Ligne 351:
   Il en est de même pour %%//__ce__ texte// avec un smiley ;-)%%.   Il en est de même pour %%//__ce__ texte// avec un smiley ;-)%%.
  
-===== Code Blocks =====+===== Blocs de code =====
  
-You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags ''%%<code>%%'' or ''%%<file>%%''.+Vous pouvez inclure des blocs de code dans vos documents en les indentant d'au moins deux espaces (comme utilisé pour les exemples précédents) ou en utilisant les balises ''%%<code>%%'' or ''%%<file>%%''.
  
-  This is text is indented by two spaces.+  Ce texte est indenté par deux espaces.
  
 <code> <code>
-This is preformatted code all spaces are preserved: like              <-this+Il s'agit de code préformaté, tous les espaces sont conservés : comme             <-this
 </code> </code>
  
 <file> <file>
-This is pretty much the same, but you could use it to show that you quoted a file.+C'est à peu près la même chose, mais vous pouvez l'utiliser pour montrer que vous avez cité un fichier.
 </file> </file>
  
-Those blocks were created by this source:+Ces blocs ont été créés par cette source :
  
-    This is text is indented by two spaces.+  Ce texte est indenté par deux espaces.
  
   <code>   <code>
-  This is preformatted code all spaces are preserved: like              <-this+  Il s'agit de code préformaté tous les espaces sont conservés : comme              <-ceci
   </code>   </code>
  
   <file>   <file>
-  This is pretty much the same, but you could use it to show that you quoted a file.+  C'est à peu près la même chose, mais vous pouvez l'utiliser pour montrer que vous avez cité un fichier.
   </file>   </file>
  
-==== Syntax Highlighting ====+==== Coloration syntaxique ====
  
-[[wiki:DokuWiki]] can highlight sourcecode, which makes it easier to read. It uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supported. The syntax uses the same code and file blocks described in the previous section, but this time the name of the language syntax to be highlighted is included inside the tag, e.g. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.+[[wiki:DokuWiki]] peut mettre en évidence le code source, ce qui le rend plus facile à lire. Il utilise le surligneur de syntaxe générique [[http://qbnz.com/highlighter/|GeSHi]] -- donc tout langage pris en charge par GeSHi est pris en charge. La syntaxe utilise les mêmes blocs de code et de fichier décrits dans la section précédente, mais cette fois le nom de la syntaxe du langage à mettre en évidence est inclus à l'intérieur de la balise, par ex. ''<nowiki><code java></nowiki>'' ou ''<nowiki><file java></nowiki>''.
  
 <code java> <code java>
Ligne 393: Ligne 393:
 </code> </code>
  
-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//+Les langages suivants sont actuellement reconnus: //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.+Des [[doku>syntax_highlighting|options avancées]] supplémentaires sont disponibles pour la coloration syntaxique, comme la coloration de lignes ou l'ajout de numéros de ligne.
  
-==== Downloadable Code Blocks ====+==== Blocs de code téléchargeables ====
  
-When you use the ''%%<code>%%'' or ''%%<file>%%'' 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:+Lorsque vous utilisez la syntaxe ''%%<code>%%'' ou ''%%<file>%%'' comme ci-dessus, vous souhaiterez peut-être également rendre le code affiché disponible au téléchargement. Vous pouvez le faire en spécifiant un nom de fichier après le code de langue comme ceci :
  
 <code> <code>
Ligne 411: Ligne 411:
 </file> </file>
  
-If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%<code - myfile.foo>%%''.+Si vous ne voulez pas de surbrillance mais voulez un fichier téléchargeable, spécifiez un tiret (''-'') comme code de langage : ''%%<code - myfile.foo>%%''.
  
-===== Embedding HTML and PHP =====+===== Intégration de HTML et PHP =====
  
-You can embed raw HTML or PHP code into your documents by using the ''%%<html>%%'' or ''%%<php>%%'' tags. (Use uppercase tags if you need to enclose block level elements.)+Vous pouvez intégrer du code HTML ou PHP brut dans vos documents en utilisant les balises ''%%<html>%%'' ou ''%%<php>%%''. (Utilisez des balises majuscules si vous devez inclure des éléments de niveau bloc.)
  
-HTML example:+Exemple HTML :
  
 <code> <code>
Ligne 435: Ligne 435:
 </HTML> </HTML>
  
-PHP example:+Exemple PHP :
  
 <code> <code>
Ligne 461: Ligne 461:
 </PHP> </PHP>
  
-**Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed.+<WRAP center round info 60%> 
 +L'intégration HTML et PHP est désactivée par défaut dans la configuration. Si désactivé, le code est affiché au lieu d'être exécuté. 
 +</WRAP>
  
-===== RSS/ATOM Feed Aggregation ===== 
  
-[[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://simplepie.org/|SimplePie]] is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:+===== Agrégation de flux RSS/ATOM =====
  
-^ Parameter  ^ Description ^ +[[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 par plusieurs paramètres supplémentaires séparés par des espaces :
-| any number | will be used as maximum number items to show, defaults to 8 | +
-| reverse    | display the last items in the feed first | +
-| author     | show item authors names | +
-| date       | show item dates | +
-| description| show the item description. If [[doku>config:htmlok|HTML]] is disabled all tags will be stripped | +
-| nosort     | do not sort the items in the feed | +
-| //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |+
  
-The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.+^ Paramètre ^ Description ^ 
 +| n'importe quel nombre | sera utilisé comme nombre maximum d'éléments à afficher, la valeur par défaut est 8 | 
 +| reverse    | afficher les derniers éléments du flux en premier | 
 +| author     | afficher les noms des auteurs des éléments | 
 +| date       | afficher les dates des articles | 
 +| description| afficher la description de l'article. Si [[doku>config:htmlok|HTML]] est désactivé, toutes les balises seront supprimées | 
 +| nosort     | ne pas trier les éléments dans l'alimentation | 
 +| //n//[dhm] | période de rafraîchissement, où j=jours, h=heures, m=minutes. (par exemple 12h = 12 heures). |
  
-By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the ''reverse'' parameter, or display the feed as is with ''nosort''.+La période d'actualisation est par défaut de 4 heures. 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 est évidemment inapproprié lorsque la page contient du contenu externe dynamique. Le paramètre indique à [[wiki:DokuWiki]] de réafficher la page si elle est supérieure à //la période de rafraîchissement// depuis le dernier rendu de la page.
  
-**Example:**+Par défaut, le flux sera trié par date, les articles les plus récents en premier. Vous pouvez le trier par le plus ancien en premier en utilisant le 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 }}
Ligne 488: Ligne 491:
 ===== Control Macros ===== ===== Control Macros =====
  
-Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:+Certaines syntaxes influencent la façon dont DokuWiki affiche une page sans créer de sortie lui-même. Les macros de contrôle suivantes sont disponibles :
  
 ^ Macro           ^ Description | ^ Macro           ^ Description |
-| %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created | +| %%~~NOTOC~~%%   | Si cette macro est trouvée sur la page, aucune table des matières ne sera créée | 
-| %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call |+| %%~~NOCACHE~~%% | DokuWiki met en cache toutes les sorties par défaut. Parfois, cela peut ne pas être souhaité (par exemple, lorsque la syntaxe %%<php>%% ci-dessus est utilisée), l'ajout de cette macro forcera DokuWiki à réafficher une page à chaque appel |
  
 ===== Syntax Plugins ===== ===== Syntax Plugins =====
  
-DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:+La syntaxe de DokuWiki peut être étendue par [[doku>plugins|Plugins]]. La façon dont les plugins installés sont utilisés est décrite sur leurs pages de description appropriées. Les plugins de syntaxe suivants sont disponibles dans cette installation particulière de DokuWiki :
  
 ~~INFO:syntaxplugins~~ ~~INFO:syntaxplugins~~
  

Piste :