こざくら日和 : Manual

「VARS」のカスタマイズ

「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

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

使用例

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

../man/index.php?id=ja_03

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

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」フォルダに放り込んで下さい。そしてブラウザから

..../var/index.php?id=あなたのつけたファイル名

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

..../var/index.php?id=20051115

と指定すればOKです。

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

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

F.A.Q

Q1: 「VARS」ディレクトリ下にさらに「VARS」ディレクトリを作れますか?

A1: 簡単に作れます。

「VARS」を拡張してコンテンツ別に分けてディレクトリを作って整理したり、親ディレクトリの下にさらに子ディレクトリを作りたい場合、以下のようにします。

  1. /vars-sample/」というサンプルディレクトリが「/var/」ディレクトリに入っていますので、複製します。
  2. /vars-sample/index.php」をテキストエディタで開き、「USER CONFIG」部分を編集し、ホームディレクトリからの階層レベルや、付けたいタイトル、ディレクトリ名などを記述します。
  3. 以上です。