nDiki : WiKicker/Wiki URI

概要

WiKicker では WikiPage へのアクセス URI として

• path 形式の URI
• URI query component を使用する形式の URI

を提供する。

例えば NaneyOrgWiki 上の ABC/DEF というページは

 http://www.naney.org/wiki/ABC/DEF.html
 http://www.naney.org/wiki?ABC/DEF

という URI でアクセスする事ができる.

前者の見なれた形式の URI は、アクセスする多くの人にページが安定して存在する事を期待させる。

後者の明示的にパラメータを与えた形式のURIは、InterWiki するのに容易な形である。 また、通常の閲覧者も既知の WikiPage へ WikiEngine のURI (ここでは http://www.naney.org/wiki) に ?PageName をつけるだけで簡単にアクセスする事ができる(もっとも日本語 PageName の場合はエスケープが必要で容易ではないが)。

URI に乗せる必要のある情報

• PageName
• action (read、edit、diff、 search……)
• option (search のオプション等)
• format (option といえば option)

read action のURL は可能な限りシンプルに。

URI体系

URI query component 形式

いわゆる QUERY_STRING 環境変数で得られるパラメータで指定する方法

• query component に &、 = が含まれていなければ、query を PageName とする
• query component が application/x-www-form-urlencoded 形式であった場合
  • (a) コントロール名 action があれば、コントロール名 name を必須とする。
    • action の値がアクションを表す。
    • name の値が対象ページ名を表す。
  • (b) コントロール名 action が無く、(read,edit 等の)アクションを表すコントロール名があればそれをアクションとし、値を対象ページ名とする。
    • コントロール名 name はあってはならない。
  • WiKicker は (a) の方を主に使用する。(b) は syntax sugar。
  • その他のコントロール名は、動作のオプションを示す。

• PageName が PseudoPage を表している場合、action とオプションはそれぞれの、PseudoPage によって定義される。
• 各アクションのオプションコントロール名は、action名.オプション名 とする。

• (b) で使用できる予約済みアクションは今のところ以下のもの
  • read
  • edit
  • search
  • rlog
  • diff

path 形式のURI

いわゆる PATH_INFO 環境変数で得られるパラメータで指定する方法。

PATH_INFO に拡張子があれば、その部分は format 指定とし、その拡張子をとったものをPageNameとする。拡張子がなければ、path を PageName とし、format はデフォルトの HTML が指定されたものとする。

PATH_INFO の最初の / (スクリプト名の直後の /)は取り除かれる。

path 形式で、さらに URI query component がある場合、

• (a) application/x-www-form-urlencoded 形式 であれば、それらをパラメータと見なす。コントロール名に action があれば、その値がアクションを表す。
• (b) そうでない場合は、その値をアクションと見なす。

WiKicker は HTML 形式の read actionでは積極的に path 形式 URL を使用する。