locale/zh/pgsrc/Help%2FMagicPhpWikiURLs

   1 Date: Fri,  4 Feb 2011 16:58:00 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0)
   3 Content-Type: application/x-phpwiki;
   4   pagename=Help%2FMagicPhpWikiURLs;
   5   flags=PAGE_LOCKED;
   6   charset=UTF-8
   7 Content-Transfer-Encoding: binary
   8
   9 == About phpwiki: URLs
  10
  11 一種特別的 URL, 用來建立連結以執行管理和 PhpWiki 裡的其他特殊功能.
  12 這裡是它們如何運作的簡短描述.
  13
  14 phpwiki 的基礎語法: URL 是
  15
  16 <pre>
  17 **phpwiki:**''pagename''**?**''query-args''
  18 </pre>
  19
  20 如果 _pagename_ 被忽略,那麼預設為目前頁面.
  21
  22 _Query-args_ 應該是以標準 HTTP GET 格式表示的一組參數.
  23
  24 "action=''x''" 參數應該都要被給定. 他可以是這些值的其中一個:
  25 **browse**, **diff**, **edit**, **viewsource**,
  26 **zip**, **dumpserial**, **loadserial**,
  27 **remove**, **lock**, **unlock**,
  28 **login**, **logout**, **setprefs** or **save**.
  29 預設的動作是 **browse**.
  30
  31 部份動作接受其他參數.
  32
  33 **FullTextSearch**, **TitleSearch**:
  34
  35   接受 **s** 表示欲搜尋的字串, 而 **size** 表示輸入的長度.
  36
  37 **edit**:
  38
  39   接受 **version**.
  40
  41 **remove**:
  42
  43   接受 **verify**.
  44
  45 **save**:
  46
  47   接受 **editversion**, **minor_edit**, 和 **content**.
  48
  49 **setprefs**:
  50
  51   接受 **edit_area_width**, **edit_area_height**.
  52
  53 === Writing Magic Links in Wiki Pages
  54
  55 一個 magic 連結看起來會是:
  56
  57 <pre>
  58 **~[** ''text'' **|** ''phpwiki-url'' **]**
  59 </pre>
  60
  61 "''text'' *|*" 是可選的,但通常建議使用. 如果給了,他會為此連結提供標籤.
  62
  63 _phpwiki-url_ 就如同上面描述的一樣,是一個 *phpwiki:* URL.
  64
  65 ==== Some examples
  66
  67 {{{
  68 [ Edit the SandBox | phpwiki:SandBox?action=edit ]
  69 }}}
  70 將會產生一個連結,而他將會直接引領你去編輯 SandBox, 像是:
  71 [Edit the SandBox | phpwiki:SandBox?action=edit].
  72
  73 其他可能的用法:
  74 * [ Diff the SandBox | phpwiki:SandBox?action=diff ],
  75 * [ Lock the HomePage | phpwiki:HomePage?action=lock ],
  76 * [ Get a Full Zip Dump | phpwiki:?action=zip&include=all ],
  77 * Search for [ Page titles containing 'wiki' | phpwiki:?action=TitleSearch&s=wiki ]
  78
  79 === Writing Magic Forms in Wiki Pages
  80
  81 ''**Note**: 舊的 Magic forms 語法將不再支援.
  82 他們需以 =<?plugin-form>= 代替.''
  83
  84 If the plugin is called using *<?plugin-form* instead of *<?plugin*
  85 and the plugin supports searching, then it will be rendered as a form.
  86
  87 ''size'':
  88
  89   If given, specifies the size of the input area.
  90
  91 ''s'':
  92
  93   Specifies the default value for the input.
  94
  95 ==== Examples:
  96
  97 A search plugin invoked with *<?plugin* instead of *<?plugin-form*
  98 simply inserts the search results of the plugin:
  99
 100 {{{
 101 <<TitleSearch s=wiki noheader=true >>
 102 }}}
 103
 104 Search results for Page titles containing 'wiki':
 105
 106 <<TitleSearch s=wiki noheader=true >>
 107
 108 {{{
 109 <?plugin-form FullTextSearch ?>
 110 }}}
 111
 112 gives
 113
 114 <?plugin-form FullTextSearch ?>
 115
 116 While
 117
 118 {{{
 119 <?plugin-form TitleSearch formsize=12 ?>
 120 }}}
 121
 122 yields
 123
 124 <?plugin-form TitleSearch formsize=12 ?>
 125
 126 <noinclude>
 127 ----
 128 [[PhpWikiDocumentation]]
 129 </noinclude>