Confluence Cloud を検討中ですか?
Confluence Cloudの概要とプランごとに利用可能な機能をご確認ください。
目次の領域マクロを挿入する
コンテンツ ゾーン テーブル マクロを使用して、コンテンツ テーブルを作成するページ内のセクション (ゾーン) を区切ります。見出しをフラット リストとしてスタイリングし、セクションやページの一番上と下にリンクのリストを配置して、Web ナビゲーションに似たナビゲーション バーを提供します。
コンテンツ ゾーン テーブル マクロを使用する
コンテンツ ゾーン テーブル マクロを追加するには:
編集時には、ツールバーから を選択します。
マクロを名前で検索して選択します。
必要に応じて設定します。
このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。
コンテンツ ゾーン テーブル マクロを編集するには:
マクロのプレースホルダーを選択します。
[編集] アイコン を選択して、設定パネルを開きます。
パラメーターを設定します。変更内容は、移動するごとに保存されます。
ページの編集を再開すると、パネルが閉じます。
中央揃え アイコン、幅 アイコン、全幅 アイコンを選択して一部のマクロの幅を調整することもできます。マクロを削除するには、ごみ箱 アイコンを選択します。
パラメーター
パラメーターとは、設定してマクロの内容をページに表示する方法を制御できるオプションです。
Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します (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 以下は含みません。 |
見出しを含める |
| 特定の条件に従って含める見出しをフィルタリングします。ワイルドカード文字を使用できます。正規表現文字列の作成例については「Sun's Regex documentation」をご参照ください。 |
見出しを除外する |
| 特定の条件に従って含める見出しをフィルタリングします。ワイルドカード文字を使用できます。正規表現文字列の作成例については「Sun's Regex documentation」をご参照ください。 |
印刷可能 | true | 既定では、TOC は印刷用に設定されています。このパラメーターをクリアすると、ページを印刷した際に TOC は表示されなくなります。 |
CSS クラス名 |
| お使いの CSS スタイル シートにカスタムの TOC がある場合、このパラメーターを使用して、指定した "class" 属性で TOC を出力できます。 |
例
この例は、次のヘッダーが付いたページに基づいています。
フィルターされた目次
この例では。"Favorite", を含むすべての見出しをフィルターし、"Things" という単語で終わる見出しを除外しています。リスト スタイルは大文字ローマ数字です。
パラメーター | 値 |
|---|---|
出力タイプ | list |
リスト スタイル | upper-roman |
見出しを含める | Favourite.* |
見出しを除外する | .*Things |
フラット リスト
この例では、すべての見出しをフィルターして角括弧で囲まれた "Unknowns" のフラット リストをレンダリングします。
パラメーター | 値 |
|---|---|
出力タイプ | フラット |
Separator | brackets |
Max Heading Level | 2 |
見出しを含める | 1
Unknown.* |
Wiki マークアップの例
Wiki マークアップは従来のエディタでのみサポートされます。
Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。
マクロ名: toc-zone
マクロ本文: リッチ テキストの利用可
1
2
3
4
5
6
{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) の課題が未解決なため、マクロ ブラウザーの更新機能はパラメーターの変更をレンダリングしません。現在、目次の領域マクロに対するパラメーター値変更のレンダリングは、ページの保存後にのみ行われます。
この内容はお役に立ちましたか?