Plugins/DIARYCATEGORY

ID: 12 | 作成日: 2011/09/01 [Thu] 21:01:00 | 最終更新: 2011/11/11 [Fri] 09:38:16
FrontPage / Plugins / DIARYCATEGORY

概要

要素 実行の可否
行頭
インライン 不可
複数の記述 不可

DIARYプラグインで作成された日記から、指定の日記ページやエピソードをインクルードしてブログのカテゴリのようなページを作成します。

書式

#DIARYCATEGORY(最大表示件数){日記名}

すべて省略できます。
その場合は、ページ名から日記名を判断し、1ページ辺り10件分の日記や日記タイトルが表示されます。

引数

最大表示件数
1ページ辺りに表示する日記やエピソードを"1~10"の間で指定します。
指定なしや範囲外の数値が指定された場合は"10"となります。
日記名
日記の基準となるページ名を指定します。
"Diary"とした場合は、"Diary"の下位ページ("Diary/"から始まる日記ページ)が対象のページとなります。
指定なしの場合は、ページ名から自動で日記名を判断します。

カテゴリ

カテゴリの指定の方法

日記カテゴリの登録フォーム

ログインしている場合は、プラグインを記述した位置にカテゴリ登録フォームが表示されます。

日付*
登録したい日記の日付を指定します。
"日付の日記を登録する"の項目にチェックが入っていない場合は、日付を設定しても登録されません。
日付の日記を登録する*
こちらの項目にチェックを入れることで、"日付"で指定した日の日記がカテゴリに登録されます。
タイトル
登録したい日記エピソードのタイトルを指定します。
前述の日付の項目で設定された日記に指定のタイトルがある場合は、日記のカテゴリにタイトルの日記エピソードが登録されます。
リスト*
カテゴリに登録されている日記のリストが表示されます。
こちらに直接、日記を登録することもできます、また日記をカテゴリから登録解除したい場合も、こちらを編集します。
詳しくは、こちらをご覧ください。

"ページを登録"ボタンをクリックすることで、日記がカテゴリに登録されます。

"リスト"の入力フォームについて

"日付"や"タイトル"以外にも、"リスト"の入力フォームを直接編集することで、カテゴリの指定や削除を行うことができます。

カテゴリに指定したい日記を、"日記の年月日"または"日記の年月日#日記のタイトル"という形式で一行ずつ書き込んでいきます。
なお、日記のタイトルに関する説明は、"ドキュメント"の該当項目をご覧ください。

たとえば、2011年8月31日の日記と2011年9月1日の"今日の出来事"というタイトルのエピソードを"日常"のカテゴリに指定する場合は、"Diary/Category/日常"のページのカテゴリ投稿フォームに以下のように書き込みます。

20110831
20110901#今日の出来事

指定された日記が年月日のみの場合、その日付の日記にふたつ以上のエピソードが含まれても最大表示件数では"ひとつ"として扱われます。

登録を解除したい場合は、その日記の日付やタイトルをリストから削除して"ページを登録"ボタンをクリックしてください。

日記のパーマリンク

DIARYENTRYコマンドが有効の場合は、日記の各エピソードのタイトルに"DIARYENTRYコマンドを実行するパラメーター付きページリンク"(パーマリンク)が表示されます。

日記のエピソードやDIARYENTRYコマンドについては、ドキュメントの該当項目およびDIARYENTRYコマンドの説明ページをご覧ください。

プラグインの設定

スクリプトに直接書き込む項目

$strCategoryBase*
カテゴリの基準となる名称。

カテゴリのページ名について

"$strCategoryBase"で設定された文字列と日記名を合わせたページ名がカテゴリの基準ページとなります。

日記のカテゴリページは、必ず以下のような形式にしてください。

日記名/カテゴリページの基準名/カテゴリ名

上記の形式でなくても、カテゴリページの作成や日記の登録は可能ですが、DIARYLISTプラグインを利用したカテゴリリストの作成は行えなくなるので、ご注意ください。

日記名が"Diary"、"$strCategoryBase"の設定が"Category"の場合は、カテゴリページの基準となる上位ページは以下のようになります。

Diary/Category

上記に続くページ名がカテゴリ名となります。

// カテゴリ"日常"
Diary/Category/日常

// カテゴリ"プログラミング"
Diary/Category/プログラミング

なお、引数に日記名が設定されていない場合は、日記の基準となる日記名はページ名から自動で判断します。
上記の"Diary/Category/日常"のようなページ名の場合、ページ名からカテゴリ基準名"Category"とカテゴリ名"日常"を省いた"Diary"を日記名として扱います。

"プラグイン設定"から指定する項目

一回のみ実行するプラグイン
取り込んだ1ページ目のみで実行させたいプラグインを指定します。
1行にひとつずつ記述することで、複数のプラグインを指定できます。
無効化するプラグイン
指定されたプラグインは無効化されます。
1行にひとつずつ記述することで、複数のプラグインを指定できます。

備考

ページのデータディレクトリに、"diarycategory.txt"という登録された日記の一覧が記録されたデータファイルが作成されます。

キャッシュディレクトリに、"diarydatas.日記名を基にした識別文字列.cache"というファイル名の日記ページ一覧を記録したキャッシュが作成されます。