目次マクロ
目次マクロは現在の Confluence ページの見出しをスキャンし、これらの見出しに基づいて目次を作成します。これにより、コンテンツ構造を要約し、見出しへのリンクを提供することで、読者が長いページを回避できるようナビゲートします。
目次マクロの実際の動きをご覧になりたい場合は、洞察力に富んだ顧客インタビュー ページの作成でどのように使用されているかをご覧ください。
目次マクロを使用する
ヒント: エディタ ツールバーにすばやくアクセスするには、[挿入] > [目次] を選択します。
目次マクロをページに追加する方法
- From the editor toolbar, choose
(Insert) > Other Macros - 対象のマクロを見つけて、選択します。
Speed it up with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. In this example we're inserting the cheese macro. 
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。
マクロ パラメーター
Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).
パラメーター | 既定 | 説明 |
|---|---|---|
出力タイプ | list |
|
セクション番号を表示 | clear | 見出しにアウトライン ナンバリングを適用します。例: 1.1、1.2、1.3. |
リスト スタイル | disc | 各リスト項目のブレット ポイントのスタイルを選択します。有効な CSS スタイルを使用できます。 例:
|
見出しのインデント |
| CSS の数に従って、リストのインデントを作成します。 |
区切り記号 | brackets | このパラメーターはフラットリストにのみ適用されます。 次の値のいずれかを入力できます。
|
見出しの最小レベル | 1 | TOC リストを開始する最大見出しレベルを選択します。たとえば、2 と入力すると、レベル 2 以下の見出しが含まれますが、レベル 1 の見出しは含まれません。 |
最大見出しレベル | 7 | 含める最小の見出しレベルを指定します。たとえば、2 と入力すると、レベル 1 および 2 の見出しが含まれますが、レベル 3 以下の見出しは含まれません。 |
見出しを含める |
| 特定の条件に従って含める見出しをフィルターします。ワイルドカード文字を使用できます。正規表現文字列の作成例に対しては Sun's Regex documentation を参照してください。
|
除外する見出し |
| 特定の条件に従って含める見出しをフィルターします。ワイルドカード文字を使用できます。正規表現文字列の作成例に対しては「Sun's Regex documentation」を参照してください。
|
印刷可能 | オン | 既定では、TOC は印刷用に設定されています。このチェックボックスをクリアすると、ページを印刷した際に TOC は表示されなくなります。 |
CSS クラス名 |
| お使いの CSS スタイル シートにカスタムの TOC がある場合、このパラメーターを使用して、指定した "class" 属性で |
絶対 URL (absoluteURL ) | 既定では、TOC のリンクは現在のページを示す相対的な URL です。これを選択した場合、TOC のリンクは完全な URL になります。この設定は、目次が入ったページを別ノページに含め、リンクをクリックしたユーザーの移動先を制御したい場合に便利です。 |
例
以下の例は、この目次に基づいています。
フィルターされた目次
この例では。"Favorite" を含むすべての見出しをフィルターし、"Things" という単語で終わる見出しを除外しています。リスト スタイルは大文字ローマ数字です。
| パラメーター | 値 |
|---|---|
| リスト スタイル | upper-roman |
| 見出しを含める | Favourite* |
| 見出しを除外する | .*Things |
コンテンツの結果の表は次のようになります。
フラット リスト
この例では、すべての見出しをフィルターし、角括弧 (既定のリスト スタイル) で囲まれた「Unknowns」のフラット リストをレンダリングします。
| パラメーター | 値 |
|---|---|
| 出力タイプ | フラット |
| 最大見出しレベル | 2 |
| 見出しを含める | Unknown* |
コンテンツの結果の表は次のようになります。
Wiki マークアップの例
以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: toc
マクロ本文: なし。
この例は、リスト タイプの目次を示しています。
{toc:printable=true|style=square|maxLevel=2|indent=5px|minLevel=2|class=bigpink|exclude=[1//2]|type=list|outline=true|include=.*}この例では、目次のフラット テーブルを示しています。
{toc:printable=true|maxLevel=2|minLevel=2|class=bigpink|exclude=[1//2]|type=flat|outline=true|separator=pipe|include=.*}注意
- テンプレートで目次マクロを使用すると、テンプレート自体をプレビューしたときにエラーが表示されます。しかし、目次マクロがユーザーがテンプレートから作成するしたページで機能し、目次はページを保存した後に表示されます。(これはおそらく、テンプレートがページとして定義されておらず、目次マクロがページに対してのみ機能するためです。)
- 目次マクロは、ページまたはブログ投稿の内容のみを表示します。例えば、コメントの見出しの目次を追加することはできません。
- コンテンツ ゾーン テーブル マクロ (CONF-10619) の未解決の問題により、マクロ ブラウザーの更新関数はパラメーター変数をレンダリングしません。現在、コンテンツ ゾーン テーブル マクロに対するパラメーター値変更のレンダリングは、ページの保存後にのみ発生します。
HTML 見出しマークアップとコンテンツ テーブル マクロを併用する
コンテンツ テーブル マクロは単独で HTML マークアップを処理することはできません。そのため、HTML と HTML インクルード を使用して Confluence ページで HTML 見出しマークアップをレンダリングする場合、コンテンツ テーブル マクロはこれらの見出しからコンテンツ リストを作成することはできません。
ただし、ページの各 HTML 見出しに HTML アンカーを挿入した場合 (次の構文に基づいて)、コンテンツ テーブル マクロはこれらの見出しをコンテンツ リストに組み込みます。<h2><a name="pagename-headingname"></a>Heading Name</h2>アンカー名の構文は、ハイフンで区切られたページ名と見出し名です。すべてのスペースを削除し、すべてのテキストを小文字に変換してください。すべての句読点を、対応する URL エンコードに変換してください。