locale/zh/pgsrc/Help%2FPhpHighlightPlugin

   1 Date: Fri, 10 Sep 2010 13:48:49 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0)
   3 Content-Type: application/x-phpwiki;
   4   pagename=Help%2FPhpHighlightPlugin;
   5   flags="";
   6   charset=UTF-8
   7 Content-Transfer-Encoding: binary
   8
   9 PhpHighlightPlugin 使用了 php-function:highlight-string 來優雅印出
  10 PHP 程式碼.
  11
  12 == Usage
  13
  14 在同一行指定 plugin 的選項,簡單說就是在 =<?plugin= 與 =?>= 之間置放選項.
  15
  16 {{{
  17 <<PhpHighlight [wrap?] [color options]
  18 code to be highlighted
  19 >>
  20 }}}
  21
  22 == Description
  23
  24 plugin 將視 =wrap= 選項決定是否要在傳入 php-function:highlight-string 之前
  25 適切地加入 =<?php= 與 =?>= . 如果加入了 PHP 分隔子,那麼 plugin 在輸出之前,
  26 會從 highlighted 字串再次移除他們.
  27
  28 == Options
  29
  30 Automatic Wrapping (自動分行):
  31
  32   如果你不想 plugin 自動為包在 =<?php= 和 =?>= 之間的源碼分行, 就設定
  33   =wrap= 為 0. 預設值是 =1=, 這表示 plugin 會自動小心地增加並移除
  34   =<?php= 和 =?>=.
  35
  36   如果你將 =wrap= 設為 =0=, 那麼你將得把 PHP 程式碼與 HTML 混在一起.
  37   plugin 將會轉換 '=< ?php=' 為 '=<?php=' , '=? >=' 為 '=?>=' 以允許你
  38   在程式碼中啟動與停止 PHP 模式.
  39
  40 Color Options:
  41
  42   plugin 允許使用(或不使用)對應到 *php.ini* 設定裡的 highlight 設定的
  43   顏色引數. 指定顏色時必須是一個正確的十六進位顏色或是以小寫表示的
  44   [HTML 4 color name|http://www.w3.org/TR/REC-html40/types.html#h-6.5]
  45   ,像是 ='#0f0344'= 或 =blue=. 你可以指定以下的選項:
  46
  47   =string=, =comment=, =keyword=, =bg=, =default=, and =html=
  48
  49 == Examples
  50
  51 === PHP 和預設顏色(從 =php.ini= 來的):
  52
  53 <<PhpHighlight
  54 function hello() {
  55     echo "Hello World<p>";
  56 }
  57 >>
  58
  59 === HTML 與嵌入的 PHP
  60
  61 這兒我們必須使用 =wrap=0= 以避免自動折行並替換 '=?>=' 為 '=? >=':
  62
  63 <<PhpHighlight wrap=0 html='#000000' bg='#dddddd'
  64 <html>
  65   <head>
  66     <title>PHP Test</title>
  67   </head>
  68   <body>
  69     < ?php echo "<p>Hello World</p>\n"; ? >
  70   </body>
  71 </html>
  72 >>
  73
  74 === C Source
  75
  76 雖然 =highlight_string() 是為 PHP 程式碼所設計,但他也適用於大部分 C 的基本
  77 語法 highlight ,因為這兩個語言的語法是很接近的.
  78
  79 <<PhpHighlight default=black string=blue comment=gray keyword=purple
  80 #include <stdio.h>
  81 /* Get load */
  82 int
  83 getload(void)
  84 {
  85     if ((fp = fopen("/proc/loadavg", "r")) == NULL) {
  86         syslog(LOG_ERR, _("%s %s: unable to open %s: %s"), _("FATAL ERROR:"),
  87               "getload()", "/proc/loadavg", strerror(errno));
  88         exit(EX_OSFILE);
  89     }
  90     fclose(fp);
  91 }
  92 >>
  93
  94 == Authors
  95
  96 Martin Geisler mailto:gimpster@gimpster.com and Carsten Klapp
  97 mailto:carstenklapp@users.sourceforge.net.