nDiki : Wiki

WiKicker HTML 検索 WikiPage Perl DiKicker Web メール インストール 社内 Blog Blog 開発 文法 NaneyOrgWiki メモ ロック nDiki www.naney.org ソフトウェア データベース URL 日記システム 日記 WikiName URI ミーティング InterWiki 情報発信 reStructuredText 自動リンク

■ 私が情報発信を勧める理由

「社内 Blog」をまわりのスタッフに勧めているのだけれど、

• 「やってみてメリットを感じている人」
• 「とりあえず(私に)勧めらたので書いてみてくれている(のかな?)という人」
• 「Blog という形態にメリットが感じられないので、やる気がしない人」

と様々だ。

話を聞いているなかで、情報発信のメリットやポイントについて自分でも整理してみたくなったので思うところを列挙してみた。

• あなたが発信すれば、あなたにも発信してくれる。
• 発信のための「とりまとめ」や「書き出す」という作業は、自分の中での理解を深めることにつながる。
• 迅速に。情報の多くは時間とともに価値が下がる。
• 送り手ではなく受け手が選別する。
• 「受け手は知っているはずだから」と遠慮しない。実は知らないということも多い。
• Web ページ・Wiki・Blog・あるいは張り出しなど、うまくメディアを選ぶ。
• 情報発信そのものよりも、その情報でいろいろな事が良くなること(生産性の向上など)が重要。

すぐに思い受かんだ点はこんなところ。

どれもすでにいろいろな人に語られているようなものであり、やってみれば実感できるものである。

人のためのようで、一番自分のためだったりするのが情報発信。

[ アウトプット主義 ]

• すべての情報を共有する。情報閲覧者が判断する。 (2006-05-15)
• 新幹線でウェブ進化論を読み終えた (2006-05-25)
• Hyper Estraier で社内 Web コンテンツ検索 (2006-06-01)
• スピードハックス 仕事のスピードをいきなり3倍にする技術 (2007-02-04)
• キックオフミーティング2日目 (2004-10-26)

■ Wiki ではロボット除けをしてはいけない

昨日土曜日から nDiki を含め www.naney.org のアクセス数が激減している。 Google Analytics でみてみると先週の半分以下。 細かくみてみると Google 経由のアクセスが 3分の1になっている。

Google で検索してみると今まで上位であった検索結果がことごとくランク外に。 先週土曜日に行った検索エンジン対応のための一部ページへの robots メタタグの追加とそれらのページへのリンクへの nofollow の追加が裏目に出たらしい。

Wiki の過去のリビジョンのページや編集ページなどが予想以上にサイト全体の PageRank を下支えしていたようだ。

あわててこれらの設定を外す。

元に戻るにはまたそれなりにかかるだろう。 ショック。

[ SEO ]

• Google Analytics のデータからよく検索されるキーワードを表... (2007-12-18)
• 「ほぼ日手帳 2006」でトラックワードα版プチコンテスト1位 (2005-12-14)
• Google での順位はだいたい1週間ぐらいで反映される (2007-01-29)
• Linux で使えるデスクトップ検索ツール Beagle でローカルファイ... (2006-08-08)
• Debian GNU/Linux に Hyper Estraier 1.2... (2006-05-31)

■ Google での順位はだいたい1週間ぐらいで反映される

1月20日から激減していた Google 経由でのアクセス数が昨日あたりから回復してきており、今日には以前の状態にかなり戻ってきた。 落ち込んでいたのは約9日間だったという感じ。

Wiki に <meta name="robots" content="noindex,nofollow"> をつけてから検索結果に反映されるようになるまでと、それをまた外してから結果に反映されるようになるまでと、どちらもだいたい1週間ぐらいということか。

落ち込む時よりも回復の方が時間がかかると思っていたのでこれはちょっと意外な気もしたけれど、まずは戻って一安心。

[ SEO ]

• Wiki ではロボット除けをしてはいけない (2007-01-21)
• [ WiKicker ] 憧れのサイドバー (2004-01-23)
• 今日のさえずり - アダルト版 mixi ってしってますか? (2007-12-17)
• Debian GNU/Linux に Hyper Estraier 1.2... (2006-05-31)
• 「ほぼ日手帳 2006」でトラックワードα版プチコンテスト1位 (2005-12-14)

■ WiKicker でソフトウェアかんばん

情報カードベースでソフトウェアかんばん(ストーリーカード + タスクカード)を作っている開発プロジェクトがあるのだが作ったっきりあまり活用されていないので、今回は試験的に WiKicker による Wiki 上でかんばんを作ることにした。

まだ荒削りだけれども、まずはとにかく以下のルールで始めてみる。

@ ルール

@ カードの作り方

基本的には 1カード毎に WikiPage を作るようにする。 ページ名はストーリーカードを表す SC と 状態 (TODO / DOING / DONE) を含む名前にする。

• SC/TODO/<ストーリー名>
• SC/DOING/<ストーリー名>
• SC/DONE/<ストーリー名>

タスク名も同様に作る。

• TC/TODO/<ストーリー名>
• TC/DOING/<ストーリー名>
• TC/DONE/<ストーリー名>

カードの内容は XP で扱っている内容で。 新規作成が楽なようにテンプレートページを作っておき、これをコピーして作れるようにしておく。

@ 状態変更

TODO -> DOING -> DONE という状態変化にあわせて、WikiPage 名を変更してページを移動させる。

 例:
 TC/TODO/名前をつけて保存メニューを追加
   |
   V
 TC/DOING/名前をつけて保存メニューを追加
   |
   V
 TC/DONE/名前をつけて保存メニューを追加

@ 一覧ページの作成

SC/TODO、SC/DOING、SC/DONE、TC/TODO、TC/DOING、TC/DONE ページを作りそれぞれに、子階層の一覧を表示させる (WiKicker の [[index:child]] を使用)。

@ 参照

タスクカードからは「SC/<ストーリー名>」という名前で、ストーリーカードへリンクさせる。

WiKicker では「SC/<ストーリー名>」というページない場合、「SC/*/<ストーリー名>」というページを探してリンクしてくれる。この機能のおかげで、状態にあわせてページ名を変更してもリンクはそのままで追従してくれる。

@ 担当者

担当者が割り当てられて実行中のタスクカードには [[DOING:担当者名]] という文字列を記述しておく。

「DOING:担当者名」で検索することで、各担当者が何を実行中なのかリストアップすることができる。また DOING: を「DOING:担当者名」を検索する Wiki 自身への InterWiki として定義しておくことで、この記述自体を検索結果へのリンクとすることができる。

• Google ドキュメントでソフトウェアかんばん (2008-03-30)
• ソフトウェアかんばん (2005-10-28)
• [ WiKicker ] 憧れのサイドバー (2004-01-23)
• 京大式カード (2005-10-26)
• Wiki考 (2002-09-20)

■ WiKicker / DiKicker の AutomaticLink 長を可変にした

「が」や「は」など頻出する文字の WikiPage を作ってしまった場合、それらに対して自動リンクが働いてしまうと大変なことになるので、WiKicker では2文字以上のみ対象とするようにしていた。

しかし nDiki を書いていて、1文字のキーワードも自動リンクしたいという風に思えてきていた。 誰でも書ける Wiki の場合には危険で制約が必要だけれど、全てのキーワードが著者のコントロール化にある DiKicker では1文字のキーワードに対して自動リンクが働いても問題ないだろう。

ということで自動リンクが働く最低文字列長をプロパティで設定できるようにした。 2004年ぐらいからほとんど手をつけていなかった、AutomaticLink 処理モジュールを久しぶりにメンテナンス。 もともと2文字以上を前提でコーディングしてあったので、trie 部分などが1文字できちんと動くか確認した上で、文字列長チェックを可変に修正。 WiKicker、DiKicker 両方で設定で変えられるようにした。

またあわせて、英単語の部分文字列に対して自動リンクしないようにする処理も改善。 今までは `downloaded' に対して `loaded' はマッチしないようにしていたものの、'download' はマッチしてしまっていた。 このあたりを改善。

• [ WiKicker ] 複数のキーワード集合による、AutomaticLink (2004-02-07)
• [ WiKicker ] 自動InterWiki (2004-02-09)
• WiKicker に Flickr 関連機能追加 (2005-02-11)
• WiKicker に JSON でのページ出力機能を追加 (2007-04-03)
• DiKicker に grep 検索機能を追加 (2007-02-02)

■ WiKicker に JSON でのページ出力機能を追加

最近は DiKicker ばかりに手を入れていたが、久しぶりに WiKicker の改良も行っている。 しばらく前から実装を始めていた JSON 形式での出力機能が今日完成。

今までは WikiPage について

• HTML 形式による出力
• Wiki 文法で書かれている生テキスト形式による出力

という2つの出力形式を持っていたので、JSON が加わることで3つめとなる。

@ サーバ側で WikiPage の構文解析まではやる

クライアントサイドの JavaScript でページの内容に合わせて様々な処理をできるように、サーバ側で構文解析まではしてあげるというのが主な目的。

JavaScript でまたパーサを書いてメンテしていくのも大変なので、その部分はサーバでやってしまおうかと。 構文解析した結果の解析木を JSON 形式で返して、JavaScript 側であとはお好きにという形。

@ CPAN にある JSON モジュールを使用

サーバ側の Perl プログラムには、構文解析をして解析木を作れるようになっている。 この解析木から Visitor パターンで JSON 形式を生成していく。

依存モジュールを増やすことを避けるべく、最初は自前で JSON 形式に変換していこうと思ったのだがやっぱり面倒だった。 ということで CPAN にあるモジュールをチョイス。

JSON 関連では JSON、JSON::Syck、JSON::PC などがあるが今回はインストールのしやすさを考えて pure Perl モジュールとして実装されている JSON を採用することにした。

Visitor クラスで解析木を無名ハッシュ/無名配列のツリーに変換して、JSON モジュールに流しこめば OK。

 use JSON;
 my $json = JSON->new(pretty => 1);
 my $js = $json->objToJson($tree);

WiKicker のフレームワークにはフォーマット別に出力を切り換える機構があるので、これに JSON を追加して application/json で送るようにして完成。

ちなみに残念ながら JSON 1.07 は Perl 5.005_03 では make test が fail するので、NaneyOrgWiki では使えない。

• Rubric でプライベート SBS を立てるも 0.140 では日本語に不具合 (2006-07-22)
• [ WiKicker ] hell mode - HTMLタグ付けブロックの導入 (2005-09-13)
• WiKicker の Makefile.PL を Module::Inst... (2006-02-10)
• 野良パッケージと依存 Perl モジュールのインストールセット を CPA... (2006-02-12)
• 定型書式で内容を記述していくのに便利な形式は? (2005-11-21)

■ 無制限 HTML タグ付けブロックを使って nDiki に Google Maps を貼る

Google Maps が ID を取得しないでも簡単に自分のサイトに貼れるようになった。 Google Maps で表示される HTML コードをページに埋め込めば、好きな場所の地図を貼ることができる。 これは嬉しい。

早速 nDiki でも貼りたい。

しかし WiKicker という WikiEngine をベースとした DiKicker を使っている nDiki では、現在のところ直接 HTML コードを使えるようにしていないのである。

「HTML タグ付けを許すのは嫌」というスタンスできたのだが、他のサービスを貼るという魅力にはやはり勝てないな。 HTML 直書きを許すのは大局的にはデータ活用性などで好ましくない部分もあるが、各種サービスを活用できないで利用価値が下がるのは本末転倒なので、わかった上で使うということで。

ということで nDiki で HTML タグ付けブロック機能を有効に設定。

ちなみに現行では HTML::Scrubber ベースで、使えるタグ・属性に制限をつけるフィルタしか用意してなかった。これだと Google Maps のコードがそのまま貼れない。 ということで「DiKicker」および「書く人が限定されているような Wiki」での利用を想定した無制限にスルーするフィルタモジュールを新規追加。

これで Google Maps を貼れるようにした。

では早速。

• [ WiKicker ] hell mode - HTMLタグ付けブロックの導入 (2005-09-13)
• [ WiKicker ] form/list の paragraph から... (2003-05-03)
• WiKicker に JSON でのページ出力機能を追加 (2007-04-03)
• [ DiKicker ] インデックス作成は別プロセスで (2004-02-17)
• Debian GNU/Linux に Hyper Estraier 1.2... (2006-05-31)

■ 最近の Twitter ステータスを nDiki 「最近のさえずり」ページに自動表示

11月9日から「Twitter ステータスを nDiki サイドバーに表示」しているのだが、それで使っているスクリプトにちょっと手を加えて「最近のさえずり」という nDiki ページを自動生成/更新するようにした。

サイドバーは RSS フィードと同じく最近の20件を表示するのに対し、最近のさえずりページには数日分表示するようにした。

ここ最近は Twitter のステータスをとりまとめて、ライフログ的に nDiki に上げているのだが、今までは Twitter Web ページやサイドバーの部分から手作業でコピーして日時やリンクを整形していたので面倒であった。

今回の(30分毎に)自動更新するページは最初から WiKicker / DiKicker 用の Wiki 文法で出力している。 なので、これからはこの自動生成ページから必要なものだけを抜き出して貼り付ければよい。 これで楽ちんになるはず。

ほぼ自分用。自己満足。

• 社内 Blog 開設 (2006-05-16)
• Twitter ステータスを nDiki サイドバーに表示 (2007-11-09)
• mixiに登録 (2004-11-19)
• はてなブックマーク上の検索結果を nDiki に (2005-10-30)
• WiKicker に JSON でのページ出力機能を追加 (2007-04-03)

■ ケータイ用にプライベート Wiki を設置

パケ・ホーダイを契約してから、MovaTwitter・RTM・モバイル Gmail などで携帯電話を活用するようになった。そんななか、決定打がないのが、ノートアプリケーション。電車の中などの隙間時間に、この nDiki の 下書きなどはケータイでできるようにしたい。

Google ドキュメントが使えればいいが、前年ながらまだiモードでは使えない。 メールベースでやる手もあるが、メモには良いものの再編集を繰り返したいようなものに難がある。

ということで自前でプライベート Wiki を立てそこに書き込んでみることにした。

@ iモードから WiKicker

使う WikiEngine はいつも通り自作の WiKicker。

書き込んだテキスト内のキーワードを nDiki へ自動リンクさせることができるので、パーソナルナレッジベースとして自分にとっては一番便利。書式も同じなので、Wiki に書いた下書きを、そのまま nDiki で使える。

肝心のケータイからの書き込みだが Ajax 等凝った技術を使っていないおかげで、問題なく FOMA 端末(D703i)からiモードで読み書きできた。WiKicker は UTF-8 でページを出力しているが、網側か端末側の処理かは知らないが今のところ問題なし。

なお認証は簡単に Basic 認証で済ますことにした。 安全とは言えないがそれほど重要なデータを置くわけではないしいいかな。 cookie は必要ないし WikiEngine に手を入れなくてもよいので、すぐできるのはコレ。

ユーザ名とパスワード付きのトップページ URL を端末でブックマークしておけば1発でアクセスできる。

@ Google Mobile Proxy 経由で使う

これでケータイ(と PC)から使えるプライベート Wiki を設置できたわけだが、なにぶんもともとケータイをサポートしている WikiEngine ではないため、長いページの分割機能などはないのがちょっと不安。PageName で生成される URL が長くなった時の振る舞いもちょっと不安。

そこで Google Mobile Proxy (http://www.google.co.jp/gwt/n) 経由で Wiki を使うことにした。 ページを携帯端末向けに変換してくれる proxy で、Basic 認証もできるしフォーム の POST もできる。

Google Mobile Proxy 経由で見たページ内のリンク先も全て自動的に proxy 経由になるので、 PC 向け Web ページの URL を書いておけばそのまま携帯電話で見ることができる。

安全のためか、比較的短い一定時間立つと認証の再確認画面が表示されてしまうが、ユーザ名とパスワードを入力すれば、セッションは継続される。 テキスト編集に時間がかかってしまうと POST する時にひっかかってしまい認証の再入力がちょっと面倒だが、再認証が通れば POST リクエスト自体は有効で書き込みがロストすることはないようだ。

しばらくはこれで読み書きしてみよう。

• 半分は Twitter のためにパケ・ホーダイを契約 (2007-08-01)
• ビジネス用電話番号をマルチナンバーで追加した (2007-09-20)
• Rubric でプライベート SBS を立てるも 0.140 では日本語に不具合 (2006-07-22)
• さよなら PHS (2007-02-10)
• SO905iCS ファーストインプレッション (2008-02-16)

■ Google ドキュメントでソフトウェアかんばん

ソフトウェア開発の見える化としてソフトウェアかんばんの良さは実感しているのだが、分散開発ではさすがに「情報カードで」というわけにいかず実行しにくい。

今回の分散開発プロジェクトに向けていろいろ考えた結果、Google ドキュメントのスプレッドシートを使ってソフトウェアかんばんを遠隔共有してみようと思う。

@ 他の検討候補

TRICHORD を使ってみたいのだけれど予算の問題が。 検討したのは以下。

• TRICHORD - 本命。使ってみたいが予算が。
• Firefox + Internote (light-board.com ライク) - カード感は十分。しかし共有に難。
• 影舞用に新しくソフトウェアかんばんテンプレートを作る - 影舞を使い慣れているという点では○。ただストリーカードとタスクカードをどう扱うかが課題。
• Wiki - 以前やって失敗した。
• XPlanner - インストールと学習が手間。それと開発止まっている?
• その他 Agile Project Management Tool - カードメタファで良さそうなのはあるが、予算が。
• Google ドキュメント プレゼンテーション - 矩形をカードにしようとしたが文字は別オブジェクトで書かなければならず×。文字の背景を設定するというのも試したが見栄え・操作性が良くなかった。

スプレッドシートだとカードっぽさが薄れるが、共有・同時編集という点では安心して使えるし最大行数的にも OK。 一番運用しやすそうだということでこれでいくことにした。

@ スプレッドシートの作成

以下のようにスプレッドシートを作る。

• 1シート目はインフォメーションシートにする。ソフトウェア概説・かんばんルール・通信事項などを書くのに使う。
• 2シート名以降をかんばんにする。複数ソフトウェアならシートを分けてもよいかもしれない。
• かんばんシートE列の背景を「条件をに応じて変更」で本日より前だと赤くなるように設定する。
• かんばんシートF・G・H列の背景を「条件に応じて変更」で @ と書くと背景がそれぞれ赤・黄・青くなるようにする。

• ソフトウェアかんばんサンプル rev. 1

@ カードの書き方

• 各行にはストリーカードかタスクカードを書く。
• ストーリーカード行は目立つように罫線をつける。

TODO、DOING、DONE 列は1列にまとめることもできるが、ちょっとは「かんばん」っぽくなるかと思って分けることにした。

@ 運用

• カード番号は重複しないように。
• カードの状態にあわせて @ を書き換えていく。
• DOING から TODO に移る時には、開始日と担当者名を消さないで残しておく。
• 列単位でソートしないこと。
• タスクの粒度はできるだけ揃える(例えば半日～1日にする)。

@ 課題

• カードが増えた時に使いにくくならないか? 終わったカードを別シートに分けるルールなどを考える。
• タイムボックス等にあわせて並び換える時の手間。
• カード番号が手動。
• 集計について考慮していない。

• ソフトウェアかんばん (2005-10-28)
• WiKicker でソフトウェアかんばん (2007-03-01)
• ソフトウェアかんばん「見えない化」 (2006-04-10)
• 京大式カード (2005-10-26)
• 今日のさえずり - SO905iCS おそれていたほどは厚く感じなかった (2008-02-08)

■ 2008年夏の GTD 運用ツール

ほぼ日手帳使用再開したんで、GTD をサポートしているツールを久しぶりに書き出してみる。 今後は以下の体制で。

@ inbox

キャプチャツールとしてのRHODIA No.11 は使用開始(記事)以来3年ほど経つが健在。手書き時のキャプチャはこれ。 移動中で片手で入力したい時はケータイから Gmail フィルタ経由で Remember The Milk (RTM) 受信箱へ。

これらは ThinkingRock (TR) の inbox に投入される。PC に向かっている時は直接 TR へ。

@ 次の行動リスト

基本は TR 上。階層化したプロジェクトの下に直接アクションを書いておけるのが非常に便利。それと次の次の行動を一緒にプロジェクト上に inactive として作成しておくと、前の行動を完了にすると同時に自動的に ASAP にしてくれる機能がある。これのおかげで思いついた先々の次の行動を積んでおけるのでグッド。

Personal なアクション・自宅がコンテキストなアクションについては、PC レスで参照したいので今のところデイリーで TR から PDF エクスポートして A4 で印刷し手帳に挟み込んでいる。これは工夫の余地あり。

ケータイから参照できるようにするため、買い物リストは RTM に。

ルーチンワークなどのリピート系も RTM。

@ プロジェクトリスト

TR に全面的に移す予定。一部まだシステム手帳に残っている。

@待つリスト

これも TR に全面的に移す予定。一部まだシステム手帳に残っている。

@ スケジュール

Google カレンダーがマスター。

• 日時変更が容易。細かい作業予定もストレスなく入れておける。
• ケータイにリマイダメールを送れる。
• 共有/公開できる。
• 済んだイベントをログ化しておける。

という点で紙ベースより便利。

アポイントメント等の重要項目は、手書きでほぼ日手帳と同期する。 これはミーティングや自宅など PC レスでさっと確認できるようにしたいため。 同期の手間の削減と、同期漏れをないようにするのが課題。

@ いつか/もしかしたらリスト

Someday/Maybe については、指定した期日に再度通知させたい場合はやはり TR に入れておくことにしよう。 ただ、行きたい場所リストや願望的なリストは紙で眺めた方がよさそうなので、これはしばらくシステム手帳に。

@ 参照ファイル

これはそれぞれ適宜。 システム手帳に書いておいてもほとんど参照しなかった。 ケータイ用プライベート Wiki (記事)も結局使わなくなった。 TR の Reference も多分使わない。

外出先で参照する可能性のあるメモは、Gmail 上に KB (knowledge base の意で) ラベルをつけて置くようにしている。 ケータイから参照するのにはまずはこれで。

@ tickler file

tickler については今までほぼ日手帳/ダイアリーのリマインドしたい日にメモしておくことで実現していた。これは継続。

TR の Someday/Maybe からの Tickle on も確実に inbox に入れてくれるという点で良さそげなので、一部使ってみることにする。

@ システム手帳について

ほぼ日手帳復活なので、システム手帳は不要にしたい。 しかし

• 願望系いつか/もしかしたらリスト
• 目標

などの数年スパンで固定的あるいは逆に差し替えがおきるものについては、綴じ手帳だと融通がきかないのでやはりシステム手帳を潰せないんだよなあ。 これも今後の課題。

• ほぼ日手帳復帰 (2008-07-22)
• GTD Next Actions リスト用ノートをやめる (2007-07-25)
• Task Coach で GTD (2008-06-23)
• GTD 次の行動リストノートをワンサイズアップ (2007-03-19)
• ダ・ヴィンチ ジャストリフィルサイズ システム手帳で GTD (2006-05-17)