ハイパー日記システム Version 2.20

設定ファイルの記載方法

config.ph の設定

設定ファイルconfig.ph で最低限必要な項目は， Makefile または hns-setup で設定すれば，自動的に反映されます．

設定ファイルconfig.ph はウェブ日記ディレクトリ (~/public_html/diary/) にインストールされます．

config.ph では、システム設定、すなわち日記のタイトルやデフォルトの表示日数，カレンダーなどの表示の on/off などを指定します。出力される HTML についてのカスタマイズは、テーマ機能を用いて行います。

以下では，Makefile / hns-setup で設定できない項目の内容を説明します．

package HNS::System;

システムに関する設定を行います。

$DefaultMax: 日記URL に引数なしでアクセスしたときに表示する最近の日記の日数．デフォルトは 5日分．
$CookieFlag: クッキーによるユーザ追跡を使用しない時には OFF に設定してください。デフォルトは ON。
$AdminCookieFlag: 管理ページでクッキーを発行するかを設定します。この設定を変更する必要はありません。デフォルトは ON。
$CookieExpires: 送信するクッキーの有効期限を指定します。書式は '[+-][0-9]+[yMdhms]' 。デフォルトは 1か月 '+1M'。
$NoRedirect: クッキーによる読者の追跡を確実にするため、hns はデフォルトでは、リクエストに %7E が含まれる場合、~ へ変換した URL へ転送します。この転送をしたくない場合は、1 を設定して下さい。デフォルトは 1。
$CacheDir: キャッシュ・ファイル(xhnf) を保存するディレクトリを指定します。デフォルトは ~/diary/cache です。httpd の実行権限で書き込み可能である必要があります。通常この値を変更する必要はありません。
$Caching: キャッシュ機能を使用するかどうかです。デフォルトは 1 で使用します。キャッシュを使用する場合は、hnf の 1.5倍程のディスク容量がキャッシュ・ファイルのために必要です(つまりキャッシュを使用しない場合の 2.5倍程のディスク容量が必要になります)。ディスク容量が少ない場合は、次の $AllowCacheOnly を使用することを検討して下さい。
$AllowCacheOnly: この項目を 1 に設定すると、hnf がサーバ上になくてもキャッシュ・ファイルがすでに作成されていれば、キャッシュ・ファイルのみから日記を表示できるようになります。つまり確定した過去の hnf をサーバ上から削除することが可能となります。このためキャッシュ機能による高速な日記表示とディスク容量の節約の両方を達成できます。なお、hnf はあくまでサーバ上で削除できるだけであり、必ずバックアップを別に用意しておいて下さい。デフォルトは 0。
$AutoCacheClear: theme.ph, config.ph, alias.txt, rlink.txt を変更した場合は、過去の日記の表示に影響します。hns ではデフォルトでは、これらのファイルを監視して変更された場合は、キャッシュ・ファイルを全て消去してこれらの変更が反映されていない古いキャッシュを表示することはありません。この項目を 0 に設定すると、このキャッシュの自動消去機能をオフにします。デフォルトは 1。
$RefererLog: アクセス・ログを取らない時には OFF に設定して下さい。デフォルトは ON。
$LinkLog: リンク・ログを取らない時には OFF に設定して下さい。デフォルトは ON。
$CacheLog: キャッシュを呼び出された時にもアクセス・ログを取る時には ON に設定して下さい。デフォルトは OFF。
$RefererBATTALog: BATTA のアクセス・ログを別ファイル(referer_batta_log) に分離したい時は 1 に設定して下さい。デフォルトは 0。
$TZ: タイム・ゾーンです．通常は日本時間ですので，9 です．サーバのタイム・ゾーンにあわせて GMT との時間差を設定します．
$Lang: 日記を記述する言語です。デフォルトは ja (日本語) です。
$IgnoreReserved: 行頭の単語が大文字のみで構成されている場合、システムはそれをコマンドと見做し、もしそれがコマンドとして定義されていなかったら予約されているとして警告を発します。この警告を表示しないようにする場合は ON に設定して下さい。デフォルトは OFF。
$AlwaysReverse: ON に設定すると絶えず日記を最近のものから表示します。デフォルトは OFF。
$StrictCalendarLink: 1にすると、カレンダー部分で、hnfが存在しない月へのリンクを生成しないようにします。0にすると、hnfが存在しない月へのリンクも生成します。デフォルトは 1。
$ImgWidthMaxSize: あまり大きな画像を日記に張りつけた場合レイアウトが崩れてしまいます．それを防ぐため，ここで設定したピクセル以上の画像は， width をここで設定した値に指定されます．デフォルトは 300 となっています．
$FNCountStyle: 1 にすると、脚注のカウントを 1日毎に行います。0 に設定すると脚注のカウントがセクション(NEW)毎になります。デフォルトは 1。
$isystem: i system のインストールされたディレクトリを指定します。 i system への自動切換を行いたくない場合は、コメント・アウトして下さい。
$antenna: なつみかんへの更新時刻通知を行いたい場合、情報を送信する URL を記載します。デフォルトは空(とこにも通知しない)です。通知を行う場合、なつみかん側で受信を許可する設定が必要になります。
$IntelliSearch: IntelliSearch機能を有効にしたい場合は、1 にして下さい。デフォルトは 0 です。
$Mode: 日記生成のテンプレートに、動的生成用(dynamic)、静的生成用(static)、自動判別(auto)のいずれを使うかを設定します。デフォルトは auto。
$UseYoteiView: 1にすると、簡易予定表に記載されている当日の予定を、その日の日記冒頭に表示します。デフォルトは 0 です。

package HNS::Style;

スタイルに関する設定です。

$UnagiURL: Namazu for hns の検索プログラム(namazu.cgi) の URL を記述します。デフォルトは "namazu.cgi"
$NamazuURL: Namazu のホームページの URL を記述します。デフォルトは "http://www.namazu.org/"。
$CalendarUse: カレンダーを使用しない場合は OFF に設定してください。デフォルトは ON。
$DirectCalendarUse: 日付ジャンプ・ボタンを使用しない場合は OFF に設定して下さい。デフォルトは ON。
$PIMUse: PIM機能(予定表、TODO)を使用しない場合は OFF に設定して下さい。デフォルトは ON。
$TitleListUse: タイトル一覧フォームを使用しない場合には OFF に設定して下さい。デフォルトは ON。

package HNS::PIM::Schedule;

予定表示に関する設定です。

$MaxNum: 表示する最大件数です．デフォルトは 8件．
$Range: 表示対象となる予定の範囲(月)を指定します。デフォルトは 1 (1か月先までの予定を表示対象とする) です。
$RRange: 繰り返し予定の表示対象となる予定の範囲(月)を指定します。デフォルトは $Rangeの値です。
$GraceDays: 過去の予定を遡って表示する日数を指定します。デフォルトは 0 (遡らない)です。
$PrintOverMaxNum: $MaxNum 番目の予定と同じ日に別の予定があった場合の動作を指定します。 1 にすると、同じ日の予定を全て表示します。その場合、表示件数は $MaxNum 件を越える事もありえます。デフォルトは 0 (上から優先して表示し、全部で $MaxNum 件を越えないようにする) です。

package HNS::PIM::Todo;

To Do 表示に関する設定です。

$MaxNum: 表示する最大件数です．デフォルトは 8件．

package HNS::Hnf::Command::Image;

画像コマンドに関する設定です。

$AllowRemoteImage: 1にすると、他のサーバにある画像も表示する事ができます。デフォルトは 0。

package HNS::Tools::Title;

タイトル一覧に関する設定です。

$Range: タイトル一覧に引数なしでアクセスした場合の表示する期間(月)。デフォルトは 1か月。

package Board;

掲示板機能に関する設定です。

$UseBoard: 1 にすると、掲示板機能を使います。デフォルトは 0 (使わない)。

$BoardData: 掲示板データの保存場所を指定します。デフォルトは "${HNS::System::DiaryDir}/data/boarddata.txt"。

$ThreadsPerPage: 掲示板で、1ページに何スレッド表示するかを指定します。デフォルトは 5。

$MaxArticle: 掲示板が保存する記事数を指定します。デフォルトは 100。

$RecentView: 掲示板で記事を一覧表示したときに表示される個数を設定します。デフォルトは 10。

$RecentTime: 掲示板の記事タイトルで何秒前まで[NEW!]の表示をするか指定します。 0を指定した場合は、表示されません。 0以外の場合でも日記本文には表示されません。デフォルトは 2 * 24 * 60 * 60。

$Title: 掲示板タイトルを指定します。デフォルトは 'Web Board'。

$HnsPath: 掲示板上でリンクする日記のURIを指定します。デフォルトは $HNS::System::MyDiaryURI。

$BoardOnHNS: 日記上に掲示板の記事を表示するか指定します。 0 = 無効、10 = 本文以外を表示、20 = 本文も表示です。デフォルトは 10。

$BodyLenOnHNS: $BoardOnHNSで20を指定した場合に、本文を何文字まで表示するか指定します(タグも含む)。 0を指定した場合、文字数制限をしません。 0でない場合、
は取り除かれます。デフォルトは 80。

$HideReadLinkWhenNoMsg: 1を指定した場合、日記記事に対する掲示板記事が存在しない場合、コメントを読むためのリンク文字列が表示されません。 0を指定した場合、掲示板記事が存在しなくてもリンク文字列を表示します。デフォルトは 1。

ハイパー日記システム Version 2.20

Index