sbで行こう

本当は技術的な裏づけが取れてから書きたかったのですが、あまりにも初期で躓くケースが多いのでさくっと。

sb のインストールをされる方の質問で一番多く見受けられるのが、admin.cgiが真っ白になりますというものです。どなたも決まってパーミッションは確認しました。間違っていませんと仰られます。しかしながら、特に最初の起動時に画面が真っ白になるのは 100% の確率でファイル・ディレクトリのパーミッションが間違っているかファイルが足りないケースなのも事実です。

とはいえ、もう一度確認してなどと打ち返されても質問者にはどうしようもありませんよね。確認して分かるものなら最初からはまってませんから…。せめてヒントのひとつもほしいというものでしょう。

ということで、自力解決の助けとして、どこで何が失敗しているかを知るための admin.cgi 改造手順を公開します。

では、例によってお約束事を。

• 本記事は、あくまで admin.cgi にアクセスすると真っ白な画面が出る人のための対処法の説明です。他のエラーには適用しないで下さい。
• どんな影響があるか分かりませんので、既に投稿された記事等がある場合は事前の data ディレクトリ配下のバックアップを強くお勧めします。
• 対応バージョンは 1.10R のみです。将来のバージョンで同じように適用できる保証はありません。sb バージョン 1.11D では真っ白にならないように対応されたため、以降のバージョンではこの手順は必要ありません。
• 本記事で紹介する改造は、原因が判明したら元に戻して下さい。
• 本記事で紹介する改造を適用されたために発生したいかなる不具合にもふうこは責任を負いません。

sb 開発研究所で、何故、独自タグ {selected_entry_list} はページ内の該当記事ではなく、個別エントリファイルへのリンクになっているのかという疑問を見つけました。

その疑問の答えは、端的に言えばJUGEM がそうだからということになるんですが、{selected_entry_list} には「ページ内に表示された記事のタイトル一覧を表示する」という特性がありますから、何故ページ内リンクではないのか？という疑問が上がるのは理解できる話でした。

つうことで試しに作ってみました。トップページおよびアーカイブページ（月別・日別・カテゴリー）の表示時に、{selected_entry_list} の内容を同じページ内の該当記事のトップにジャンプするリンクにします。

sb にログをインポートしたいが、手元に HTML ファイルしかない場合というのがあります。例えば、誰とは言わないが sb のアップデート中にうっかり data ディレクトリ配下を消してしまった時とか…。

sb では blog の更新に必要なデータを全て data ディレクトリ配下に格納しているので、HTML ファイルだけでは blog システムとして動作することができません。しかし、記事本文や投稿コメントやトラックバックなど、必要最低限のデータは全て HTML ファイルに入っているのに、data ディレクトリ配下のファイルがないだけで全て捨ててしまうのも口惜しいものです。ということで、最後のあがきで HTML ファイルから sb にインポート可能な XML ファイルへのコンバートをやってみました。

続きを読まれる前に、以下の点についてご理解下さい。

• この記事は、便利ツールの紹介ではありません。サンプルは公開しますが、perl の環境整備とプログラミングが自力でできる方を対象にしています。
• この記事で紹介するスクリプトは CGI ではないので、Web サーバでは動作しません。CGI を作れる方なら部品を利用することは可能かと思いますが、モジュールの要件が厳しいと思います（試したわけではないです）。
• この記事で紹介する方法は、HTML が blog システムで構築されたものであることを前提にします。すなわち、全ての HTML ファイルが同じ構成で記述されている必要があります。手動でアップしていた日記ページのようなものは考慮に入れていません。
• 元々１回限りのつもりでテキトーに作ったので、鈍くさいコードでも笑わないでね… ご指摘は歓迎します。

2003年末あたりからの blog ブームで、Web ホスティング型 blog のサービス提供数や blog 人口が爆発的に増えている一方、諸般の事情で blog をお引越しをする方もたくさんいらっしゃるようです。かくいうふうこもその一人でしたけれども。

blog の引越しで最終的に問題になるのは、過去ログの移行です。特に sb を始める JUGEM ユーザさんなどは、sb を設置して正常稼働を確認して、やれ一安心と JUGEM からエクスポートした XML ファイルをインポートしようとした時に Out of memory ... というエラーに遭遇することがあります。これはエクスポートした XML ファイルが大きすぎることによるもので、XML ファイルを分割してインポートすれば解決します。が、単なるファイルの分割と違ってXML なんか見たことも食べたこともないという方には何をどう分割してよいのか分からないでしょうから、ここでさくっと XML ファイルの分割方法についてメモっておきます。