locale/zh/pgsrc/PhpHighlightPlugin

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