adiary開発日誌

key記法、day記法

記事keyおよび日付指定を指定する機能を付けました。例えばこの記事のURLは

(a)http://adiary.blog.abk.nu/060

(b)http://adiary.blog.abk.nu/xxx

ですが、このとき記事keyは 60 番になります（トラックバックURLでも分かります）。以下は例。

-(a)へのリンクは[key:060]や、ほかのタグと同様に[key:60:この記事へ]とも書けます。
-(b)へのリンクは[key:xxx]や[key:xxx:この記事へ]と書けます。
-他人の日記の場合は [id:kaede] や [id:kaede:158] とします。
-日付指定は [day:7:７日の記事] や [day:7/7]、そのほか[day:2006/6]とも書けます。
-その日を指定したい場合は単純に [day:] や [day:今日の日記] で行けます。
-他人の日記は、[day:kaede] [day:kaede:7/7] という風に書けます。
-アンカー指定は [day:kaede:0142:#p1] や [key:15:#p2] という風に書きます。
-当日の日記は [key:#p1] や [this:#p1] で指定できます（β７以降で対応）。

• (a)へのリンクは記事key指定機能、日付指定機能や、ほかのタグと同様にこの記事へとも書けます。
• (b)へのリンクはxxxやこの記事へと書けます。
• 他人の日記の場合は kaede や kaede:158 とします。
• 日付指定は [date:(format error)] や [date:(format error)]、そのほか[date:(format error)]とも書けます。
• その日を指定したい場合は単純に [date:(format error)] や [date:(format error)] で行けます。
• 他人の日記は、[date:(format error)] [date:(format error)] という風に書けます。
• アンカー指定は [date:(format error)] や 日記記法の説明 という風に書きます。
• 当日の日記は #p1 や #p1 で指定できます（β７以降で対応）。

追記。コメントで指摘された件、修正しました。

• Satsuki-systemの文法等はこちら参照

はてな技術者のnaoyaさんのPerl技術記事見てたんですが

adiary関連の技術情報＝マニュアルも本格的にまとめ始めたほうかいいなぁーと思ったりしたりしました。数日中にもβ版公開しましすが、ソースみただけではわからないところが多々ありますし。

比較的短期間かつ少人数（一人か）でこれだけのシステムになったのかってのは訳があって、生産性を担保するシステム構成によるところがとても大きいのです。それを担保してくれる Satsuki-system（スケルトンシステム）がなかったらadiaryの開発は不可能でしたし、そもそも「自作のスケルトンシステムがあまりに便利かつ有用なので、これを有効活用する手だて」としてblog（adiary）を開発したという、なんとも本末転倒な話だったりします（笑）*1

Satsuki-systemとTemplate Toolkitの比較

スケルトンシステムというのは何度も申し上げているとおりで、Perlの変数埋め込みを一歩進めて簡単な命令を書けるようにしたものです。この考え方の有名な例として、Movable Typeにも使われている*2 Template Toolkitがあります。このTemplate Toolkitは変数置換の他、簡単な条件構文やループなどをHTMLテンプレート中に記述できます。

Template Toolkitでは読み込まれたHTMLファイルを、Perlで実行可能なプログラムとしてテンポラリに吐き出します。次以降は、そのコンパイルされたファイルを実行するわけです（mod_perlのときはキャッシュされるのかな？）。Satsuki-systemも紆余曲折の上、現在はその形に落ち着いています。

でも、Satsuki-systemとTemplate Toolkitは決定的に違うところがあります。Template Toolkitのキャッシュはperlプログラムとして実行することでそのまま出力HTMLが得られますが、Satsuki-systemのそれは、そのまま実行することは不可能なプログラムになっています。Satsuki-system本体とコンパイル済のプログラムの２つが合わさって初めて意味を持つわけです。

なんだ「使いにくいだけじゃないか……」と言われるかもしれませんが、実はそこが最大のミソなのです。Satsuki-systemはスケルトンシステムでありフレームワークでもあります。スケルトンシステムから参照する必要なルーチン（ライブラリ）は、システム本体に納められており、そのライブラリ部分を自由に拡張できることこそが最大の特徴です。

以下はスケルトンのコメント表示部分を抜き出したものです。

<p><span class="canchor"><a href="<@t.this_diary_url>#c<@t2.pkey>#">#</a></span>
<span class="commentator"><span<@if(t2.id, " title=<@t2.id>")>><@t2.name></span></span>
『<@t2.text_short>』　<span class="comment-date">(<@tm_printf('%Y/%m/%d %J:%M', t2.tm)>)</span></p>

強調表示のところが埋め込みです。大半はただの変数置換だと思って問題ありません。一番最後の、tm_printf が関数呼び出しとなっていて、この実体はSatsuki-system本体（Base.pm）に含まれます。この関数に相当するものを増やしていくことで、システム全体を構築します。*3

つまり、Template Toolkitキットでは「Perlプログラムの付属品としてのHTMLテンプレート」であったわけですが、Satsuki-systemでは「スケルトン(HTML)の付属品がPerlプログラム」なのです。

Satsuki-systemとPHPの比較

そこまで、スケルトン万歳ならはじめからPHPみたいな埋め込み言語を使えばいいじゃないかという話になります。PHPは使ったことはないのですが、一つそして決定的にPHPを使いたくない理由があります。プログラムとHTMLのソースが一緒になっててメンテしずらい。きちんと書かれた（？）PHPのソースならばそうはならないのかもしれませんが、１画面＝１HTML＝１プログラム主義のように感じます。

というわけで、もちろんSatsuki-systemだって同じだろうというツッコミもあります。adiaryの日記一覧のような部分は、実際にHTML内にPHPのようにプログラム的動作を記述してページ送りなどを実装していますから、同じといえば同じです。ですが、それは推奨される形ではなく、ほとんどの場合１ページに対して１つのPerlのサブルーチンが付属しています。

RoRのモデル・ビュー・コントローラー的な考えからいえば、Viewがスケルトンで、ControllerがPerlのコードということになります。PHPとの大きな違いはここですが、PHPのプログラム部を外部ファイルとして追い出したとしたら（本体には呼び出しのみ残る）、似たようなものだと思います。

Satsuki-systemとRuby on Railsの比較

比較も何も……似たもの同士です*4。これは別にRoR的思想を取り込んだわけではなくて、Satsuki-systemの「変数埋め込みHTMLの拡張」を突き進めた結果、似たようなものにたどり着いたというわけです*5。もっとも、最初の思想からMVCなRoRとはスタート地点で負けているわけですが、そこを敢えて比較すると

• Satsuki-systemはPerl用である。開発時点でRubyよりPerlの方が処理が速かったのがPerlになった理由ですが、Ruby 2.0 YARVが登場すると立場逆転しそうです（汗
• RoRの方が思想的にOO（オブジェクト指向）として綺麗である。そもそもPerlのOOはやっつけなので、これもスタート地点で負けてます。

となります。勝ち目ないですけど（汗）　後ろ向きなアドバンテージは、

• 今この時点においては、Perlの方が速く動作する。*6
• Perlの方が普及してるし、ユーザーも多い*7
• 必ずしも「データ（データベース）」対応でなくてもよい分、Satsuki-systemの方が汎用的かもしれない。
• 昔ながらのきついルールーより実用主義的なプログラマには…ry(^^;;

まとめると

んー……Perl版フレームワークのないRoRの出来損ない？（ぉぃぉぃ*8

もっとも、

• 可能な限り高速に動作するよう設計されている*9
• mod_perl (prefork/worker)でもcgiでもSatuki-systemが差を吸収してくれる（ただし若干気を遣って書く必要はあり）

ですけども。早くマニュアル整備しろってことですね（汗）*10

• 標準テーマ以外でも、システムモードで使用できるように変更しました*1。
• 【画像アルバム】アルバム用アップローダの実装方式を変更しました（使い勝手に変更はありません）。
• 標準添付の「画像アップローダー」を作成しました。ImageMagickがあるとき、サムネイルを自動生成します。
• その他、細かいバグの修正

これでやっと、adiaryの本体機能の開発に復帰できます（苦笑

追記

と思ったらIE5/6でCSS関連の表示が楽しいことになってる（汗）　特にIE5は感動的なまでにすばらしい。これをまず直すのかぁ……（かなりやりたくない

ネタバレ防止などで本文を表示したくないとき、表示を隠すことができます。なお、はてなテーマでは常に背景色が白に変わってしまいます*1。

文中の場合は「[h:この部分が見えなくなります]」と書きます。ブロックの場合は、
>>hidden
この部分が見えなくなります。色が変わるタグを使った場合には気を付けてください。
タグなどにより[g:検索]や<strong>強調</strong>なども見えなくするようテーマ作者は注意してください。
<<
とします。

文中の場合は「この部分が見えなくなります」と書きます。ブロックの場合は、

この部分が見えなくなります。色が変わるタグを使った場合には気を付けてください。

タグなどにより検索や強調なども見えなくするようテーマ作者は注意してください。

とします。

なお、>>>hidden ～ <<< でも構いません。

• スケルトンシステム（Satsuki-system）を更に改良しました*1
• 過去日記一覧が正しく動作しないバグを修正しました（スケルトンコンパイラの不具合）
• トラックバックが送信できないバグを修正しました（HTTPエージェント改変時の不具合）
• 書き込み日時の表示かおかしいミス（編集時・削除時共に）を修正しました*2
• コメントの編集、トラックバックの編集時のメッセージかおかしかったバグを修正しました。