Movable Type タグリファレンス: サブカテゴリー関連タグ
MTEntriesWithSubCategories
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTEntriesWithSubCategories> ~ </MTEntriesWithSubCategories>
エントリーの一覧のためのコンテナ・タグです。MTEntriesタグと異なり、サブカテゴリーを指定できます。アトリビュートcategoryで、サブカテゴリーを指定できます。例えば、"Flies"というカテゴリーがあり、その下に"Fruit"というサブカテゴリーがある場合は、category="Flies/Fruit"と指定します。カテゴリーやサブカテゴリーに"/"が含まれる場合は、そのカテゴリー名を[](角カッコ)で囲みます。
アトリビュート
- lastn="N"
- 指定した数字(N)の記事を表示します。Nは0より大きな数字にしてください。
- category="category_name"
- 指定したカテゴリーやサブカテゴリーを表示します。カテゴリーがサブカテゴリーを持つ場合は、そのサブカテゴリーも対象になります。このアトリビュートでは「OR」を使ってください。
- author="author_name"
- 指定した筆者の記事をすべて表示します。記事数を指定するときはlastnを併用してください。
- days="N"
- 指定した日数以内の記事をすべて表示します。daysは単独で使います。ほかのオプションと併用すると、daysが無視されます。
- recently_commented_on="N"
- 最近コメントが付いた記事を指定した数だけ表示します。
- sort_order="ascend | descend"
- エントリーを並べる順序を指定します。ascendを指定すると昇順、descendは降順になります。
- sort_by="title | status | modified_on | author_ID | excerpt"
- エントリーを並び替える対象を指定します。title(エントリーのタイトル)、status(投稿状態:下書き/公開)、modified_on(変更日時)、author_id(投稿者ID)、excerpt(概要)が指定できます。
MTHasNoParentCategory
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTHasNoParentCategory> ~ </MTHasNoParentCategory>
現在のカテゴリーに親カテゴリーが存在しないときだけ実行する条件タグです。
MTHasNoSubCategories
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTHasNoSubCategories> ~ </MTHasNoSubCategories>
現在のカテゴリーにサブカテゴリーが存在しないときだけ実行する条件タグです。
MTHasParentCategory
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTHasParentCategory> ~ </MTHasParentCategory>
現在のカテゴリーに親カテゴリーが存在されているときだけ実行する条件タグです。
MTHasSubCategories
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTHasSubCategories> ~ </MTHasSubCategories>
現在のカテゴリーにサブカテゴリーが登録されているときだけ実行する条件タグです。
MTIfIsAncestor
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTIfIsAncestor> ~ </MTIfIsAncestor>
現在のカテゴリーが、指定したカテゴリーをサブカテゴリーとして含んでいるか判定する条件タグです。アトリビュートchildで対象とするカテゴリーを指定します。
アトリビュート
- child="category_name"
- 判定するサブカテゴリー名を指定します。
MTIfIsDescendant
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTIfIsDescendant> ~ </MTIfIsDescendant>
現在のカテゴリーが、指定したカテゴリーのサブカテゴリーにあたるか判定する条件タグです。アトリビュートparentでカテゴリーを指定します。
アトリビュート
- parent="category_name"
- 判定する親カテゴリー名を指定します。
MTParentCategories
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTParentCategories> ~ <MTParentCategories>
最上位のカテゴリーから現在のカテゴリーまでを繰り返して表示するコンテナ・タグです。アトリビュートglueにより、カテゴリーをつなげる文字を指定できます。また、アトリビュートexclude_currentを指定することで、現在のカテゴリーを除外できます。
アトリビュート
- glue="XX"
- リストをつなぎ合わせるテキストを指定します。
- exclude_current="1"
- 「1」を設定すると、リストから現在のカテゴリーを除きます。
MTParentCategory
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTParentCategory> ~ </MTParentCategory>
現在のカテゴリーの親カテゴリーの一覧を表示します。
MTSubCategories
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTSubCategories> ~ </MTSubCategories>
サブカテゴリーを階層化してリスト表示するコンテナ・タグです。
アトリビュート
- include_current="1"
- 現在のカテゴリーもリストに追加する場合に指定します。
- sort_method="XXX"
- Perlのメソッド名を使って並び替えます。
- sort_order="descend"
- 並べ方を降順にします。このアトリビュートは、sort_methodが設定されていないときに有効です。
MTSubCategoryPath
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <$MTSubCategoryPath$>
親カテゴリーから現在のカテゴリーまでの階層構造を表示するタグです。日本語カテゴリーはdirifyの影響を受けます。
アトリビュート
- separator="-"
- ファイル名の中の"_"を"-"に変換します。
- glue="XX"
- 複数のカテゴリーを並べて表示するときの、区切り文字を設定します。区切り文字には「'」(シングルクォート)や「"」(ダブルクォート)は使えません。
MTSubCatIsFirst
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTSubCatIsFirst> ~ </MTSubCatIsFirst>
カテゴリーの一覧の中で、現在のサブカテゴリーがそのレベルにおいて最初にリストされているときに実行する条件タグです。サブカテゴリーを含む一覧を、<ul>タグで階層化するときなどに、次の<MTSubCatsIsLast>と組み合わせて利用します。
MTSubCatIsLast
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTSubCatIsLast> ~ </MTSubCatIsLast>
カテゴリーの一覧の中で、現在のサブカテゴリーがそのレベルにおいて最後にリストされているときに実行する条件タグです。サブカテゴリーを含む一覧を、<ul>タグで階層化するときなどに、次の<MTSubCatsIsLast>と組み合わせて利用します。
MTSubCatsRecurse
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <$MTSubCatsRecurse$>
現在のカテゴリーに属するサブカテゴリーのMTSubCategoriesコンテナを再帰的に表示します。アトリビュートmax_depthで、再帰的に表示する深さを指定できます。max_depth="1"と指定すると、このカテゴリーの下のサブカテゴリーを表示しません。
アトリビュート
- max_depth="N"
- 展開する繰り返し数を指定します。直下のサブカテゴリーのみ展開するときは「max_depth="1"」、孫カテゴリーまで展開するときは「max_depth="2"」を指定します。
MTTopLevelCategories
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTTopLevelCategories> ~ </MTTopLevelCategories>
現在のカテゴリーに関わりなく、最上位のカテゴリーからサブカテゴリーを含めたリストを表示するコンテナ・タグです。
MTTopLevelParent
- 対応しているバージョン: 3.1, 3.2, Enterprise 1.0
- 利用方法: <MTTopLevelParent> ~ </MTTopLevelParent>
現在のカテゴリー階層に関わりなく、最上位のカテゴリーのみを表示するコンテナ・タグです。