目次マクロを挿入する

目次マクロは現在の Confluence ページの見出しをスキャンし、これらの見出しに基づいて目次を作成します。これにより、コンテンツ構造を要約し、見出しへのリンクを提供することで、読者が長いページを回避できるようナビゲートします。 

絵文字、メンション、ステータス、日付を使用して見出しとしてフォーマットされた任意のテキストを目次に含めることができます。

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

目次をページに追加する方法 

  1. エディターのツールバーから、[] を選択して、挿入メニューを開きます。

  2. 目次マクロを見つけて選択します。/tableofcontents と入力することで、ページ本文の挿入メニューから直接このマクロを選択することもできます。

3. 選択すると、ページの本文に [目次] が表示されます。

目次マクロの iframe プレースホルダーの画像

 

目次を設定する方法 

  1. エディターから、[目次] を選択します。

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

  3. 基本モードまたは詳細モードのどちらかで、目次のパラメーターをカスタマイズします。

  4. 選択は直ちに表示されます。ページをプレビューまたは公開すると、カスタマイズした目次の見た目を確認できます。

  5. ページの編集を続けると、設定パネルが閉じます。

中央揃えアイコン、幅アイコン、全幅アイコンのいずれかを選択して、目次の幅を調整することもできます。他の場所に複製するにはコピー アイコンを選択します。完全に削除するにはゴミ箱アイコンを選択します。

パラメーター

パラメーターは、目次がページにどのように表示されるかを正確に制御するように設定できるオプションです。 

目次をカスタマイズするには、ニーズや好みに応じて、基本パラメーターや詳細パラメーターを設定します。

基本パラメーター

基本パラメーター

既定

説明

次の形式で表示

垂直リスト

  • 垂直リスト — 一般的なリスト タイプの目次を生成します。

  • 水平リスト — 水平方向のメニュー タイプのフラットな一連のリンクを生成します。

水平目次リストの画像
垂直目次リストの画像

箇条書きスタイル

ブレット

このパラメーターは垂直リストにのみ適用されます。

次の値のいずれかから選択します。

  • None — 箇条書きは表示されません。

  • Mixed — 黒丸と白丸が混在した箇条書きスタイルです。

  • Bullet — 黒丸の箇条書きスタイルです。

  • Circle — 白丸の箇条書きスタイルです。

  • Square — 黒い四角の箇条書きスタイルです。

  • Numbered – 番号付きリスト (1、2、3、4、5)

目次の箇条書きスタイルの「なし」オプションの画像
目次の「混在」箇条書きスタイルの画像
目次の「箇条書き」スタイルの箇条書きの画像
目次の「丸」箇条書きスタイルの画像
目次の「四角」箇条書きスタイルの画像
目次の「番号付き」スタイルの画像

次の方法でセクションを分ける

角括弧

このパラメーターは水平リストにのみ適用されます。

次の値のいずれかから選択します。

  • Bracket — 各アイテムは角かっこ [ ] で囲まれます。

  • Brace — 各アイテムは波かっこ { } で囲まれます。

  • Pipe — 各アイテムをパイプで区切る。 |

目次の「角括弧」区切り記号スタイルの画像
目次の「波括弧」区切り記号スタイルの画像
目次リストの「パイプ」区切り記号スタイルの画像

Include heading levels from [#] to [#] ([#] から [#] までの見出しレベルを含める)

1 ~ 6 人

目次に含める見出しの最小レベルと最大レベルを選択します。

目次に含まれる既定の見出しレベルの画像

セクション番号を含める

オフ

チェックボックスをオンにすると、見出しにアウトライン番号が適用されます (例: 1.1、1.2、1.3)。

目次の [Numbered Sections (番号付きセクション)] チェックボックスがオンになっている画像

詳細パラメーター

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

詳細パラメーター

説明

見出しのインデント
(indent

有効な CSS 単位値に従って垂直リストのインデントを設定します。

10px」と入力すると、一連の見出しが 10px ずつインデントされます。レベル 1 の見出しは 10px インデントされ、レベル 2 の見出しはさらに 10px インデントされます。

以下の見出しを含める:
(include

特定の条件を入力して、目次に含める見出しを絞り込みます。ワイルドカード文字を使用できます。

概要および要約の見出しのみを表示したい場合は、このフィールドに Overview|Summary と入力します。

 

大文字と小文字は区別されます。両方のインスタンスを含める場合は、両方の形式の単語を入力してください。

以下の見出しを除外する:
(exclude

特定の条件を縦線 {|} で区切って入力して、見出しをフィルタリングして目次から除外します。

例: 除外する見出しが概要または要約の場合は、このフィールドに「Overview|Summary」と入力します。

 

大文字と小文字は区別されます。両方のインスタンスを除外する場合は、両方の形式の単語を入力してください。

CSS クラス名
(class

お使いの CSS スタイル シートにカスタムの TOC がある場合、このパラメーターを使用して、指定した "class" 属性で <div> タグ内に TOC を出力できます。

Exclude in PDF export (PDF エクスポートでは除外)
(printable

このチェックボックスがオンになっていると、ページを PDF にエクスポートしたり印刷したりするときに目次が表示されません。

Wiki マークアップの例

Wiki マークアップは従来のエディタでのみサポートされます。

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

マクロ名: toc

マクロ本文: なし。

この例は、リスト タイプの目次を示しています。

1 2 3 4 {toc:printable=true|style=square|maxLevel=2|indent=5px|minLevel=2|class=bigpink|exclude=[1//2]|type=list|outline=true|include=.*}

この例では、目次のフラット テーブルを示しています。

1 2 3 4 {toc:printable=true|maxLevel=2|minLevel=2|class=bigpink|exclude=[1//2]|type=flat|outline=true|separator=pipe|include=.*}

注意

  • テンプレートで目次マクロを使用すると、目次はテンプレート自体には表示されません。ただし、目次マクロは、ページが保存された後、テンプレートから作成されたページでは常に機能します。

  • 目次マクロは、ページまたはブログ投稿の内容のみを表示します。

  • 目次マクロは、追加されたページ、ブログ、またはマクロ内でのみ機能します。複数のページやブログをまたいでの参照や被参照は行えません。たとえば、抜粋マクロに追加すると、抜粋内にある見出しのみが表示されます。それらの見出しリンクからはソース ページに移動できません。

 

その他のヘルプ