locale/fr/pgsrc/Aide%2FPluginColorationPhp

   1 Date: Tue, 25 Jan 2011 17:50:09 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0)
   3 X-Rcs-Id: $Id$
   4 Content-Type: application/x-phpwiki;
   5   pagename=Aide%2FPluginColorationPhp;
   6   flags="";
   7   markup=2;
   8   charset=utf-8
   9 Content-Transfer-Encoding: binary
  10
  11 ===Description
  12
  13 PluginColorationPhp affiche le code PHP en coloration syntaxique
  14 en utilisant la fonction php-function: highlight-string
  15
  16 ===Usage
  17
  18 Vous devez spécifier les options de ce plugin sur la même ligne que
  19 =<<= puis écrire le code sur les lignes suivantes jusqu'au
  20 =>>= final :
  21
  22 {{{
  23 <<PhpHighlight [wrap?] [color options]
  24 code devant être coloré
  25 >>
  26 }}}
  27
  28 Dépendant de l'option =wrap=, le code prendra soin d'ajouter =<?php=
  29 et =>>= au code avant de la passer à la fonction highlight-string. Si
  30 les délimiteurs php sont déjà présents alors le plugin les enlèvera
  31 encore de la chaîne colorée avant de les afficher.
  32
  33 ===Options
  34
  35 Enveloppement automatique :
  36
  37   Si vous ne voulez pas que le plugin enveloppe automatiquement le code
  38   source dans =<?php= et =?>= alors positionnez =wrap= sur =0=. La valeur
  39   par défaut est =1=, ce qui signifie que le plugin prendra soin d'ajouter
  40   ou d'enlver =<?php= et =?>= automatiquement.
  41
  42   Si vous mettez =wrap= à =0= alors vous aurez la possibilité de mélanger
  43   du PHPO avec de l'HTML. Le plugin transformera '=< ?php=' en =<?php=' et
  44   '=? >=' en '=?>=' pour vous permettre de démarrer et d'arrêter le mode
  45   PHP dans votre code.
  46
  47 Options des couleurs :
  48
  49   Le plugin accepte des arguments optionnels pour les couleurs qui correspondent
  50   à la coloration définie dans *php.ini*. Les couleurs doivent être spécifiées
  51   par des valeurs hexadécimales ou des
  52   [noms de couleur HTML 4|http://www.w3.org/TR/REC-html40/types.html#h-6.5]
  53   en minuscules comme ='#0f0344'= ou =blue=. Vous pouvez utiliser les options
  54   suivantes :
  55
  56   =string=, =comment=, =keyword=, =bg=, =default=, and =html=
  57
  58 ===Exemples
  59
  60 ==== Code PHP avec les couleurs par défaut de =php.ini= :
  61
  62 <<PhpHighlight
  63 function hello() {
  64     echo "Hello World<p>";
  65 }
  66 >>
  67
  68 ==== HTML avec PHP inclus
  69
  70 Ici nous devons utiliser =wrap=0= pour prévenir l'enveloppement automatique
  71 et fermer '=?>=' comme '=? >=' :
  72
  73 <<PhpHighlight wrap=0 html='#000000' bg='#dddddd'
  74 <html>
  75   <head>
  76     <title>PHP Test</title>
  77   </head>
  78   <body>
  79     < ?php echo "<p>Hello World</p>\n"; ? >
  80   </body>
  81 </html>
  82 >>
  83
  84 ==== Source en C
  85
  86 Bien que =highlight_string()= ait été conçu avec du code PHP à l'esprit,
  87 il est utilisable pour des colorations syntaxique de code C car les deux
  88 syntaxe sont similaires.
  89
  90
  91 <<PhpHighlight default=black string=blue comment=gray keyword=purple
  92 #include <stdio.h>
  93 /* Get load */
  94 int
  95 getload(void)
  96 {
  97     if ((fp = fopen("/proc/loadavg", "r")) == NULL) {
  98         syslog(LOG_ERR, _("%s %s: unable to open %s: %s"), _("FATAL ERROR:"),
  99               "getload()", "/proc/loadavg", strerror(errno));
 100         exit(EX_OSFILE);
 101     }
 102     fclose(fp);
 103 }
 104 >>
 105
 106 ===Auteurs
 107
 108 Martin Geisler mailto:gimpster@gimpster.com et Carsten Klapp
 109 mailto:carstenklapp@users.sourceforge.net.
 110
 111 <noinclude>
 112 ----
 113 [[DocumentationDePhpWiki]] [[CatégoriePluginWiki]]
 114 </noinclude>