Ringworld
RingBlog説明書

RingBlog説明書 - インストール

  1. FTPによるファイル送信時の注意
  2. Perlのパスの設定
  3. 設定ファイル
  4. インストール

FTPによるファイル送信時の注意

WindowsとUNIX/Linuxとの間でFTPによるファイル転送時には下記に注意してください。

jcode.pl と unicode.pl は「バイナリ」で転送してください。 アスキーとかテキストとかで転送するとファイルの一部が壊れる可能性があります。
これ以外のファイルは改行コードを転送先OSに合わせるため、アスキーかテキストで転送してください。

UNIX/Linuxの場合には、ファイルにパーミッション(許可情報)を設定する必要があります。
サーバーによって異なることもありますが、一般的には転送後に以下のように設定してください。

Perlのパスの設定

blog.cgi と tb.cgi の先頭に、perl のパスの記述があります。

#!/usr/local/bin/perl

この行を RingBlog を使うサーバーに合わせて修正してください。どのように設定するかは プロバイダの指示にしたがってください。

設定ファイル

パスを設定する場合には、v.2.4からは module/Init.pm の先頭部分を修正してください。

v.2.2 から設定ファイルが 2本に分かれています。
これらの設定ファイルは、書き込み可になるようにパーミッションを設定してください。

インストール

CGI としてシステムから呼ばれるのは次の2本ですす。
サーバー、あるいは使い方によってスクリプトやデータファイルの置きかたが異なります。
以下の例では <  >で囲まれたものはディレクトリを意味します。

なお、設置ができたら操作説明を参照して、管理者パスワードの設定と メンバー登録をしてください。
A. CGIとデータを同じディレクトリに置く場合

CGIディレクトリとデータディレクトリの区別がない場合です。
すべてのファイルを同じディレクトリに置いてください。

/home    /  user    /  public_html    /  blog    /  blog.cgi
tb.cgi
config.cgi
index.html
<img>
<data>
<template>
<skin>
<log>

この場合には何も設定しなくても動くはずです。
トラックバックURLやRSSファイルのURLが正しければ、そのままでいいでしょう。

基本となるURLを環境変数から得ますが、サーバーによっては公開しているのとは別の内部的URLに なってしまうことがあります。トラックバックURLやRSSファイル、CSSファイルのURLやトラックバックURLが外部に見せたいものでは なくなってしまうわけです。これが原因でCSSファイルを読めない場合には、ブログは起動するものの 画面の色やレイアウトが反映されずにバラバラになります。
そういう場合には、 config.txt の base_url を blog.cgi, config.txt があるディレクトリのURLに書き換えてください。
http:// から始めて、最後に / をつけないでください。
(module/Init.pm の先頭部分のパスやURL設定はコメントのままにしておいてください)

例) base_url=http://server.name/user_name/blog

blog.cgiと同じディレクトリに置く index.html は http://ringworld.x0.com/blog/ のように  blog.cgi を指定しなかった場合に、ディレクトリリストを表示せず blog.cgi を呼び出すためのものです。 なくても問題はありませんが、セキュリティのため置いておくことをすすめます。


B. CGIとデータを別のディレクトリに置く場合

CGIは専用のディレクトリに置き、それで読み書きするデータは別のディレクトリに置かなければいけない場合には このようにしてください。

例として以下のようにします。

/home    /  user    /  public_html    /  blog    /  config.cgi
<img>
<data>
<template>
<skin>
<log>
 /  cgi-bin    /  ringblog    /  blog.cgi
tb.cgi
<module>

module/Init.pm の先頭部分にある下記項目に設定を記入してください。$*_url はディレクトリの URL、$*_dir はディレクトリのパスです。 (同じディレクトリでも URL と内部パスとは表記が違うことに注意)
以下は例ですが、自分の環境に合わせてください。

$base_dir = "/home/user/public_html/blog";
$base_url = "http://SERVER/blog";
$cgi_url = "http://SERVER/cgi-bin/ringblog";
$template_dir = "/home/user/public_html/blog/template";

$base_dirには config.cgi があるディレクトリへのパス
$base_urlには config.cgi があるディレクトリへの URL
$cgi_urlには blog.cgi があるディレクトリへの URL
$template_dirにはスタイルシートテンプレートがあるディレクトリへのパス

C. CGIとデータを別のディレクトリに置き、複数ユーザーが使う場合

ブログを複数ユーザーが使う場合には、それぞれのディレクトリにCGIスクリプトを置かず、共通で使える ディレクトリに置き、そのための設定をします。

例として以下のようにします。

/home  /  users  /  user_A  /  public_html  /  blog  /  config.cgi
<img>
<data>
<skin>
<log>
 /  user_B  /  public_html  /  blog  /  config.cgi
<img>
<data>
<skin>
<log>
 /  user_C  /  public_html  /  blog  /  config.cgi
<img>
<data>
<skin>
<log>
 /  <template>  
 /  cgi-bin  /  ringblog  /  blog.cgi
tb.cgi
<module>
  

スタイルシートテンプレートは全ユーザーが同じものを使うことになるので、各ユーザーのディレクトリ ではなく、共通で使えるデータディレクトリに置きます。

module/Init.pm の先頭部分にある下記項目に設定を記入してください。$*_url はディレクトリの URL、$*_dir はディレクトリのパスです。
以下は例ですが、自分の環境に合わせてください。

$base_dir = "/home/users";
$base_url = "http://SERVER/users";
$cgi_url = "http://SERVER/cgi-bin/ringblog";
$template_dir = "/home/user/public_html/blog/template";

$base_dirには各ユーザーのデータディレクトリが入っているディレクトリへのパス
$base_urlには各ユーザーのデータディレクトリが入っているディレクトリへの URL
$cgi_urlには blog.cgi があるディレクトリへの URL
$template_dirにはスタイルシートテンプレートがあるディレクトリへのパス

起動は以下のようにします。

http://SERVER/cgi-bin/ringblog/blog.cgi?uwd=USER_DIRECTORY

USER_DIRECTORYは上の例でいえば user_A, user_B, user_C などです。
このようにディレクトリを指定すれば、そこにあるconfig.cgiにしたがった動作となります。

2006-01-06