YaPw

 <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今後の予定 ToDoリスト 要望書き込みも可
    * AtWrite わかりにくさ爆発のBBS化機能について
    * YaPw導入メモ
    * YaPwのバージョンアップ
    * YaPw使い方あれこれ ドキュメントがぜんぜん未整備なのは正しくない怠惰のせい
    * [署名設定]
 
 
 @ YaPw
-"Yet another Perl wiki"の略。
+"Yet another Perl wiki"の略。WikiEngineの一種。
 <small>あるいは、「<b>や</b>りすぎPerl wiki」の略でも可。</small>
 
-@ とりあえず使ってみよー
-左側か上側に、YaPwのツールボックスが出ているはずだ。こいつが操作の中心。
-
-@@まずは署名の設定。
-ツールボックスに「署名設定」と書いてあるボタンがある。
-そこの上だか左だかのボックスのsomebodyと出てるところを好きな名前に書き換えて「署名設定」ボタンを押す。
-
-@@次はページの編集。
-[れんしゅう]←これをクリックして、それからツールボックスの「編集」をクリック。
-そうしたら書き込み画面が出てくる。ボックスの中のテキストを好きなように編集して「書き込み」すればOK。
-[れんしゅう]に編集した内容が表示されてる、だろ？
-
-こんなふうに、どんなページも書き換えられちゃうツール、こそがWikiだ。
-そいでもって、その特徴をきわだたせるのがWikiName。
-
-@ WikiName？
-Wiki最大の特徴だ。"WikiName"みたいに、大文字から始まる単語二つ以上をくっつけたものが、自動的にページ＆リンクになっていく。
-
-@ でも
-日本語だと、WikiNameみたいな芸当はできない。"ウぃきネーむ" なんて書き方は電波入ったみたいだし、書きにくいし、読みにくい。漢字交じりだったら"カん字ナ前"とかになるのはもっと嫌だ。
-
-@ そんなわけで
-みなさんあれこれ苦労されておるらしい。日本語の場合には[[日本語の名前]]みたいな感じとかで。
-
-@ だけども
-YaPwではもっと素直に、明示的に「記事名」を入れさせればいいや、と考えた。
-ツールボックスの「板追加」のところで新しいWikiNameを登録できるようになってる。
-
-あとは、本文中に[新記事名]と書いても、WikiNameとして認識される。
-難しく言えば、「WikiNameパターンマッチ + 最長パターン一致」って感じ。既にある名前は勝手にリンクになる(AutomaticLink)し、本文書きながら適当に[]でWikiNameの追加もできる。賛否両論あるとこだけど、ともかくYaPwはそういう方針。
-
-@ そのほかのYaPwのとくちょー
-@@ページをファイルシステム上で管理
+@ 特徴
+@@ページ・メタデータをファイルシステム上で保持・管理
 他のWikiと比べたときの、大きな特徴。
  *利点
   * findだとかgrepだとかUNIXなツールとの親和性が高い
   * データが壊れても力技で修正しやすい
  *欠点
-  * 遅い。ファイルIOが多くなるので間違いなく遅い。しかし悪いのはファイルIOごときでくじけるOSなのだ(DJB的論調)。
+  * 遅い。ファイルIOが多くなるので間違いなく遅い。
+    * しかし悪いのはファイルIOごときでくじけるOSなのだ(DJB的論調)。
 
-@@Perl以外のインストールを要求しない。
+@@特定の環境においてインストールが異常に楽
 モジュール依存性はほとんどないし、ごく一部の必要なファイル類はまとめて同梱されている。
-だからアーカイブを展開 or CVSからcheckoutして設置すれば、それでだいたい動いちゃう、はず。
+環境にもよるが、アーカイブを展開 or cvsからチェックアウトしてディレクトリを一個掘るだけで動作するように意図している。
+'no config is best config' が目標。
 
-@ どう書くの
-ふつーにテキスト書くみたいにへれへれ書くと、結構勝手に整形します。それから、一部htmlのタグが通ったり。通すタグは設定ファイルで決められます。標準の設定だと、以下のタグが通ったり。
+@@システム管理用のインターフェースを持たない。
+システム管理はシステム管理者っぽいインターフェースで、ということで、ファイルシステム上のコンフィグファイルやテンプレートファイルを直接エディタで書き換えて、という方針。
+自前でセキュリティ実装をしなくて済むし、セキュリティ強度はOS全体の強度に依存する。
+
+@@HTMLの記述を使える
+Wikiっぽい文法も備えているが、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流。