:i/プロトタイピングのバックアップ(No.133)

to your Kindle

実装したものと実装のための情報。
このWikiを洗練させるための試作。
http://x.pmint.name/

プロトタイピング/05 †

やること †

フレームワーク/Webアプリケーション
 セッション（認証も）
フレームワーク/WikiEngine
ページの永続化。
フレームワーク/WikiEngine/ビュー
WikiEngineレベルでのビュー。
テンプレート（実体はページ）、下位展開。
InterWikiにつながる。
永続化のシステム
X/Pages/Name
ページ名。外部名4区分と内部名、順不同パス（4区分でのEntry）、プレビューモード
X/Element
全てURIで、セレクター記法（参照記法）、ページ/属性、権限、権限一覧の表示
「全てURIで」はInterWikiにつながる。
- X/ElementとTokenize
  汎用記法、見出しに自動リンク
  「汎用記法」は機能別プロトタイプにつながる。

注意点

認証はOpenID
検索は入っていない
入れるとしたら小検索。
自動リンクのアルゴリズム
Aho-Corasick法を試して。

概要図 †

docs.google.com

fw/Web †

docs.google.com

クラス構成 †

各クラスのプラグインは書かない。
あとはVisitorをElement周辺に付け足すだけでクラスが揃う。

資料 †

フレームワーク †

:t/Web フレームワーク部分と、その上の:t/Wiki フレームワーク部分。
ページ/:t/要素が動く環境を作る。
ユーザーからのリクエストを対応する要素に伝えて、その結果をレスポンスに変える。

権限 †

権限設定と表示。

:t/権限は「錠」と「鍵」の2種類。
:t/属性に書く。

:t/汎用記法で:t/埋め込み機能を呼び出して権限情報を表示。
ページとその属性名を全て:t/URIで指定・参照・ページ上にレンダリング。

下位展開 †

:t/下位展開は複数のページをまとめて見せる機能。

対象になるページは:t/順不同な:t/名前での下位に位置するページ。

ページ間の:t/リンクも下位展開に対応する必要がある。
まとめられたページは:t/見出しとして表示されるので、リンク先もそこへつなげなければならない。

ページごとに:t/権限判定と:t/代表の適用が必要。

プレビューモード †

:t/プレビューモードは:t/名前の補完ルールに細工をすることで実現。
タイムマシンモードも同じ発想。

まだ投稿していないページは:t/セッションに一時保存。
セッションの実体は特殊な:t/ページ。一時的ではあるが:t/永続化することになる。

プレビュー中も:t/下位展開はある。

紹介 †

相変わらずページの保存が出来ないバージョン。
サンプルデータとして http://wiki.pmint.name/ のページをインポートしてみた。

実装したこと †

下位展開
このシステムはページが他のページを含むツリー構造になっている。1つのページに含まれるページ階層を深い階層まで一括表示。
下位展開を利用した自動リンク先
深い階層のページは浅い階層の一部（見出し）として表示されるので、素直にはリンクしない。浅いページ/深いページ[?]を、浅いページ#深いページへのリンクに。
プレビューモード
 編集プレビュー中に他のページを開いて、編集の影響を見ることが出来る。「仮の未来」を見る機能。
タイムマシンモード
過去のある時点でのWikiを再現。「実在した過去」を見る機能。
アクセス制御
アクセスコントロール。ページ側に「錠」となる属性、ユーザー側に「鍵」となる属性を与えて随時適合するかどうか判定。適合することを各ユースケースの事前条件に。
リンク一覧
内部リンク（同一Wiki内リンク）のリンク先一覧。リンクの属性「関連名」でフィルタリング。これで「あるユーザーが閲覧できるページ一覧」と「あるページを閲覧できるユーザー一覧」を生成。
記法は特に考えず#links(リンク先のほう|リンク対象テキストのほう|全部)

そのほか †

multi-gram
自動リンク処理で行なっていた”bi-gramを使ったページ名探索”。連続する2文字をインデックス化していたが、数字列では1つのキーに集まり過ぎ、漢字を使う単語では分散し過ぎだったので、文字種により0文字から3文字を使うよう変更。

実装方法 †

ページ作成フォーム記法
新規ページ作成の入力欄生成。入力受け付け、ページ生成。
とりあえず #newpage()
［Notationsにクラス作成］
自動リンクの下位展開対応［Autolink］
```
/ページ名#セクションID
```
リンク対象文字列が /セクション名/ページB/ページA ならリンク先は /ページA/ページB#セクションID
```
/ページ名#セクションIDでもリンク対象になるように。リンク先をコピペしてもリンクするように。
```
ページ名を4区分に［Pagename］
Wiki, Entry, Side, Revision
- 代表
  4区分それぞれに補完ルールがある
  Wiki
  Entry
  Side
  Revision
- 内部名、メジャーIDになるのはEntryだけ（ユーザーが指定するので）
  ［Pagename］
  PageFactoryで扱うのは内部名
- 下位展開
   セクション記法（見出し記法、ページタイトル記法）［PageElement、ページ生成時］
  とりあえず /^==/
  セクション記法はページのもの。セクションのものではない。
ページ→ページ（→セクション0〜1コ）
Compositパターン
閲覧時展開［Section.toHtml()］／編集時展開［Section.toWikitext()］
- 権限、錠と鍵
  どちらもページ属性で
  錠はページ、鍵はユーザーが持つ
  権限があるとき見出し＋下位の内容、権限不足時は見出しだけ。
  ページ名はページ内容と編集権限が異なる。接頭辞属性を含むので。
- 下位の代表見解を展開［Pagename］・ページ属性（ページ属性記法）
  属性の自動リンク［Autolink.toHtml()］
- 情報配置
  錠と鍵（権限）の表示は参照記法を配置して
  ページ参照と関連名フィルタリングをするPageElement、それを配置

プレビューWiki
［Pagename、Wikiを明示指定］
Previewモード
指定されたWikiにページが無ければ、デフォルトWikiのページを使う。
デフォルトWikiにも無ければ、指定されたWikiでページが存在しない処理。
タイムマシンWiki
［Pagename、版の補完方法で］（プレビューとは実装方法が違う）
Back way to ... モード
日時指定→版の補完時に版番号に置き換え
日時指定用のUI: 版の中から選択、あらかじめページ名と見解が指定されていないと
ページ(Entry)が無ければ、普通にページが存在しないときの処理。