nDiki : 2005年11月下旬

■ 定型書式で内容を記述していくのに便利な形式は?

今要求仕様書を LaTeX で書いている。 要求と仕様の組をまとめて longtable で記述しているのだが、 LaTeX らしい繁雑さがあってちょっと効率が悪い。 マクロを定義すればある程度書きやすくなると思うが、それでもそこそこまでな気がする。

文書の中にレコードの並びが書けて、レコードの並びの中に文章が書きやすいそんなフォーマットはないものかなぁ。

• LaTeX + マクロ
  • 整形は綺麗。
  • 記述が繁雑になりがち。\マクロ名とか {} とか。
• DocBook
  • 仕様デカスギ
  • 以前使ってみたことがあるが、手で書くのにはしんどい。
• XML
  • 構造的な情報の表現には良いのだが、手で書くのはしんどい。開きタグも閉じタグも。
  • 普通の章節や、マークアップのルールを考えなければならない(定義するか借りてくるか)。
  • LaTeX等へのコンバータを書く必要あり。
• YAML
  • レコードの並びだけだったら良いが、文書の他の要素を一緒に書くのには適さない。
  • ある程度の構造やボリュームがあると、思ったほど手書きしやすくない。
  • YAML Perl モジュールで痛い目にあっている。

Wiki に慣れきっている自分にとっては Wiki 文法のような感じで記述できて、一部に定型レコードの並びが書けて、そこの整形ルールだけ定義してあげれば LaTeX に変換できるとかそういった感じがのものが欲しい。 定型レコードの部分は RFC822 のヘッダみたいな感じで良くで、値の部分に長めの文章を複数行で書けるものがいい。

構造化テキスト用フォーマット、あるいはWiki フォーマットをアレンジするのがいいかもしれないな。 このあたりのフォーマットは、ソーステキストのままでも充分読み易いことを意識して定義されているので書くのは楽。

• reStructuredText
  • いいらしい。
  • HTML、LaTeX、XML へのコンバータがある。
  • 拡張性も考慮されているらしい。
  • でも Python。
• Markdown
  • reStructuredText よりもソーステキストが読み易いらしい。
  • Perl
  • HTMLへの変換しかない。
• WiKicker (Wiki)
  • かなり書き慣れている。
  • レコードの並びの書き方を考える必要あり。
  • 複数行にまたがる処理を書くのが面倒。
  • 自分で書いているシステムなので中身は何でも知っている。
  • マイナー。

レコード部分とは関係ないけれど reStructuredText や Markdown の「アンダーラインのあるテキストを見出しとする」っていうのはいいな。 普段メールやプレーンテキストでちょっと文書を打つときに使っているスタイルと一緒だ。

要求仕様書用に使うかどうかは別として、要チェック。

• reStructuredText いいんじゃない? (2005-11-22)
• 早速 reStructuredText から LaTeX へのコンバータを書く (2005-11-24)
• 私的10大ニュース2005 [ comp ] (2005-12-31)
• Docutils は自分にとっての Python キラーアプリかも (2005-12-01)
• WiKicker に JSON でのページ出力機能を追加 (2007-04-03)

■ reStructuredText いいんじゃない?

昨日の続きであるが、reStructuredText がライトなドキュメント書きにはいいんじゃないかという感蝕を得た。

基本的にプレーンテキストのままで充分見られるので、そのままメールに貼りつけられる。

今までは文書を作成する際、メールで草稿をやりとりしたのち内容が固まったら LaTeX のコマンドでマークアップしてコンパイルしてPDF化していた。 これだとちょっと手間であるのだが、最初から reStructuredText 形式で書いていれば、そのまま rst2latex で LaTeX に落とせる。

また必要に応じて rst2html で HTMLに変換してWebサイトに置いておくこともできる。

これらで満足できない場合は Python のコードをいじって変更ということになるが、Python が駄目でも rst2xml でXMLに変換してしまえば他の言語でも reStructuredText のパーサを書かなくても(XMLの処理系を使って)コンバータを書くことができるの比較的楽である。

しかも欲しかったレコードの表現用にフィールドリストというシンタックスがあるではないか。

いいじゃん。

ということで早速今日から使うことにした。

Debian GNU/Linux sid にある Docutils 0.3.9 ではいわゆる全角文字も文字幅を1として扱かう。 このためテーブルなど桁揃えを用いる書式の部分がこのままだと不便である。 画面上では2文字分幅があっても1文字として数えられるため Docutils が通るようにするためには余計な空白などを入れて文字数を調整しなければならないが、そうすると今度は見た目的にずれるので可読性がかなり落ちてしまう。

この問題のためにMatsumoto,Tadashi氏がパッチ

• http://city.plala.jp/.../rst/README.html

を作成されているので、これを適用。

これでばっちり。

• 定型書式で内容を記述していくのに便利な形式は? (2005-11-21)
• 私的10大ニュース2005 [ comp ] (2005-12-31)
• Docutils は自分にとっての Python キラーアプリかも (2005-12-01)
• Twitter ベイジアンフィルタプロキシ (2007-12-29)
• Impressive - PDF ファイルでプレゼンテーション (2009-02-19)

■ いい夫婦の日にボジョレー・ヌーヴォーを

明日は休日だしということで、買っておいたボジョレー・ヴィラージュ ヌーヴォーを開栓。 今年は3年前と同じラベル種のワイン。

今回のお味であるが、それほど炭酸味はなくフルーティ感もあまりない気がする。 1杯目の半分ぐらいまではよかったけれど、その後があまりすすまず。

• 普通の土曜日 (2004-10-02)
• 小坂七夕祭を見に小坂町へ (2005-08-06)
• 祝賀会 (2004-11-13)
• 今日のさえずり - 理系なのでビタミン C 摂取して、アクエリアス飲んだ (2008-11-24)
• PCを使わない時間を作る (2005-10-18)

■ ON SUNDAYS で本を眺めつつヘーゼルナッツラテ

栗原はるみ すてきレシピ37号で「ワタリウム美術館のミュージアムショップ ON SUNDAYS」にあるカフェが紹介されていて、ぜひ行ってみたいと思っていた。

今日神宮外苑に出たついでに足を運んでみた。 銀座線外苑前駅からだと青山通りを渋谷方面へ進んで、青山ベルコモンズで曲がって外苑西通り(キラー通り)へ。で最初の信号のところ。

• 東京都渋谷区神宮前3-7-6 (Google ローカル)

神宮外苑前から向かう際、間違えて手前の外苑前交差点で曲がってしまってタイムロス。 痛恨のミス。

ON SUNDAYS は(当然であるが)アート系の商品をそろえたショップ。 地下では FREITAG(フライターグ)の全商品を12月30日まで期間限定で販売中。

地下へ降りる途中にあるちょっとしたスペースにあるカフェでは、アートな気分を味わいながらくつろぐことができる。 座席数は少な目。 ヘーゼルナッツラテを飲みながら、ぼんやりと階下を眺める。

ON SUNDAYS の商品の方はかなりマニアックだったので、自分にとってはぶらっと何かを買いにくるといった感じではなかったかな。 近くを通ったらまたカフェには寄ってみたい。

帰りは千駄ヶ谷まで歩こうかと思って外苑西通りを北上したら、これがまた遠いのなんの。 11月下旬ともなると日が暮れるのも早く、明治公園・国立霞ヶ丘競技場のあたりではもう随分暗くなって寂しい限り。 またもや痛恨のミス。

大江戸線の看板を見つけ、そのまま吸い込まれて国立競技場駅で地下鉄にのって帰路へ。

• 同級生とボルツを懐しむ (2009-09-30)
• 奥様に人気の KINOKUNIYA エコロジーバッグ (2006-04-22)
• 椿山荘は江戸川橋駅から遠い (2004-11-20)
• オウム真理教青山総本部跡 (2003-02-15)
• 今日のさえずり - 餞別用意したけど最終日の今日来なかった (2009-06-15)

■ 平成17年第9回神宮外苑いちょう祭りで豚の串焼き

勤労感謝の日。 都合が良い年は、神宮外苑の銀杏並木を見にいくことにしている(いくことにしているというほどは行っていないが)。

F3/T を肩に下げて数年ぶりに神宮外苑へ行ってみた。

ここ数年11月23日だと、色付きが少ないように感じているがどうだろう。 今日もまだまだ緑色の葉が多く、落葉も舞うというほどではなかった。 近年、街中で見かける銀杏が黄色くなることなく散っている気がするのだが気のせいだろうか。

この時期、神宮外苑ではいちょう祭りとしてお店が出ている。 以前きた時は噴水の奥のグランドではスポーツ大会をやっていたと記憶しているが、今日はその奥にもテントが並んで食べ物や茶碗などが売られていた。

豚の串焼きと焼きそばで昼食がわり。 豚ウマ。

• ON SUNDAYS で本を眺めつつヘーゼルナッツラテ (2005-11-23)

■ 早速 reStructuredText から LaTeX へのコンバータを書く

要求仕様書を書くのに reStructuredText を使ってみることにしる。 reStructuredText の文法の上で、あるルールに従って書いた特定のセクションやフィールドリストを要求レコードや要求仕様レコードとし、自前でコンバータを書いて LaTeX へ変換する形。

まずは最初のアイデア通り rst2xml で XML に変換してから、Perl スクリプトで読み込んで処理することにする。

Perl 側の処理は XML::LibXML で (何となく XML::DOM より好き)。 しかし毎度ながら DOM 面倒くさい。 とりあえず、今必要な要素のみ変換コードを書く。 reStructuredText を XML へ変換した時の DTD があるので、おいおいこれを見ながらきちんと埋めていかねば。

最低限のものができて、早速コンバート。

これで生 LaTeX で書くより随分楽になった。よし。

• 定型書式で内容を記述していくのに便利な形式は? (2005-11-21)
• Docutils は自分にとっての Python キラーアプリかも (2005-12-01)
• JavaScript でのプログラミングやっぱり面倒くさい (2006-07-23)
• Twitter ベイジアンフィルタプロキシ (2007-12-29)
• reStructuredText いいんじゃない? (2005-11-22)

■ パーティ日程ほぼ確定

先生のご都合が確認できたとのこと。

これで本格的に準備開始。

■ 仕事のヒント

Web で紹介されているのをみて「仕事のヒント (神田昌典)」を昨日買ってみた。

「すごいやり方」と同じく、1ページに1項目がババンと書いてあるスタイル*1。

短いのでぱぱっと読める。 いや、読んで終わりというタイプの本ではなくて定期的にぱっと開いたページから新しい発見を得るというタイプである。 そういう意味では、リラックマ本も同列だったりする。

この本、表題は「仕事のヒント」であるが

• 第1章 モノを売るヒント
• 第2章 経営のヒント
• 第3章 生き抜くヒント

という構成であり、どちらかといえば経営やマーケティング的な視点が多い(実はてっきり仕事術のような本かなと思って買ったのだったりする)。 しかしながらソフトウェアの研究・開発をしている自分にとっても、ハッとするヒントが盛沢山であった。 新しい企画提案をする際には本書を見返して、ポイントを外さないでいくようにぜひしたい。

特にベンチャーや中小企業の人にお薦めだ。

 売れない理由のトップは、
 「わかりにくいから」
 p.34, 神田昌典

あちゃー、耳がイタイ。

• 仕事のヒント (神田昌典)

この本はかなりエッセンス的なもので、神田氏の本にはまだまだいろいろ書かれているらしい。 今度ぜひまた別の本も読んでみたい。

[ 書評 ] [ お薦めの本 ]

• Joel on Software - 必読書 (2008-08-14)
• すごい会議 - 短期間で会社が劇的に変わる! (2005-05-27)
• Evernote 使用開始 (2009-03-03)
• ピープルウェア読了 (2004-05-25)
• クリアリングでマイナス思考を3秒で削除 - No.1理論 (2009-09-20)

■ ほぼ日手帳の秘密

マーケティング戦略にまんまとのっかってしまっているとわかりつつ、神保町の三省堂で購入。

巷に溢れる手帳術本とは違って、「目標達成のための秘訣にせまろう」などと気張らずに読み物として楽しめる。

手帳というと、ときどきビジネスとプライベートをどう書き分けるか(どちらかだけにするか、混在させるか)について思い悩んでしまったりする。 PDA だとカテゴリ別に表示を切り換えることができたりするが、紙の手帳ではそうはいかない。

その、おおもとのところをいえば、「仕事」と「個人」というのは、決して敵対しているわけじゃないということです。 (中略) 入り組んでて当たり前だと思うんです。-- p.30

でも、まあ仕事もプライベートもどちらも自分にとって人生の一部なんだから切り分ける必要はないのかもしれない。

それから、目の前で妻がほぼ日手帳に書き込んでいるのをみるとなぜだかビーム*1したくなる。 ほぼ日手帳巻末の「この手帳についていないもの」の一覧に赤外線ポートを追記しておきたい。

• ほぼ日手帳の秘密 - 10万人が使って、10万人がつくる手帳。

[ 書評 ]

• TQ 読了 - ちょっとずつ実践中 (2005-07-08)
• ポケットぽっこりだけれど、色に魅かれてマンダリンオレンジほぼ日手帳2007 (2006-09-15)
• 久しぶりに神保町をぶらぶら (2005-11-26)
• 2008年夏の GTD 運用ツール (2008-07-23)
• ほぼ日手帳用無印良品ミニバッグ (2005-12-09)

■ 久しぶりに神保町をぶらぶら

妻のリクエストで今日は神保町に出かけることにした。

神保町は、中学生の頃は自転車でちょくちょくきていた(中学生に電車代はもったいなさすぎた)。 高校時代は三田線で。 浪人時代は……中央線で。 まあ、そこそこ馴染みのある町ではる。

古本屋・三省堂書店・文房堂・三省堂書店 自由時間などを巡る。 三省堂書店 自由時間にある「上島珈琲店 神田神保町店」で一休みしたのだが、便利な場所だしセルフサービスの気兼ねなく入れるお店だしとなかなか使えそうな感じで。

• 新婚の友人訪問 (2007-04-22)
• ほぼ日手帳の秘密 (2005-11-26)
• 品川 (2004-02-11)
• 散歩 (2003-10-04)
• スクウェアフォーマットピンホールカメラ PP35/SQ[tigre] (テ... (2005-10-20)

■ 方眼手帳と方眼ミーティングメモ

ほぼ日手帳の使い道であるが、Palm でやっているスケジュール管理をこちらに持ってこようと思う。 スケジュールと、あとログ。

さて、そうとなったら書き方だ。 せっかくなので、何か自分流のスタイルで方眼上でびしっとキメてみたい。

方眼といえば RHODIA。 ミーティングの議事メモなんかは RHODIA No19 にカリカリと書いている。 メモ毎に方眼上にチェックボックスを書いておき、ミーティングが終わったら Palm にスケジュールやアクションを転記したり、その場で処理したりしてそこにチェックを入れていって全部チェックできたらオシマイ。

ここでちょっともやっとしているのが「何でもかんでもチェックボックス」にしている点。これだと処理の必要のない項目までチェックボックスになってしまっており、後でチェック印がはいらないのですっきりしない。

ということで、ミーティングメモも含めて共有の俺スタイルを考えてみた。 基本的にはチェックボックスを踏襲することにした。

@ 種類マーク

チェックボックスの前にマークをつけて区別

• 「→」アポイントメント
• 「C」コミットメント
• 「A」アクション (To Do)
• 「W」待ち
• 「I」情報
• 「!」思い浮かんだこと。
• マーク無しは大項目、あるいはスケジュール欄における「→」の省略
• (→、C、A、W は要処理なので○で囲む)

写真撮ってから、→にも○があった方が整合性があることに気がついた。

@ 処理マーク

チェックボックスに入れるマーク。

• 「レ」完了
• 「→」転記済み (将来のスケジュール欄、Palm 上の GTD、プロジェクトファイル等へ)
• 「×」削除 (キャンセル他)
• 「－」アクション不要

アクション不要マークを用意することで、処理後全部のチェックボックスにマークを入れた状態にできるのですっきりする。

@ その他

• 「UMLのアクターアイコン + 名前リスト」議事メモにおける出席者。
• 「UMLのアクターアイコン + 名前 + 時間」発言、コミットした人の名前と時間。
• 「スケジュール欄のスケジュール項目名の後に(MM/DD)」アポイントメントを取ったときの日付(TQ に書かれているテクニックより)。

とりあえずこんな感じ。

凡例を書いてほぼ日手帳の下敷きに貼り、しばらくはこれでやってみることにする。

• チェックボックスルール拡張 (2005-12-24)
• 2008年夏の GTD 運用ツール (2008-07-23)
• A6 方眼ノート比較 (2006-01-06)
• 渋谷のロフトにほぼ日手帳2006を見にいった (2005-09-11)
• ほぼ日手帳復帰 (2008-07-22)

■ 私にとっての PDA の長所と短所

ほぼ日手帳と Palm をどう使い分けようかと考えるために、自分にとっての Palm (主に DateBk5)の長所と短所を思いつくまま列挙してみた。

@ 長所

• 小さい (PEG-TJ25)
• スケジュール
  • スケジュール変更が簡単。汚れない。
  • 定期的なスケジュールを自動処理できる (週毎・月毎・年毎・……)
  • アラームを鳴らせる
  • 数日前から予告表示できる
• To Do
  • 繰り越し
  • 繰り返し
  • ビジネス / プライベートの切り換え

@ 短所

• 入力が面倒 (手間取ると会話の流れを止めてしまう)
• (見にくくならない範囲で)1項目に書ける量が少ない
• 開きっぱなし(つけっぱなし)にできない
• 週間・月間表示に転記しなくても見られるのだけれど、1画面の情報量少なすぎて使えない

@ こうしてみると

To Do の繰り越し・繰り返しについては、文句なしに紙の手帳より PDA の方が強い。 紙の手帳だと付箋紙で繰り越し To Do を扱う方法があり、実際一時期やったこともあったが続かなかった(多いと邪魔なのと、だんだん糊が弱くなってくるのと、見た目がちょっとなのと)。飽きただけなのかもしれないが。

スケジュール管理(含む GTD の「日時指定の行動」)は、ほぼ日手帳へ移してもいいかもしれない。 それ以外は、ひとまず DateBk5 に留保だな。

• 方眼手帳と方眼ミーティングメモ (2005-11-27)
• 渋谷のロフトにほぼ日手帳2006を見にいった (2005-09-11)
• 次の行動に必要な時間を書いておく (2005-08-19)
• Palm の充電池が切れてた (2006-05-06)
• やはり「次の行動」は今日の分をわけない方が良い (2005-09-29)

■ にごり水だ。早く帰りたい。

今日の23:30 から「にごり水」である。

こういう日に限って帰りが遅くなる用事が入ったりするものである。 とっとと帰って食事を済ませ、風呂に入らねばならぬ。

結果幸いぎりぎり間に合った。セーフ。

で。

明後日もにごり水。 うちの近所は2連コンボでくる事が多い。 どこもそうなのか?

• 今日のさえずり - 停電って近隣にいる Twitter-ers あぶりだしに最適 (2010-01-21)
• 今日のさえずり - 風呂の換気扇が壊れた。動かなくなった。 (2007-10-20)
• にごり水(13:00 - 17:00) (2004-02-07)
• 今日のさえずり - 78円の赤いきつねに、430円のかき揚げ (2007-12-31)
• 追い焚なくてもホカホカ風呂バンス600 (2007-11-03)

■ めざましマガジン Vol. 8 にしてやっともらえた

秋葉原駅前でも配っていたのだが、タイミングが悪かったりしてなかなか貰えないでいためざましマガジン。

この間ももらおうかと思っていたら、配布場所が悪かったのかスタッフが警備員のような人にに怒られているところでもらえずじまい。

そんなであったが、本日やっと手にすることができた。

中身の方は、うーん「めざまし」らしい記事はそれほど多くない。R25 を見慣れてしまうと紙も安っぽく感じるし、ちょっと期待外れ。

• 今日のさえずり - ささやかな気持ちDES (2008-11-07)
• 今日のさえずり - 「深呼吸してください。」が無くなったのは残念 (2009-09-24)
• 今日のさえずり - 昭和通りでホームレスがトロフィーかかげてる! (2008-08-31)
• 今日のさえずり - Amazon.co.jp でママレモン売ってる (2008-10-16)
• 今日のさえずり - 「ネット監視」呼ばわりされた (2009-06-26)

■ 作っても自分の会社名が載らない

そういう仕組だとわかっていても、なんか虚しい。

■ ストーリーカード・タスクカードを導入した開発の成果物を納品

なんとか月内に発送できた。

今回はストーリーカード・タスクカードを試験的に導入。 終盤ちょっとチェック頻度がさがってしまったという反省はあるものの、開発ペースがつかみやすくなったり、機能の実装漏れを防げたりと効果は充分あったと感じた。

その他、プログラミングについて互いに積極的に教えあうなどチームメンバそれぞれ学習できたという点でもなかなか良かったと評価したい。

チームの皆さまオツカレサマ。特に松下君オツカレサマ。

• 今日のさえずり - フロスティ食べたい (2009-12-10)
• ソフトウェアかんばん (2005-10-28)
• Google ドキュメントでソフトウェアかんばん (2008-03-30)
• ソフトウェアかんばん「見えない化」 (2006-04-10)
• WiKicker でソフトウェアかんばん (2007-03-01)