目次の領域マクロを挿入する
コンテンツ ゾーン テーブル マクロを使用して、コンテンツ テーブルを作成するページ内のセクション (ゾーン) を区切ります。見出しをフラット リストとしてスタイリングし、セクションやページの一番上と下にリンクのリストを配置して、Web ナビゲーションに似たナビゲーション バーを提供します。
コンテンツ ゾーン テーブル マクロを使用する
コンテンツ ゾーン テーブル マクロを追加するには:
When editing, select from the toolbar
マクロを名前で検索して選択します。
必要に応じて設定します。
このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。
コンテンツ ゾーン テーブル マクロを編集するには:
マクロのプレースホルダーを選択します。
Select the Edit icon to open the configuration panel.
パラメーターを設定します。変更内容は、移動するごとに保存されます。
ページの編集を再開すると、パネルが閉じます。
You can also select the centered , medium-width , and full-width icons to adjust the width of some macros. Select the trashcan iconto remove the macro.
パラメーター
パラメーターとは、設定してマクロの内容をページに表示する方法を制御できるオプションです。
Confluence Cloud 保存形式で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載されます (example)。
パラメーター | 既定 | 説明 |
|---|---|---|
location | 両方 | 出力リストを表示するゾーンを指定します。top、bottom またはboth でページ ゾーン コンテンツを囲みます。 |
Output Type | list | コンテンツ テーブルのレイアウトを指定します。
|
Display Section Numbering | false | 選択して、見出しにアウトライン番号を適用します。例: 1.1、1.2、1.3。 |
List Style | なし | 各リスト項目のブレット ポイントのスタイルを指定します。 有効な CSS スタイルを使用できます。 例:
|
Heading Indent |
| CSS の数に従って、リスト出力タイプのインデントを作成します。「10px」と入力すると、見出しグループが連続して 10px でインデントされます。たとえば、h1 の見出しの場合、インデントは 10px となり、h2 の見出しはさらに 10px でインデントされます。 |
Separator | brackets | Only applies to the flat output type. Specifies the display style of the links. You can enter any of the following values:
|
Minimum Heading Level | 1 | TOC リストを開始する最大見出しレベルを選択します。たとえば、2 の場合、h2、h3、h4 見出しをリストしますが、h1 見出しは含みません。 |
Max Heading Level | 7 | TOC に含める最小見出しレベルを選択します。たとえば、2 の場合、h1 と h2 をリストしますが、h3 以下は含みません。 |
Include Headings |
| 特定の条件に従って含める見出しをフィルターします。ワイルドカード文字を使用できます。正規表現文字列の作成例に対しては Sun's Regex documentation を参照してください。 |
Exclude Headings |
| 特定の条件に従って含める見出しをフィルターします。ワイルドカード文字を使用できます。正規表現文字列の作成例に対しては Sun's Regex documentation を参照してください。 |
Printable | true | 既定では、TOC は印刷用に設定されています。このパラメーターをクリアすると、ページを印刷した際に TOC は表示されなくなります。 |
CSS Class Name |
| お使いの CSS スタイル シートにカスタムの TOC がある場合、このパラメーターを使用して、指定した "class" 属性で TOC を出力できます。 |
例
この例は、次のヘッダーが付いたページに基づいています。
フィルターされた目次
この例では。"Favorite", を含むすべての見出しをフィルターし、"Things" という単語で終わる見出しを除外しています。リスト スタイルは大文字ローマ数字です。
パラメーター | 値 |
|---|---|
出力タイプ | list |
リスト スタイル |
|
見出しを含める |
|
見出しを除外する |
|
フラット リスト
この例では、すべての見出しをフィルターして角括弧で囲まれた "Unknowns" のフラット リストをレンダリングします。
パラメーター | 値 |
|---|---|
出力タイプ | フラット |
Separator | brackets |
Max Heading Level | 2 |
見出しを含める | Unknown.* |
Wiki マークアップの例
Wiki マークアップは従来のエディタでのみサポートされます。
Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。
マクロ名: 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}
注意
目次の領域マクロ (CONF-10619) の課題が未解決なため、マクロ ブラウザーの更新機能はパラメーターの変更をレンダリングしません。現在、目次の領域マクロへのパラメーター値変更のレンダリングは、ページの保存後にのみ行われます。
この内容はお役に立ちましたか?