スキンの作り方::動作設定　『skin.cgi』 | RGT Download Site

rgt.cgi、main.html、reg.html、edit.html はこのファイルをベースにして動きます。
使うことのできる項目はこのファイルで管理されていて、用意したい項目や項目の名前はここで設定します。 （項目とは「コメント」や「特技」などのことです）
要点を絞って解説します。

スキンの名前・バージョンなど
主に RGT が、今どのような名前のスキンを使用しているか、判断するためのものです。
あまり神経質にここを変える必要はないと思います。
main.html で使用できるタグ !ver! で表示されるテキストです。


登録できる画像のサイズ設定
(横幅、縦幅) ピクセル数指定です。


曜日のテキスト設定
main.html で使用できるタグ !wd! で表示される日時（曜日）のテキストです。
日曜から土曜日まで。


月のテキスト設定
main.html で使用できるタグ !mon! で表示される日時(月)のテキストです。
1月～12月まで。


日時の数値設定
main.html で使用できるタグ !mo! !da! で表示される半角数字の日時(月、日)が10 より小さいとき、先頭に 0 を付けます。（0=付けない 1=付ける)

RGT では、エントリ（記事）にランク（例：役職等）を割り振り、ランクごとに並べて表示させることができます。


ページ表示時に、 @rank に設定された値の←(左側)のものから上位に並び、また各ランクの最大登録数を @rank_max にて設定できます。 main.html のテンプレート（エントリ部）をランクごとに変えることもできます。（詳細は『HTMLテンプレート』カテゴリ参照）
※注意！：ランクに使える文字は半角英数字に限定されます。

実際の使用例

上記のように設定した場合、エントリが「1.Guildmaster 2.Member」の順序に並べられ、 「最大登録数は GuildMaster が 1、 Member が上限なし(0=上限なし)」となります。
（上限なしであっても、config.cgi の $max を超える数は登録できません）

RGT では、項目は無制限に用意できます。


例えばこのように記述します。


こう記述すると、RGT は『項目名（タグ名）「age」・詳細名「年齢」という項目を１つ使う』と認識します。

ここで設定された項目は、main.html、reg.html、edit.html でタグとして使うことが出来ます。（この場合、!age! と ?age? が使用できるようになる）

skin.cgi

main.html、reg.html、edit.html

実際に表示されるページのHTML

と、このように利用します。

つまり skin.cgi、各テンプレートファイル、そして実際に表示されるページは関連しあっているわけです。『HTML テンプレート』のカテゴリもご覧になってください。

登録・変更フォームでは通常、各項目はテキストボックス <input type="text"> や テキストエリア <textarea></textarea> として使われますが、選択メニュー（<select>～</select>）として使う場合の記述です。
メニューの内容は半角の「,(コンマ)」で区切り追加していきます。


大量のメニューを作成する場合、


と分けて書くこともできます。
※この場合、メニュー内容は「項目A～項目I」となります。

規則的な数値で構成されるメニューを大量作成する場合、

とすることで楽に作成できます。 ただし、この扱いには注意してください。 あまりにも大量の選択肢を作成する場合、処理にとても時間が掛かり負荷も大きくなります。 選択肢数は多くても1000個以内に留めてください。 選択肢が多すぎると実際に選ぶときも面倒になるので、 普通にテキストボックスにした方がいい場合も多いはずです。

登録・変更フォームでは各項目が正しく入力されているか調べる必要があります。 登録・変更の実行時に、どのようなチェックを行うかをここで設定します。 1 なら入力されているか確認します。(必須項目とする場合に設定します) 0 でオフです。 初期設定は 0 なので確認が不要な項目は記述しなくて構いません。
(0=オフ 1=項目が入力されているか？)


ただ、これでは簡単なチェックしか出来ないため、詳細なチェックを行いたい場合は、JavaScript などでチェックルーチンを自作された方がいいでしょう。

通常、データ登録時に全項目の改行を取り除いています。(データ保存上問題があるためです) しかし <textarea></textarea> の項目など（コメントとか）改行を残しておきたい場合もあります。 その場合、以下の記述をします。
(0=改行を取り除く 1=改行を残す)

メインページの表示処理に、Perl スクリプトを追加することができます。
Perl の知識が必要ですので注意してください。 skin.cgi の中では自由に変数・サブルーチンなどを追加できます。 また、rgt.cgi 側の変数やサブルーチンを参照する場合、 名前空間が違うため(パッケージ化されているため)先頭に「 rgt:: 」を付加するようにしてください。 ほか、 $skindir でスキンディレクトリのパスが参照可能です。
具体例としては、リストスキンのようなことができます。

各サブルーチンの動作と実行タイミングは以下のとおりです。
いずれもメインページの表示処理時に実行されます。

sub header { ～ }

ヘッダー部表示の直前に実行されます。

sub member { ～ }

エントリ部表示の直前に実行されます。

sub footer { ～ }

フッター部表示の直前に実行されます。

member サブルーチンは、エントリが表示されるたびに実行されます。実際には表示されないエントリ時にも実行されます。（登録数分、実行されるということです）