目次の領域マクロ
スクリーンショット: 出力タイプ "flat" で設定された目次の領域マクロ。
このマクロをページに追加する
コンテンツ ゾーン ページ マクロをページに追加するには：
Error rendering macro 'includeplus'
User 'anonymous' does not have permission to view the page with ID 993925286.
- [Confluence コンテンツ] カテゴリから [目次の領域] を選択します。
- 任意のパラメーターを入力します。
- [挿入] をクリックします。
- コンテンツをマクロ本文に追加するか貼り付けます。マクロ内の見出しが目次に含まれます。
その後、ページを公開するとマクロの動作を確認できます。
スクリーンショット: 目次の領域マクロの本文内での見出しの入力。
マクロ パラメーターを変更する
Error rendering macro 'excerpt-include'
ユーザー 'null' にはこのページを表示する権限がありません。
このマクロで使用できるパラメーターの一覧は、次のとおりです。
パラメーター | 既定 | 説明 |
|---|---|---|
ロケーション | 両方 | 出力リストを表示するゾーンを指定します。top、bottom またはboth でページ ゾーン コンテンツを囲みます。 |
出力タイプ | list | コンテンツ テーブルのレイアウトを指定します。
|
セクション番号を表示 | false | 見出しにアウトライン ナンバリングを適用します。例: 1.1, 1.2, 1.3. |
リスト スタイル | default | 各リスト項目の箇条書きのスタイルを選択します。次のように、有効な CSS スタイルを入力します。
|
見出しのインデント | CSS の数に従って、リストのインデントを作成します。「10px」と入力すると、見出しグループが連続して 10px でインデントされます。たとえば、h 1 の見出しの場合、インデントは 10px となり、h 2 の見出しはさらに 10px でインデントされます。 | |
区切り記号 | brackets | flat 出力タイプにのみ適用されます。リンクの表示スタイルを指定します。 次のいずれかの値を入力できます。
|
見出しの最小レベル | 1 | リストを開始する最大見出しレベルを選択します。たとえば、2 の場合、h2、h3、および h4 見出しをリストしますが、h1 見出しは含まれません。 |
最大見出しレベル | 7 | 目次に含める最小の見出しレベルを指定します。たとえば、2 の場合、h1 と h2 をリストしますが、h3 以下は含みません。 |
見出しを含める | 特定の条件に従って含める見出しをフィルターします。ワイルドカード文字を使用できます。正規表現文字列の作成例に対しては「Sun's Regex documentation」を参照してください。 | |
除外する見出し | 特定の条件に従って含める見出しをフィルターします。ワイルドカード文字を使用できます。正規表現文字列の作成例に対しては Sun's Regex documentation を参照してください。 | |
印刷可能 | true | 既定では、目次は印刷用に設定されています。このパラメーターをクリアすると、ページを印刷する際に目次が表示されなくなります。 |
CSS クラス名 | お使いの CSS スタイル シートでカスタム目次を使用している場合、このパラメーターを使用して、指定した "class" 属性で目次を出力できます。 |
Error rendering macro 'excerpt-include'
ユーザー 'null' にはこのページを表示する権限がありません。
例
この例は、次のヘッダーが付いたページに基づいています。
フィルターされた目次
この例では。"Favorite", を含むすべての見出しをフィルターし、"Things" という単語で終わる見出しを除外しています。リスト スタイルは大文字ローマ数字です。
| パラメーター | 値 |
|---|---|
| 出力タイプ | list |
| リスト スタイル | upper-roman |
| 見出しを含める |
|
| 見出しを除外する | .*Things |
スクリーンショット: フィルターされた TOC 'zone' 見出し
フラット リスト
この例では、すべての見出しをフィルターして角括弧で囲まれた "Unknowns" のフラット リストをレンダリングします。
| パラメーター | 値 |
|---|---|
| 出力タイプ | フラット |
| Separator | brackets |
| Max Heading Level | 2 |
| 見出しを含める | Unknown* |
スクリーンショット: フィルターされた TOC 'zone' 見出し (フラット リストとして表示)
このマクロを追加するその他の方法
手入力でこのマクロを追加する
Error rendering macro 'includeplus'
User 'anonymous' does not have permission to view the page with ID 993925310.
Wiki マークアップを使用してこのマクロを追加する
Error rendering macro 'includeplus'
User 'anonymous' does not have permission to view the page with ID 1003131187.
マクロ名: toc-zone
マクロ本文: リッチ テキストの利用可
{toc-zone:printable=false|maxLevel=2|minLevel=2|location=top|type=flat|outline=true|separator=pipe}
Only headings within this block are included in the table of contents.
{toc-zone}トラブルシューティング
HTML 見出しマークアップと目次の領域マクロの併用について — 目次の領域マクロは単独で HTML 見出しマークアップを処理することはできません。そのため、HTML と HTML インクルード マクロを使用して Confluence ページで HTML 見出しのマークアップをレンダリングしている場合、目次の領域マクロではそれらの見出しからコンテンツ リストを作成することはできません。
ただし、ページの各 HTML 見出しに、次の構文に基づいた HTML アンカーを挿入した場合、目次ゾーン マクロはこれらの見出しをコンテンツ リストに組み込みます。
<h2><a name="pagename-headingname"></a>Heading Name</h2>アンカー名の構文は、ハイフンで区切られたページ名と見出し名です。すべてのスペースを削除し、すべてのテキストを小文字に変換してください。すべての句読点を、対応する URL エンコードに変換してください。