:i/プロトタイピング の変更点

• 追加された行はこの色です。
• 削除された行はこの色です。
• :i/プロトタイピング へ行く。
• :i/プロトタイピング の差分を削除

RIGHT:[[:t/プロトタイピング]] [[:t/実装]]

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

----------

#contents

*** どこから実装するか [#y96d4987]
MV*のモデル層の責務分担と構造（依存関係と多重度）から。でもXのモデルはページとページ/要素ぐらい。
その後は自由に、思いついた順に。
実現可能かはいつでもサンプルを作成して確認。


**プロトタイピング/05 [#k2612436]
***やること [#c8dac453]
- ページの永続化と復帰
→ [[フレームワーク/WikiEngine]]
ページ/名前が必要。
- ページ/名前
X/Pages/Name
外部名4区分と内部名、順不同パス（4区分中の"Entry"）
- [[ビュー]]と[[テンプレート]]
WikiEngineレベルでのビュー。
ページ/属性が必要。
- ページ/属性
属性の継承
権限の継承
データアクセスとデータコンテキスト（属性コンテキスト）
X/Elementが必要。
- %%[[下位展開]]%%
- %%[[プレビューモード]]%%
%%セッションが必要。%%
- %%セッション%%
%%→ [[フレームワーク/Webアプリケーション]]%%
%%認証が必要。%%
- %%[[認証]]%%
- X/Element
全てURIで、セレクター（参照記法）
-- Tokenize
-- 汎用記法%%、見出しに自動リンク%%



- [[:i/プロトタイピング/p05]]
*** プロトタイプ05+04+03 [#c32ec38c]
05の次。
***概要図 [#g4797979]
#ref(:Image/abstract.svg,100%)
[[docs.google.com>https://docs.google.com/file/d/0B9sAsjPbXxUHY2ZoejRIS3lkSWs/edit?usp=sharing]]

RIGHT:[[:t/コンセプト]]
***fw/Web [#c7404306]
#ref(:Image/MVC.svg,100%)
[[docs.google.com>https://docs.google.com/file/d/0B9sAsjPbXxUHdmJPc3hTR05SM0E/edit?usp=sharing]]

RIGHT:[[:t/Web]] [[:t/実装]]

***クラス構成 [#ee07f455]
#ref(:Image/p05.svg,100%)

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

fw/WebApp → フレームワーク/UserAgent
**資料 [#r6f203fe]
***フレームワーク [#hbeb9ad8]
[[:t/Web]]フレームワーク部分と、その上の[[:t/Wiki]]フレームワーク部分。
ページ/[[:t/要素]]が動く環境を作る。
ユーザーからのリクエストを対応する要素に伝えて、その結果をレスポンスに変える。
***権限 [#i5755127]
権限設定と表示。

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

[[:t/汎用記法]]で[[:t/埋め込み]]機能を呼び出して権限情報を表示。
ページとその属性名を全て[[:t/URI]]で指定・参照・ページ上にレンダリング。
***下位展開 [#l0f753b1]
[[:t/下位展開]]は複数のページをまとめて見せる機能。

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

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

ページごとに[[:t/権限]]判定と[[:t/代表]]の適用が必要。
***プレビューモード [#vf775f50]
[[:t/プレビュー]]モードは[[:t/名前]]の補完ルールに細工をすることで実現。
タイムマシンモードも同じ発想。

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

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

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

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

***実装方法 [#he0bc323]
-ページ作成フォーム記法
新規ページ作成の入力欄生成。入力受け付け、ページ生成。
とりあえず #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コ）
Compositeパターン
-閲覧時展開［Section.toHtml()］／編集時展開［Section.toWikitext()］
--権限、錠と鍵
どちらもページ属性で
錠はページ、鍵はユーザーが持つ
権限があるとき見出し＋下位の内容、権限不足時は見出しだけ。
ページ名はページ内容と編集権限が異なる。接頭辞属性を含むので。
--下位の代表見解を展開［Pagename］	・ページ属性（ページ属性記法）
属性の自動リンク［Autolink.toHtml()］
--情報配置
錠と鍵（権限）の表示は参照記法を配置して
ページ参照と関連名フィルタリングをするPageElement、それを配置

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

----------------------------------------
- Notation→ElementでPukiWikiのようにRegex1回にしないのはネストを可能にするため。Notationのネストを内側から探すのも同じNotationをネスト可能にするため。

「C#に依存するコードが増えてきましたが」
- ウィキエンジンXのページを自動リンク
**そのうちやること [#fcfe5f45]
***自動リンク [#n5ac218c]
-自動リンクルール
相対パス→絶対パス変換に一手間加えたもの。
-メタページ生成ルール




***アカウント [#s0de27cc]
-利用者のログイン／ログアウト
-アカウント管理




**フレームワーク間の関係 [#d19defef]
HTMLを要求するのはフレームワーク/Webアプリケーションのほう。
WebアプリケーションはWikiEngineを3回呼ぶ。
+エントリーポイント
+フレームワーク/Webアプリケーション
Xオブジェクトを生成。
+フレームワーク/WikiEngine
Xオブジェクトを作る（だけ）。
+フレームワーク/Webアプリケーション
Xオブジェクトにリクエストを伝える（そのまま渡すのではなく、変数の形で）
+フレームワーク/WikiEngine
自身の状態を変化させる。状態は永続化する。
+フレームワーク/Webアプリケーション
XにHTMLを要求。
+フレームワーク/WikiEngine
HTMLを生成。
+フレームワーク/Webアプリケーション
HTMLにヘッダーを付けてWebページ化。



**排他制御 [#q6171bfe]
永続化クラスを排他制御不要な方式に。

モデル系クラスでは自分で自身を書き換える。他のクラスを扱うのはPageFactoryくらい。

RIGHT:[[:t/Web]] [[:t/ロック]]

**実装からTips作成 [#h19c72ba]
実装からTips作成、よりよいコードのヒント集め。
実装以外にも、アイデア、方式、UIなどでも。


**仕様の分け方 [#k3a05217]
フレームワークは空気。ページが本体でユーザーがそれを利用できるようにするのがフレームワークの役目。

UIの内訳
1. 読みUI
ページ/履歴含む。
2. 書きUI
エディターなども。
3. 探しUI
検索の他に関連情報やおすすめの類も。
4. 組み立てUI
管理とWiki構築。テンプレートやデータコンテキストなどページ/要素を使ったプログラミング部分。

RIGHT:[[:t/プロトタイピング]]



**PageElement系クラス [#b0ce6d60]
RIGHT:[[:t/実装]] [[:t/ページ]]	

- Wikitext
処理前の文字列状態。
stringをPageElementとして扱えるようにするクラス。stringからPageElementツリーを作るクラス。 @done
- Document
1ページに1つだけ。PageElementツリーのルート要素。
- Notation系
-- Nestable系 @done
中に他のPageElementを含むことができる。 @done
- Autolink
自動リンク。Plaintextを含む。
- Plain系
Plaintextを末端とするネスト構造。Plain系のなにか→Plain系のなにか→Plaintext。
Plaintextは別。PageElements構造の末端。


**ページの設計 [#r92e4bf8]
 物理:
	- 領域
		テキストファイルを複数組み合わせて1ページ
		保存しなければならないのは投稿されたままのデータ
		- 表
			- 属性領域
			- 本文
		- 裏
			- 属性領域
		- 書き込みキュー
			- 1トランザクションのなかでキューをページに反映
			- 最新版
				キューを全て反映したページ
			- 現在版
				古いかも？参照用
			- キューの内容は新しいページそのもの
				差分ではなく単体で新しいページになれる。処理の単純化のため。
				反映時は全面書き換え。
 ──────────────────
 属性:
	ページの属性はただNotationを書くだけ。参照時に内容と統合されて1つのelement構造になる。書くところが分かれているだけ。
	- 裏
	- 内部名
	- 凍結
		凍結してるか？はページ/属性。
		編集不可能→編集権限を無視してどんな場合も権限なしと判断。
		凍結解除してから編集、再凍結までを一度に行うことで編集可能に見せることはできる。
		編集ビューは凍結されていても閲覧権限で見られる。
	- 不特定多数には非公開属性=特定者にのみ公開属性
		公開範囲別に複数の属性になる？
	- 隠し属性、ページ名が明示されたときに見える。
	- 古い自動生成ページを自動更新
	- 自動更新間隔。elementが更新間隔を持つ。更新はページごとなので、ページ内で最も短い間隔で自動更新。自動生成ページだけでなく一般化。
		ページの属性
	- 基本がリンクか埋め込みか。という属性。
	- 属性値を書く欄。ほかにページ名の接頭辞も属性値の一部。
 ─────────────────────
 内容:
	- 見出し始まり、無ければ自動で作る
	- ページの分割、統合、入れ替え支援
	- バックリンク
	- ウォッチリスト 
	- Web標準
	- 更新日時一覧には編集対象ページ（編集対象としてパラメーターになったページ）と、実際に更新されたページの両方を載せる。
できること:
	- 自分宛のクエリーを読める
	- 自分宛のクエリーはHTML出力で作る
	- 添付ファイルもページ化
	- HTMLテンプレートもページに書く
	- データベースでもある。elementクラス別のデータベースでもある。
	- サイトのアクセスログでもある。ページに記録
	- クリップボードでもある。
	- 多階層ビュー、埋め込みのネスト。html1ページはヘッダーやシステムメッセージ領域など、複数層の埋め込みでできている。
	- 存在しないページはない
	- 更新できるのは自身だけ。遅延書き込みと前バージョン参照
	- DOMアクセス
名前で3層組み合わせ:
	内部名と表示名
	項目→ディレクトリ、見解→ディレクトリ、版→ファイル
	内部名を使って
	版、見解はページの応用。
	- 代表
		ワイルドカードを使った一覧から1つ選ぶ仕組み。
	- ワイルドカードで一覧
		ワイルドカードを使った不完全な指定、で、代表を要求しない
		- 項目指定なし、つまり何にもなしのリスト要求
			全ページ一覧
			代表要求するとルート(FrontPage)
		- 見解指定なしのリスト要求
			見解一覧
			投稿できないので、一覧は表示だけ。
			代表要求すると有力見解←投票で
		- 履歴指定なしのリスト要求
			版リスト
			投稿できないので、履歴一覧表示だけ。
			代表要求すると最新版
 履歴（版だけ組み合わせ）:
	履歴はモデルに含めない。履歴はワイルドカードを使って検索した一覧。
	- 2履歴間の差分
	- 最新の差分は閲覧ビューでも強調
		クライアント側で
	- 編集履歴（差分）表示
		異なる見解の最新版比較（差分表示）も？
		通常の差分は同項目・同見解・異版間のもの。
 下位:
	- 属性の継承
		下位展開と関係ある？
	- 属性の継承、下位ページに
	- 下位展開（閲覧時/編集時）
		下位ページ展開
		- 下位ページの更新は上位の更新日時を変えない。更新日時一覧に上位ページ名も載せる。それで同じ効果。
 投票:
	見解に投票
 ─────────────────────
 Archive:
	- 複数のビュー。elementクラスごとに分ける・分けない、どれとどれが同じかなどいろいろ。 @done @project(できること)
	版、履歴: @done @project(物理 / 版、履歴 @done)
	Merge可能かどうかをインターフェイスで。: @project(Merge可能かどうかをインターフェイスで。) @done
		インスタンス生成せずに呼び出すメソッドはインターフェイス化できない。



**プロトタイピング/ [#a92d6529]
#ls