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

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

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

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

  1. 編集時には、ツールバーから を選択します。

  2. マクロを名前で検索して選択します。

  3. 必要に応じて設定します。

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

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

  1. マクロのプレースホルダーを選択します。

  2. [編集] アイコン を選択して、設定パネルを開きます。

  3. パラメーターを設定します。変更内容は、移動するごとに保存されます。

  4. ページの編集を再開すると、パネルが閉じます。

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

パラメーター

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

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

見出しを含める

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

 

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

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