目次の領域マクロを挿入する
目次の領域マクロを使用して、目次を作成するページまたはリアルタイム文書内のセクション (ゾーン) を区切ります。見出しをフラット リストとしてスタイリングし、セクション、ページ、または文書の一番上と下にリンクのリストを配置して、Web ナビゲーションに似たナビゲーション バーを提供します。
コンテンツ ゾーン テーブル マクロを使用する
コンテンツ ゾーン テーブル マクロを追加するには:
編集時には、ツールバーから を選択します。
マクロを名前で検索して選択します。
必要に応じて設定します。
このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。
コンテンツ ゾーン テーブル マクロを編集するには:
マクロのプレースホルダーを選択します。
[編集] アイコン を選択して、設定パネルを開きます。
パラメーターを設定します。変更内容は、移動するごとに保存されます。
ページの編集を再開すると、パネルが閉じます。
中央揃え 、幅 、全幅 の各アイコンを使用して、一部のマクロの幅を調整することもできます。マクロを削除するには、ゴミ箱アイコン を選択します。
パラメーター
パラメーターとは、設定してマクロの内容をページまたはリアルタイム文書に表示する方法を制御できるオプションです。
Confluence Cloud 保存形式で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載されます (example)。
パラメーター | 既定 | 説明 |
|---|---|---|
場所 | 両方 | 出力リストを表示するゾーンを指定します。top、bottom またはboth でページ ゾーン コンテンツを囲みます。 |
出力タイプ | list | コンテンツ テーブルのレイアウトを指定します。
|
セクション番号の表示 | false | 選択して、見出しにアウトライン番号を適用します。例: 1.1、1.2、1.3。 |
リスト スタイル | なし | 各リスト項目のブレット ポイントのスタイルを指定します。 有効な CSS スタイルを使用できます。 例:
|
見出しのインデント |
| CSS の数に従って、リスト出力タイプのインデントを作成します。「10px」と入力すると、見出しグループが連続して 10px でインデントされます。たとえば、h1 の見出しの場合、インデントは 10px となり、h2 の見出しはさらに 10px でインデントされます。 |
区切り記号 | brackets | flat 出力タイプにのみ適用されます。リンクの表示スタイルを指定します。次の値のいずれかを入力できます。
|
見出しの最小レベル | 1 | TOC リストを開始する最大見出しレベルを選択します。たとえば、2 の場合、h2、h3、h4 見出しをリストしますが、h1 見出しは含みません。 |
見出しの最大レベル | 7 | TOC に含める最小見出しレベルを選択します。たとえば、2 の場合、h1 と h2 をリストしますが、h3 以下は含みません。 |
含める見出し |
| Filter the included headings according to specific criteria. You can use wildcard characters. See Sun's Regex documentation for examples of constructing regular expression strings. |
除外する見出し |
| Exclude headings according to specific criteria. You can use wildcard characters. See Sun's Regex documentation for examples of constructing regular expression strings. |
印刷可能 | true | 既定では、TOC は印刷用に設定されています。このパラメーターをクリアすると、ページを印刷した際に TOC は表示されなくなります。 |
CSS クラス名 |
| お使いの 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}
注意
Due to an outstanding issue in the Table of Content Zone macro (CONF-10619), the Macro Browser's Refresh function does not render any parameter modifications. Currently, the rendering of parameter value modifications to the Table of Content Zone macro occurs only after the page is saved.
この内容はお役に立ちましたか?