YaPw

-<small>YaPwソースコードにて、ソース公開中。YaPw修正情報にて、アーカイブ配布中。</small>
+<blockquote>
<div style='font-size:75%'>
        [配布/履歴,YaPw修正情報]\
        [BBS,AtRandomBBS]\
ヘルプ:[導入,YaPw導入メモ]\
        [設定,yapw.conf]\
        [UpDate,YaPwのバージョンアップ]\
        [隠し機能,YaPw:隠し機能]\
機能:  [BBS機能,AtWrite]\
        [名前空間,YaPw:名前空間]\
        [署名設定]\
Tips:  [Tips,YaPw使い方あれこれ]\
他:    [ライセンス,YaPwやりすぎライセンス]
</div>
</blockquote>
+<hr>
 
 関連ページ：
    * YaPw修正情報 ChangeLogとも言う
    * [yapw.conf] YaPwの設定ファイルについて説明
-   * YaPwソースコード どうかと思うソース公開っぷり
    * YaPw今後の予定 ToDoリスト 要望書き込みも可
    * AtWrite わかりにくさ爆発のBBS化機能について
    * YaPw導入メモ
+   * YaPwのバージョンアップ
    * YaPw使い方あれこれ ドキュメントがぜんぜん未整備なのは正しくない怠惰のせい
    * [署名設定]
 
 
 @ YaPw
-"Yet another Perl wiki"の略。
-<small>あるいは、「<b>や</b>りすぎPerl wiki」の略でも可。まだあんまりやりすぎてないので実情にはそぐわないけど。</small>
+"Yet another Perl wiki"の略。WikiEngineの一種。
+<small>あるいは、「<b>や</b>りすぎPerl wiki」の略でも可。</small>
 
-@ とりあえず使ってみよー
-一番上の部分が肝心だ。
+@ 特徴
+@@ページ・メタデータをファイルシステム上で保持・管理
+他のWikiと比べたときの、大きな特徴。
+ *利点
+  * findだとかgrepだとかUNIXなツールとの親和性が高い
+  * データが壊れても力技で修正しやすい
+ *欠点
+  * 遅い。ファイルIOが多くなるので間違いなく遅い。
+    * しかし悪いのはファイルIOごときでくじけるOSなのだ(DJB的論調)。
 
-まずは署名の設定から。
-一番上、「署名設定」と書いてあるボタンの左のボックス(たぶん"somebody"と出てるはずだ)のところを好きな名前に書き変える。で、「署名設定」ボタンを押す。
+@@特定の環境においてインストールが異常に楽
+モジュール依存性はほとんどないし、ごく一部の必要なファイル類はまとめて同梱されている。
+環境にもよるが、アーカイブを展開 or cvsからチェックアウトしてディレクトリを一個掘るだけで動作するように意図している。
+'no config is best config' が目標。
 
-今度は書いてみよう。
-[れんしゅう]←これをクリックして、それからやっぱり一番上、「編集」ってところをクリック。そしたらなにやら書き込み画面が出てくるよね？ これを好きなように編集して、「書き込み」すればOK。[れんしゅう]に戻って、編集した内容が表示されてる、だろ？
+@@システム管理用のインターフェースを持たない。
+システム管理はシステム管理者っぽいインターフェースで、ということで、ファイルシステム上のコンフィグファイルやテンプレートファイルを直接エディタで書き換えて、という方針。
+自前でセキュリティ実装をしなくて済むし、セキュリティ強度はOS全体の強度に依存する。
 
-こんなふうに、どんなページも書き換えられちゃうツール、こそがWikiだ。
-そいでもって、その特徴をきわだたせるのがWikiName。
+@@HTMLの記述を使える
+Wikiっぽい文法も備えているが、HTMLをベタベタと書いても適当に扱ってくれる。
 
-@ WikiName？
-Wiki最大の特徴だ。"WikiName"みたいに、大文字から始まる単語二つ以上をくっつけたものが、自動的にページ＆リンクになっていく。
-
-@ でも
-日本語だと、WikiNameみたいな芸当はできない。"ウぃきネーむ" なんて書き方は電波入ったみたいだし、書きにくいし、読みにくい。漢字交じりだったら"カん字ナ前"とかになるのはもっと嫌だ。
-
-@ そんなわけで
-みなさんあれこれ苦労されておるらしい。日本語の場合には[[日本語の名前]]みたいな感じとかで。
-
-@ だけども
-YaPwではもっと素直に、「記事名」入れさせたらよかんべよ、とか考えた。だから、上の部分、「板追加」のところで新しいWikiNameを登録できるようになってる。それから本文中に[新記事名]とか書いても、WikiNameとして認識される。
-難しく言えば、「WikiNameパターンマッチ + 最長パターン一致」って感じ。既にある名前は勝手にリンクになっちゃうし、本文書きながら適当にWikiNameの追加もできる。賛否両論あるとこだけど、ともかくYaPwはそういう方針。
-
-@ そのほかのYaPwのとくちょー
-めんどくさい「実装」とやらの話になるのだけど、「ページをファイルシステム上で管理」してる点がなによりの特徴だ。だからfindだとかgrepだとかUNIXなツールとの親和性が高いし、Perl以外のインストールも要求しない。
-(Algorithm::Diffモジュールを必要としたりもするけど、配布物に同梱されてたりする)
-
-あとは皆様の御要望次第、ってとこかな。ちうことで御要望などございましたら、YaPw今後の予定へどうぞ。
-
-@ どう書くの
-ふつーにテキスト書くみたいにへれへれ書くと、結構勝手に整形します。それから、一部htmlのタグが通ったり。通すタグは設定ファイルで決められます。標準の設定だと、以下のタグが通ったり。
+標準の設定だと、以下のタグが通る。
 a, em, strong, cite, dfn, code, samp, kbd, var, abbr, acronym, sub, sup, pre, address, tt, i, b, big, small, span, blockquote, ins, del, p, img, br, hr
-プレビュー機能とかはついてないけど、すぐ再編集できるから、怖がらずに書いてみるのをお勧めするぞ。
 
-@ 自分のところで使いたい！
-YaPw修正情報が配布ページにもなってます。配布アーカイブだけで動くことを目標にしてるので、.htaccessが使えるところなら、それなりに使えるかと思います。
+@@ 自由名称 + WikiName + AutomaticLink
+Wikiっぽさの根源である、ページのリンク機能については、
+ * 本来のWiki最大の特徴である"WikiName"。
+ * 日本語の事情を考えた安易な自由名称形式(左だか上だかにあるツールボックスの「板追加」欄)
+ * 既にある名前を勝手にリンク化する(AutomaticLink)
+   * 難しく言えば、「WikiNameパターンマッチ + 最長パターン一致」
+というあたりの合わせ技。
+
+@自分のところで使いたい！
+YaPw修正情報が配布ページにもなってます。配布アーカイブだけで動くことを目標にしてるので、.htaccessが使えるところなら、それなりに使えるはず。
 
 @ ところで "YaPw" の発音は？
 任意。なにごともやりくちは一つではないのがPerl流。