目次の領域マクロを挿入する

コンテンツゾーンテーブルマクロを使用して、コンテンツテーブルを作成するページ内のセクション (ゾーン) を区切ります。見出しをフラットリストとしてスタイリングし、セクションやページの一番上と下にリンクのリストを配置して、Web ナビゲーションに似たナビゲーションバーを提供します。

コンテンツゾーンテーブルマクロを使用する

コンテンツゾーンテーブルマクロを追加するには:

編集時には、ツールバーからを選択します。
マクロを名前で検索して選択します。
必要に応じて設定します。

このページに「/」と入力して、ツールバーからを選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。

コンテンツゾーンテーブルマクロを編集するには:

マクロのプレースホルダーを選択します。
[編集] アイコンを選択して、設定パネルを開きます。
パラメーターを設定します。変更内容は、移動するごとに保存されます。
ページの編集を再開すると、パネルが閉じます。

中央揃えアイコン、幅アイコン、全幅アイコンを選択して一部のマクロの幅を調整することもできます。マクロを削除するには、ごみ箱アイコンを選択します。

パラメーター

パラメーターとは、設定してマクロの内容をページに表示する方法を制御できるオプションです。

Confluence Cloud 保存形式で使用されるパラメーター名が、ブラウザやスラッシュコマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載されます (example)。

パラメーター	既定	説明
ロケーション (location)	両方	出力リストを表示するゾーンを指定します。top、bottom またはboth でページゾーンコンテンツを囲みます。
出力タイプ (type)	list	コンテンツテーブルのレイアウトを指定します。 list – 縦型のリスト (一般的には TOC) を生成します。 flat – 横型のメニュータイプの一連のリンクを生成します。例: [Heading 1] [Heading 2] [Heading 3]。
セクション番号を表示 (outline)	false	選択して、見出しにアウトライン番号を適用します。例: 1.1、1.2、1.3。
リストスタイル (style)	なし	各リスト項目のブレットポイントのスタイルを指定します。有効な CSS スタイルを使用できます。例: none — リストスタイルの表示なし circle — 丸のリストスタイル disc — 黒丸のリストスタイル。一般的な箇条書きリスト。このリストの例で使用しているものです。 square — 正方形のリストスタイル decimal – 番号付きリスト (1、2、3、4、5) lower-alpha — 小文字のアルファベットのリスト (a、b、c、d、e) lower-roman — 小文字のローマ数字のリストスタイル (i、ii、iii、iv、v、vi) upper-roman — 大文字のローマ数字 (I、II、III、IV、V、VI) のリストスタイル。
見出しのインデント (indent)		CSS の数に従って、リスト出力タイプのインデントを作成します。「10px」と入力すると、見出しグループが連続して 10px でインデントされます。たとえば、h1 の見出しの場合、インデントは 10px となり、h2 の見出しはさらに 10px でインデントされます。
区切り記号 (separator)	brackets	flat 出力タイプにのみ適用されます。リンクの表示スタイルを指定します。次のいずれかの値を入力できます。 brackets — 各アイテムは、角かっこ [ ] で囲まれます。 braces — 各項目をかっこ { } で囲む。 parens — 各アイテムをかっこ ( ) で囲む。 pipe — 各アイテムをパイプで区切る。 anything — 入力する値によってそれぞれが区切られます。テキストをセパレーターとして入力できます (例: ''*)。カスタムセパレーターを使用している場合、テキストは入力されたとおりに表示されることに注意してください。文字を区切る追加スペースなどは入りません。
見出しの最小レベル (minLevel	1	TOC リストを開始する最大見出しレベルを選択します。たとえば、2 の場合、h2、h3、h4 見出しをリストしますが、h1 見出しは含みません。
最大見出しレベル (maxLevel)	7	TOC に含める最小見出しレベルを選択します。たとえば、2 の場合、h1 と h2 をリストしますが、h3 以下は含みません。
見出しを含める (include)		特定の条件に従って含める見出しをフィルタリングします。ワイルドカード文字を使用できます。正規表現文字列の作成例については「Sun's Regex documentation」をご参照ください。
見出しを除外する (exclude)		特定の条件に従って含める見出しをフィルタリングします。ワイルドカード文字を使用できます。正規表現文字列の作成例については「Sun's Regex documentation」をご参照ください。
印刷可能 (printable)	true	既定では、TOC は印刷用に設定されています。このパラメーターをクリアすると、ページを印刷した際に TOC は表示されなくなります。
CSS クラス名 (class)		お使いの CSS スタイルシートにカスタムの TOC がある場合、このパラメーターを使用して、指定した "class" 属性で TOC を出力できます。

例

この例は、次のヘッダーが付いたページに基づいています。

フィルターされた目次

この例では。"Favorite", を含むすべての見出しをフィルターし、"Things" という単語で終わる見出しを除外しています。リストスタイルは大文字ローマ数字です。

パラメーター	値
出力タイプ	list
リストスタイル	upper-roman
見出しを含める	Favourite.*
見出しを除外する	.*Things

フラットリスト

この例では、すべての見出しをフィルターして角括弧で囲まれた "Unknowns" のフラットリストをレンダリングします。

パラメーター	値
出力タイプ	フラット
Separator	brackets
Max Heading Level	2
見出しを含める	`1Unknown.*`

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) の課題が未解決なため、マクロブラウザーの更新機能はパラメーターの変更をレンダリングしません。現在、目次の領域マクロに対するパラメーター値変更のレンダリングは、ページの保存後にのみ行われます。

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問