「VARS」のカスタマイズ

• 「VARS」とは
• 「/var/index.php」のしくみ
• F.A.Q

「VARS」とは

「VARS」とは、「VARIABLE(自由・可変の)」ページです。使用目的によってコンテンツを自由に拡張・追加・カスタマイズするためのページです。コンテンツの「ABOUT」ページやヘルプページ、リンクページ、その他、データベースを使わずファイルで管理したいコンテンツ部分に利用出来ます。

「/var/index.php」のしくみ

「/var/index.php」は、「/var/contents」ディレクトリに入っているテキストファイルやPHPファイルを読み込んでコンテンツ部分に表示するPHPプログラムです。サンプルとして「contents」内にはいくつかファイルが入っているので覗いてみて下さい。

var/index.php
   /contents/foo.html
            /foo.text
            /foo.txt
            /foo.inc.php
            /foo.php
            /foo.inc
            /default.inc.php

読み込めるファイルは、以下の形式です。(優先順位順)

1. 拡張子が「.inc.php」となっているPHPプログラム
2. 拡張子が「.php」となっているPHPプログラム
3. 拡張子が「.inc」となっているインクルードファイル
4. 拡張子が「.html」となっているhtmlファイル
   (注：ヘッダ部とフッタ部は取り除く)
5. 拡張子が「.txt」となっているテキストファイル
6. 拡張子が「.text」となっているMarkdown書式で記述されたテキストファイル

の6種類です。このような自作のテキストやPHPを追加して、コンテンツを追加出来ます。それぞれの使い分けは、

普通の整形済みテキストファイルを使う場合:

• foo.txt

Markdown書式テキストファイルを使う場合:

• foo.text

XHTMLタグでマークアップしたファイルを使う場合:

• foo.inc
• foo.html

実行可能なPHPファイルを使う場合:

• foo.inc.php
• foo.php
• foo.inc

...といった具合に使用して下さい。

デフォルトでは「/var/index.php」にアクセスすると

1. default.inc.php
2. default.php
3. default.inc
4. default.html
5. default.txt
6. default.text

の順でデフォルト用のファイルを探して読みにいきます。サンプルとして「default.inc.php」というファイル名の、あなたのP_BLOGが稼働しているシステムの情報を表示するPHPプログラムを入れてあります。オリジナルと差し替えるときは

1. default.inc.php
2. default.php
3. default.inc
4. default.html
5. default.txt
6. default.text

のいずれか一つを配置して下さい。

使用例

このマニュアルページ自体も、使用例です。このページのアドレスを見ると、

となっていると思います。このマニュアルファイルの実体は、

「contents」フォルダにある「ja_03.html」というテキストファイル

です。つまり、拡張子「.txt」や「.inc」、「.inc.php」を除いたファイル名の部分がパラメータとなって、idで呼ばれるようになっています。

手始めに、適当なテキストファイルに適当な文字、あるいは簡単にXHTMLタグを使ってマークアップした文書を書いてみて下さい。コンテンツ部分だけを記述するので、コーディングの際はヘッダ部分やフッタ部分は必要ありません。コンテンツ部に使うタグのみで、例えば通常のHTMLでしたら

<h1>タイトル</h1>
<h2>サブタイトル</h2>
<p>コンテンツ。<br />
改行してまたコンテンツ。</p>

整形済みテキスト形式を使いたい場合は、

<pre>
body{
    color:#000000;
    background:#ffffff;
    font-size:12pt;
}
</pre>

等のような感じでシンプルにマークアップします。

書き終わったら適当なファイル名をつけ、拡張子を「.html」にして「contents」フォルダに放り込んで下さい。そしてブラウザから

と、拡張子部分を抜いたファイル名をidで指定してアクセスすれば、このP_BLOGのコンテンツ部分にあなたの書いた文書が表示されるはずです。当然、ファイル名を日付けで管理したい場合も同様に行えます。例えば「20051115」という日付けをファイル名にしたい場合、ファイル名に拡張子を加えた「20051115.inc」とし「contents」に配置、アドレスを

と指定すればOKです。

.txtファイル使用上の注意

拡張子が「.txt」になっているテキストファイルは全て<pre>で括られ、整形済みテキストフォーマットとして扱われます(改行コードやスペースなどの表示がそのまま適用されます)。

F.A.Q