さんごよみ カスタマイズ方法

ページ全体を作る《カバースキン》ファイル「skin-cover.html」の編集方法（キーワードの一覧と書き方）

カバースキンファイル「skin-cover.html」は、CGIが出力するページ全体を作るスキン(テンプレートHTML)ファイルです。テキストエディタやホームページ作成ソフトなどで編集できます。以下のキーワードを含めておくことで、CGI側が各情報を挿入して表示します。

【基本要素：月間スケジュールカレンダー関連】

HTML内に、[[SCHEDULE:CALENDAR]] と記述すると、その位置に月間カレンダーが挿入されます。(1スキン内で1回のみ記述できます。)
HTML内に、[[EDIT:CALENDAR:URL]] と記述すると、月間スケジュールの編集画面TOPのURLが挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[NAVI:CALENDAR:PREV:URL]] と記述すると、前の期間のカレンダーを表示するためのURLが挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[NAVI:CALENDAR:NEXT:URL]] と記述すると、次の期間のカレンダーを表示するためのURLが挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[NAVI:CALENDAR:PERIOD]] と記述すると、1ページに表示されるカレンダーの数が挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[RSS:URL]] と記述すると、その位置に月間スケジュールをRSSフィードで出力するためのURLが相対パスで挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[RSS:URL:FULL]] と記述すると、その位置に月間スケジュールをRSSフィードで出力するためのURLが絶対URLで挿入されます。(1スキン内で何回でも記述できます。)

RSSフィードに含まれるのは、月間スケジュールカレンダーに表示される予定だけです。1週間の汎用予定表や、長期予定表の内容は含まれません（それらをRSSで配信する方法は、今のところありません）。

【基本要素：1週間の汎用予定表関連】

HTML内に、[[SCHEDULE:WEEKLY]] と記述すると、その位置に1週間の汎用予定表が挿入されます。(1スキン内で1回のみ記述できます。)
HTML内に、[[EDIT:WEEKLY:URL]] と記述すると、1週間の汎用予定の編集画面のURLが挿入されます。(1スキン内で何回でも記述できます。)

【基本要素：長期予定表(掲示板)関連】

HTML内に、[[SCHEDULE:LONGRANGE]] と記述すると、その位置に長期予定表(掲示板)が挿入されます。(1スキン内で1回のみ記述できます。)
HTML内に、[[EDIT:LONGRANGE:URL]] と記述すると、長期予定表の編集画面TOPのURLが挿入されます。(1スキン内で何回でも記述できます。)

【基本要素：その他】

HTML内に、[[SITUATION]] と記述すると、表示する投稿が限定されている場合(年月日別表示や検索結果など)に、限定内容を案内する文言がプレーンテキストで挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[SITUATION:HTML]] と記述すると、表示する投稿が限定されている場合(年月日別表示や検索結果など)に、限定内容を案内する文言がHTMLで挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[SITUATION:TITLE]] と記述すると、表示する投稿が限定されている場合(年月日別表示や検索結果など)に、限定内容を案内する文言がプレーンテキストで挿入され、(何かが挿入される場合に限っては)末尾に「-」記号が付きます。主にtitle要素内で使うことを想定していますが、他の場所でも使えます。(1スキン内で何回でも記述できます。)
HTML内に、[[SITUATION:CLASS]] と記述すると、そのとき表示されている状況を示すキーワードが半角空白区切りで挿入されます。主にbody要素のclass属性値で使うことを想定しています。詳しくは「そのときの表示状況に応じてページデザインを切り替える方法」をご参照下さい。(1スキン内で何回でも記述できます。)
HTML内に、[[LOGINCHECKER]] と記述すると、ログイン状態に応じて表示を切り替えるのに必要なコードが挿入されます。(1スキン内で何回でも記述できます。)

[[LOGINCHECKER]]で挿入される『ログイン状態に応じて表示を切り替えるのに必要なコード』は、ログインされていない状態で何かを非表示にするような必要がなければ、書かなくても問題ありません。

【細かな情報要素】

HTML内に、[[INFO:LASTUPDATE]] と記述すると、最終更新日時が「YYYY/MM/DD hh:mm:ss」形式で挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[INFO:LASTUPDATE:表記方法]] と記述すると、最終更新日時が任意の表記形式で挿入されます。書き方は内側スキンの[[DATE]]と同じです。(1スキン内で何回でも記述できます。)

【システムナビゲーション要素】

HTML内に、[[ADMIN:URL]] と記述すると、その位置に管理画面(コントロールパネル)のURLが相対パスで挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[ADMIN:URL:FULL]] と記述すると、その位置に管理画面(コントロールパネル)のURLが絶対URLで挿入されます。(1スキン内で何回でも記述できます。)

【多目的フリースペース要素】

HTML内に、[[FREESPACE]] と記述すると、その位置に多目的フリースペースとして登録された文章が挿入されます。標準スキンでは、月間スケジュールカレンダー用の凡例表示枠として使っていますが、そのほか何の表示目的にも活用可能です。(1スキン内で何回でも記述できます。)
HTML内に、[[FREESPACEEDIT:URL]] と記述すると、その位置に多目的フリースペースを編集できる管理画面へのURLが挿入されます。編集用リンクを作りたい場合に使えます。(1スキン内で何回でも記述できます。)

【ヘッダ・フッタ向けフリースペース要素】

HTML内に、[[FREE:TITLE:MAIN]] と記述すると、その位置に主タイトルとして設定された文字列(設定画面のフリースペース内で設定できます)が挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[FREE:TITLE:SUB]] と記述すると、その位置に副タイトルとして設定された文字列(設定画面のフリースペース内で設定できます)が挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[FREE:DESCRIPTION]] と記述すると、その位置に一行概要文として設定された文字列(設定画面のフリースペース内で設定できます)が挿入されます。(1スキン内で何回でも記述できます。)
HTML内に、[[FREE:HOMELINK]] と記述すると、その位置にウェブサイトHOMEへ戻るリンクが挿入されます。てがろぐHOMEへ戻るリンクではないので注意して下さい。リンク先は、設定画面のフリースペース内で設定できます。(1スキン内で何回でも記述できます。)

上記のキーワードは主に、ページのヘッダ部分やフッタ部分で使われることを想定したフリースペースです。しかし、スキンの書き方次第では、ヘッダやフッタ以外でも自由に使えます。

【汎用要素・その他】

HTML内に、[[RANDOM:10]] と記述すると、その位置に1～10の間のランダムな整数(1と10を含む)が半角テキストで挿入されます。値は10以外でも、1桁～10桁の範囲で任意の数値を指定できます。(1スキン内で何回でも記述できます。外側スキン・内側スキン両方で使えます。)
HTML内に、[[CHARCODE]] と記述すると、CGIの文字コード名が挿入されます。(1スキン内で何回でも記述できます。) ※標準では「UTF-8」です。
HTML内に、[[VERSION]] と記述すると、CGIの名称とバージョン番号が挿入されます。(1スキン内で何回でも記述できます。) ※この記述が1度もない場合は、CGI側が強制的にHTML末尾に同文を挿入します。スキン内にこの表記を使っておく方が、望み通りにデザインを作れるでしょう。この表示を見えなくしたり、極端に見えにくくしたりしないで下さい。

【ファイル合成・ライブラリ読み込み】

HTML内に、[[INCLUDE:ファイル名]] と記述すると、その位置に指定ファイルの中身がそのままが挿入されます。SSI(Server Side Include)やPHPのincludeのように動作します。例えば [[INCLUDE:apple/pen.html]] と記述すると、その位置にappleフォルダのpen.htmlの中身がそのまま挿入されます。ファイルは相対パスで記述して下さい(※注)。(1スキン内で何回でも記述できます。)

※注：相対パスでの記述は、スキンファイルの位置に関係なく、『CGI本体の存在する位置からの相対パス』で指定する必要がある点にご注意下さい。
※CGI本体よりも上位のディレクトリを参照したい場合は「../」の記述が使えます。この上位ディレクトリの参照を禁止する設定も可能です。その設定は、CGIソースの冒頭付近で変更できます。

HTML内に、[[JS:LIGHTBOX]] と記述すると、その位置にLightboxが必要な場合(※)に限って、Lightboxを読み込むために必要なJavaScriptが挿入されます。具体的には、CDN経由でLightbox用CSSとJavaScriptが読み込まれます。(1スキン内で1回のみ記述できます。)
HTML内に、[[JS:LIGHTBOX:JQ]] と記述すると、その位置にLightboxが必要な場合(※)に限って、jQueryとLightboxを読み込むために必要なJavaScriptが挿入されます。具体的には、CDN経由でjQuery本体と、Lightbox用CSSとJavaScriptが読み込まれます。(1スキン内で1回のみ記述できます。)

※「Lightboxが必要な場合」とは、投稿内に画像が1枚でも掲載されている状況で、その画像にLightbox用の属性「data-lightbox」が記述されている場合です。（外側スキンファイルに直接何かを記述している場合など、投稿以外の部分にLightboxを必要とする記述があっても反応しませんのでご注意下さい。その場合は、[[JS:LIGHTBOX]] を使うのではなく、常時Lightboxを読み込むようなHTMLをスキンに直接記述して下さい。）

カレンダーの1日分を作る《1日スキン》ファイル「skin-oneday.html」の編集方法（キーワードの一覧と書き方）

《1日スキン》ファイル「skin-oneday.html」は、カレンダー内側の1日分を表示する部分を作るためのスキン(テンプレートHTML)ファイルです。下記のキーワードはどれも、1スキン内に何度でも挿入できます。（1度も使わない項目があっても構いません。）

【カレンダー日時表示関連要素】

HTML内に、[[DAY:NUMBER]] と記述すると、その位置に日付(日の数値)が挿入されます。年月は含まず「日」の数字だけです。主に、カレンダー内で日付数字を表示する目的で使います。
HTML内に、[[DAY:NAME]] と記述すると、その位置に祝日名・記念日名が挿入されます。祝日でも記念日でもなく、振替休日でもない場合は、何も挿入されません。

HTML内に、[[DATE:日付書式]] と記述すると、その位置に日付が指定の形式で挿入されます。

「日付書式」の部分には任意の文字列を指定でき、下表のように解釈されます。取捨選択も掲載順序も自由です。同じ文字を何度も使えます。大文字・小文字は区別するので注意して下さい。下記以外の文字はそのまま出力されます。

記号	挿入内容	挿入例または範囲	備考
Y	年 (西暦)	2022
y	年 (西暦下2桁)	22
R	年 (和暦:元号+年)	令和4	数字の桁数は不定
r	年 (和暦:年のみ)	4	数字の桁数は不定
M	月 (2桁固定)	01 ～ 12	1桁なら先頭に0を付加
G	月 (1～2桁)	1 ～ 12	1桁は1桁のまま
J	月名(和暦)	睦月～師走
E	月名(英語)	January ～ December
e	月名(英略)	Jan ～ Dec	英字3文字
D	日 (2桁固定)	01 ～ 31	1桁なら先頭に0を付加
N	日 (1～2桁)	1 ～ 31	1桁は1桁のまま
W	曜日(英語)	Monday ～ Sunday
w	曜日(英略)	Mon ～ Sun	英字3文字
B	曜日(和名)	月曜日～日曜日	漢字3文字
b	曜日(和略)	月～日	漢字1文字
A	相対時間(前後付)	3秒前、5分前、12日前	投稿後の経過時間(※)
a	相対時間(前後無)	3秒、5分、12日	投稿後の経過時間(※)
h	時	00 ～ 23	2桁固定
m	分	00 ～ 59
s	秒	00 ～ 59

※時(h)・分(m)・秒(s)の指定に意味はありません。
このCGIは、お手軽マイクロブログCGI「てがろぐ」と一部の仕様を共有しているため、上記には「時/分/秒」を挿入する書式も含まれています。しかし、カレンダーを表示する上で「時/分/秒」に意味はないため、「時/分/秒」を挿入するような記述を加えても「00」が固定的に出力されるだけで、意味はありません。

例えば、[[DATE:Y年M月D日(w)]] と記述すると、「2024年11月20日(Wed)」の形式で挿入されます。
例えば、[[DATE:R年(Y年)G月N日B]] と記述すると、「令和4年(2022年)5月16日月曜日」の形式で挿入されます。
例えば、[[DATE:Y-M-D]] と記述すると、「2024-11-20」の形式で挿入されます。
例えば、[[DATE:M月(J)のN日]] と記述すると、「6月(水無月)の8日」の形式で挿入されます。

上表以外の文字はそのまま出力される仕様ですが、半角英字に関しては今後の機能追加によって新たな挿入記号として使われる可能性がありますので、半角英字は「そのまま表示される」という前提では使わない方が無難です。

【スケジュール表示要素】

HTML内に、[[SCHEDULE:SUMMARY]] と記述すると、その位置に概要として登録されたスケジュール本文が挿入されます。
HTML内に、[[SCHEDULE:DETAIL]] と記述すると、その位置に詳細として登録されたスケジュール本文が挿入されます。
HTML内に、[[EDITURL]] と記述すると、その位置にその日付のスケジュールを編集するための編集ページの固有URLが挿入されます。（ログインしていない状態でこのURLにアクセスした場合は、ログイン画面が先に表示されます。）

【投稿ユーザ関連要素】

HTML内に、[[USERID]] と記述すると、その位置に投稿者のID名が挿入されます。
HTML内に、[[USERNAME]] と記述すると、その位置に投稿者の表示名が挿入されます。表示名が設定されていないユーザや、既に削除されたユーザの場合はデフォルト設定の名称(標準では「？」)が代わりに挿入されます。
HTML内に、[[USERICON]] と記述すると、その位置に投稿者のアイコン画像がimg要素を使って挿入されます。アイコン画像が設定されていないユーザや、既に削除されたユーザの場合は、デフォルト設定のアイコンが表示されます。

ユーザ別にスケジュールを閲覧するような機能はありません。あくまでも、「そのスケジュールを最後に編集したのは誰か」が分かるだけです。

【その他】

HTML内に、[[RANDOM:10]] と記述すると、その位置に1～10の間のランダムな整数(1と10を含む)が半角テキストで挿入されます。値は10以外でも、1桁～10桁の範囲で任意の数値を指定できます。(この記述は、外側スキン・内側スキン両方で使えます。)

スキン編集の補足

HTML内のその他の部分は、何でも自由に書き換えることができます。
付属のスキンファイルを参考にして編集すれば、楽にカスタマイズできるでしょう。

スキン内に記述したキーワードが認識されない場合は、以下の点を確認してみて下さい。
- 括弧が二重になっているか？
  →[DATE] や [[DATE] では認識されません。[[DATE]] のように開始括弧も終了括弧も二重になっているかどうか確認して下さい。
- 余計な空白文字が入っていないか？
  →括弧とキーワードの間は詰めて記述する必要があります。空白があると認識されません。
- 半角の大文字で記述しているか？
  →括弧とキーワードは半角文字でしか認識されません。また、英字は大文字でしか認識されません(※日付の指定文字列や識別子は除く)。