locale/zh/pgsrc/MagicPhpWikiURLs

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