FrequentlyAskedQuestions
----------------------------------------
よくあるような気がしないでもない質問に対する答えをまとめたページです。
「こんなプラグインありませんか？」といったような疑問に対する答えを探している人は、PluginForXxxも参照すると良いかもしれません。
*blosxom全般のFAQ
**「blosxom」ってなんて読むんですか？
「ぶろっさむ」です。元々はblossomという名称で開発されていたそうですが、作者のRaelさんがMac OS Xに傾倒したことから、osxという文字列を埋め込んだblosxomになったそうです。嘘かも。
**本当にPerl 5だけで動くんですか？
はい、動きます。というのは半分くらい嘘です。たしかにblosxom自体はPerl 5(と標準でバンドルされているPerlモジュール)さえあれば動作させることは出来ますが、CGIとして動作させるためには&link(Apache,http://httpd.apache.org/)等のHTTPサーバー・ソフトウェアが必要です。ただ、多くの場合、レンタル・サーバーに設置するケースがほとんどだと思われるので、そういった意味ではレンタル・サーバーにPerl 5さえインストールされていれば問題なく動きます。
サーバー・ソフトウェアにはほとんど制限はないと思われます。IISやAn HTTPdなどでの動作実績もあります。
**動かそうとしたら500エラーになります
それだけはどうにも答え様が無いです。
**$urlが自動設定されません
サーバーの環境に依存します。場合によってはうまくいきますが、多くの場合はうまくいかないようです。設置した環境に合わせて、&verb(http://)で始まるURLを指定してください。
**日本語は問題無いと聞いたんですが、文字化けが起こります
日本語が問題無く利用できることは間違いありません。しかしながら、矛盾しているようですが、文字化けは起こります。この問題には二つのケースがあります。
一つ目は、content_type.flavourに適切なcharsetパラメータを指定していないことによる文字化けです。blosxomではHTTPヘッダの出力に&cpan(CGI)モジュールを利用しているのですが、CGIモジュールではcharsetパラメータに明示的に文字コードを指定しない場合、ISO-8859-1をセットしてしまいます。ので、UTF-8やEUC-JP等の日本語の文字コードでblosxomを利用する場合はcontent_type.flavourで文字コードを明示してやらねばなりません。具体的には、
---(
text/html; charset=UTF-8
---)
といった様に記述しなければなりません。
二つ目はblosxom.cgiやプラグインのファイル自体の文字コードに基づく文字化けです。blosxomでは内部で文字コードを揃えるといった処理は存在しないので、blosxom.cgiやプラグイン内で使われた日本語は、そのファイルの文字コードそのままで出力されます。つまり、blosxom.cgiやプラグインのファイル自体も出力に利用する文字コードと揃えてやらなければならないということです。
以上の二つのケースを頭に入れておけば、日本語が化けるということはまず起こりません。
**新しいエントリの投稿方法がわかりません
blosxomでは$datadirに$file_extensionで指定した拡張子のファイルを作るだけです。つまり、多くの場合はローカルでエントリをテキスト・エディタで書き、FTPで$datadirにアップロードするということになります。
**日付けごとにページを作ることができるときいたのですが、やり方がわかりません
blosxomで日付けごとのページにアクセスするためには、
---(
http://example.com/blog/blosxom.cgi/2005/04/17.html
---)
といったようなURLにアクセスすればOKです。ゆえにstory.flavour等でPermalinkのスタイルをこれに準じた形にするためには、
---(
$title
$body
Permalink
---)
といった様にしてやれば可能です。&link(tDiary,http://www.tdiary.org/)的なスタイルですね。
**数字で始まるカテゴリ名を作ったら上手く動作しません
blosxomでは数字始まりのカテゴリを作成することは許容しておらず、必ずアルファベットで始めるという仕様になっています。その理由は、数字は年月日の指定に利用していることがあることにあります。URLの柔軟な指定が可能なこととのトレードオフとして考えてくれれば良いかと。
**エントリを手直しして更新したらエントリの日時が変わってしまいます
blosxomはエントリ・ファイルの更新時刻をエントリの日時とします。手作業でエントリを更新した場合、その更新時刻は当然変化してしまうので、こういった現象が起こります。つまり仕様です。
しかし、エントリの日時を保持するプラグインがいくつかあります。代表的なものは&link(entries_index,http://www.blosxom.com/plugins/indexing/entries_index.htm)ですが、&link(entries_cache,http://www.blosxom.com/plugins/indexing/entries_cache.htm)の方が安定かつ高機能だそうです。
*フレーバー関連のFAQ
**特定のカテゴリだけフレーバーを変えるにはどうしたら良いのですか？
blosxomはフレーバーを各カテゴリから読み込んでくれます。つまり、あるカテゴリだけ別のフレーバーを利用したい場合は、そのカテゴリに当たるディレクトリにstory.htmlなどのフレーバー・ファイルを作ってやるだけでOKです。
例えば、photoというカテゴリの場合にはエントリ・ファイル名と同じファイル名を持つJPEGファイルを他のディレクトリから読み込んで表示させてやりたいなどという場合は、$datadir/photo以下にstory.htmlを作成し、
---(
$title
$body
Permalink
---)
といった様にしてやるだけです。
また、この機能は$datadir以下に作成した複数のカテゴリをそれぞれトップ・カテゴリと見せかけることも可能なので、複数のblogを一つのblosxomで構築することができるとも言えます。ただし、プラグインなどは共有になるので、完全に独立したblogになるわけではありません。
*プラグイン関連のFAQ
**wikieditishで新しいエントリを投稿する方法がわかりません
&link(wikieditish,http://www.blosxom.com/plugins/edit/wikieditish.htm)では、まだ存在しないエントリのファイル名を指定した場合は、新しいエントリの投稿になります。つまり、fooというカテゴリにbarというファイル名で新規エントリを作成したい場合は、
---(
http://example.com/blog/blosxom.cgi/foo/bar.wikieditish
---)
というURLにアクセスすることで空の投稿フォームが表示されるので、新規エントリを投稿することができるということです。
*blosxom starter kit関連のFAQ
**ほとんどのファイルが文字化けして読めないです
blosxom starter kitに同梱されている全てのファイルの文字コードはUTF-8で、改行コードはLFになっています。UTF-8を読み書きすることのできるエディタで開いてください。
**中味が空のファイルがいくつかありますが、これは動作に必要なんですか？
オリジナルのblosxomの存在しないフレーバーを参照した場合、デフォルトに設定してあるフレーバーが読み込まれるという仕様を回避するためのダミー・ファイルです。つまり、正常な動作に必要なファイルです。
**Shift_JIS(またはEUC-JP)での配布はしないんですか？
配布する側の都合的に、Shift_JIS版やEUC-JP版は予定していません。しかしながらShift_JIS(またはEUC-JP)で運用することも可能です。その場合は、全てのファイルの文字コードをShift_JIS(またはEUC-JP)に変換した上、UTF-8と書かれている部分を全てShift_JIS(またはEUC-JP)に書き換えてください。
**パーミッションの指定方法が良くわかりません
サーバーの環境に依存するので、とても同梱のreadme.txt以上のことは言えません。トライ・アンド・エラーでがんばるしかないかもしれません。
**月ごとのページに飛ぶリンクが和名でわかりづらいです
単に「日本語も使っても大丈夫！」ということを教えたかっただけですので、config.cgiの@archives_monthnameを英語とか数字とかわかりやすいものに好みで設定してください。
**Jcodeモジュールなど導入する方法がわかりません
個別に導入する方法はあることはあるのですが、トラブルの元になりますので、説明できません。基本的にはサーバーの管理者にインストールを頼んでください。
**クッキーを割り当てるドメインというのがよくわかりません
コメント投稿者の名前とURLまたはメール・アドレスを記憶する機能を利用する場合、クッキーを利用して記憶させるので必要になる設定です。設定は&cpan(CGI)モジュールの仕様に従ったものになります。詳しくはCGIモジュールのドキュメントを参照してください。
**静的生成を行うとうまく動いてないようなんですが？
静的生成に関してはサポートしていません。静的生成する場合にはオリジナルのblosxomでどうにでもなると考えていることと、考慮すべき点が多すぎてとても手が回らないことが主な理由です。
*その他のFAQ
**URLからblosxom.cgiを隠して動作させられるらしいですが、やり方がわかりません
blosxom本体の機能では不可能です。しかし、Apacheモジュールである&link(mod_rewrite,http://httpd.apache.org/docs/mod/mod_rewrite.html)を利用することで可能になります。具体的にはblosxom.cgiを置いたディレクトリに.htaccessを設置し、それに、
---(
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ blosxom.cgi/$1 [L]
---)
といった様に記述してやるだけです。ただ、mod_rewriteはわかりやすいとは言いがたいのと、設置環境によっては動作が異なることもあり、このままではうまくいかないこともあります。
**blosxomに関するもっと深い情報が欲しい
wide系のIRCサーバー(See Also: &link(サーバーリスト,http://irc.kyoto-u.ac.jp/list-of-servers.html))で開かれている#blosxomチャンネルを覗いてみるといいかもしれません。
IRCの利用に関しては&link(Preston Wiki - IRC,http://www.preston-net.com/wiki/index.php?%5B%5BIRC%5D%5D)などを参考にご自分でお調べください。
----------------------------------------
Last-Modified: 2006-11-21T18:34:34+09:00