環境設定

設定

Blosxomの全ての設定は簡単のためスクリプト自身に書かれています。恐れる事はありません。全てに面白い文字が付いていますし、本当に単純です。標準では以下のようになっています:

# --- Configurable variables -----

# What's this blog's title?
$blog_title = "My Weblog";

# What's this blog's description (for outgoing RSS feed)?
$blog_description = "Yet another Blosxom blog."; #

# What's this blog's primary language (for outgoing RSS feed)?
$blog_language = "en";

# Where are this blog's entries kept?
$datadir = "/Library/WebServer/Documents/blosxom"; #

# What's my preferred base URL for this blog (leave blank for automatic)?
$url = "";

# Should I stick only to the datadir for items or travel down the
# directory hierarchy looking for items?  If so, to what depth?
# 0 = infinite depth (aka grab everything), 1 = datadir only, n = n levels down
$depth = 0;

# How many entries should I show on the home page?
$num_entries = 40;

# What file extension signifies a blosxom entry?
$file_extension = "txt";

# What is the default flavour?
$default_flavour = "html"; #

# Should I show entries from the future (i.e. dated after now)?
$show_future_entries = 0;

...

# --------------------------------

各設定ディレクティブは設定名で構成されています(例 $static_dir、 =記号、設定値(例 "/Library/WebServer/Documents/blog" 文字の場合は"で囲みます。数字の場合は"で囲みません)。設定値を変える場合には望む値で単純に置き換えれば良いです。"があった場合には残して置いて下さい。

例えば、ウェブログのタイトルを標準から変更するには(My WeblogからSam's Insightsに)次のようになります:$blog_title = "Sam's Insights";

分かりましたか? 良いでしょう。次に進みましょう。

$blog_title

ウェブログの標準のタイトル。このタイトルはフレーバーテンプレートで使えます。またシンジケートRSSのタイトルとしても使われます。

$blog_description

ウェブログの標準の説明文。この説明文はフレーバーテンプレートで使えます。またシンジケートRSSの説明文としても使われます。

$blog_language

シンジケートRSSではウェブログの言語を表します。標準では英語です。他の言語の省略形はここで得られます。

$datadir

最も重要な設定で、$datadirは記事がどこにあるかBlosxomに知らせます。フルパスでディレクトリを指定します。

$url

空にしておくとBlosxomはウェブログのURLが何であるかを自動的に検出します。多くの場合はこれでうまく行きます。自分で指定したい時は変更します(例 $url = "http://www.raelity.org/";)。

$depth

カテゴライズしたり共有したりするまでは放っておくのがベストです。この設定はBlosxomがデータディレクトリのみを見るか、それとも階層を下に辿っていくかを指定します。

$num_entries

ウェブログのホームページでBlosxomが幾つの記事を表示するかを数字で指定します。これによって古い記事がずっとページの下に表示されるようにするか、それとも表示されないようにするか(たくさんウェブログを書く場合)を調整できます。

$file_extension

Blosxomは標準で$datadir内の.txtで終わるファイルを探しますが、$file_extensionを変更すればそれを変えることが出来ます。

例 my $file_extension = "blosxom";
Blosxomwelcome.blosxomwhat_i_ate_for_breakfast.blosxom等を探します。

$default_flavour

この設定は標準で使うフレーバーを決定します。

$show_future_entries

この設定は未来の日付を持つウェブログを表示するか ($show_future_entries = 1)、それともその日が来るまで隠しておくか ($show_future_entries = 0)を決定します。後者がデフォルトです。未来の日付を付けるにはtouchコマンドを使う必要があります。それに付いてもっと知りたければ"man page"Unixのマニュアル)を見て下さい。

残りの設定はプラグインと静的表示に関するもので、その時が来たら読めば良いでしょう(このページの上で既に説明しています)。