Confluence Cloud をセット アップする
チームのニーズを満たすために Confluence Cloud サイトのセットアップに必要となる、大まかな概要をご確認ください。
目次マクロは現在の Confluence ページの見出しをスキャンし、これらの見出しに基づいて目次を作成します。これにより、コンテンツ構造を要約し、見出しへのリンクを提供することで、読者が長いページを回避できるようナビゲートします。
絵文字、メンション、ステータス、日付を使用して見出しとしてフォーマットされた任意のテキストを目次に含めることができます。
目次マクロを挿入するには:
編集時には、ツールバーから を選択します。
マクロを名前で検索して選択します。
必要に応じて設定します。
このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。
コンテンツ テーブル マクロを編集するには:
マクロのプレースホルダーを選択します。
[編集] アイコン を選択して、設定パネルを開きます。
パラメーターを設定します。変更内容は、移動するごとに保存されます。
ページの編集を再開すると、パネルが閉じます。
中央揃え アイコン、幅 アイコン、全幅 アイコンを選択して一部のマクロの幅を調整することもできます。マクロを削除するには、ごみ箱 アイコンを選択します。
パラメーターとは、設定してマクロの内容をページに表示する方法を制御できるオプションです。
Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します (example)。
パラメーター | 既定 | 説明 |
---|---|---|
出力タイプ | list |
|
セクション番号を表示 | clear | チェック ボックスをオンにして、見出しにアウトライン番号を適用します。例: 1.1、1.2、1.3。 |
リスト スタイル | disc | 各リスト項目のブレット ポイントのスタイルを選択します。有効な CSS スタイルを使用できます。 例:
|
見出しのインデント |
| CSS の数に従って、リストのインデントを作成します。「10px」と入力すると、一連の見出しが 10px ずつインデントされます。たとえば、レベル 1 の見出しは 10px インデントされ、レベル 2 の見出しはさらに 10px インデントされます。 |
区切り記号 | brackets | このパラメーターはフラットリストにのみ適用されます。 次の値のいずれかを入力できます。
|
見出しの最小レベル | 1 | TOC リストを開始する最大見出しレベルを選択します。たとえば、「2」と入力すると、レベル 2 以下の見出しが含まれますが、レベル 1 の見出しは含まれません。 |
最大見出しレベル | 7 | 含める最小の見出しレベルを指定します。たとえば、「2」と入力すると、レベル 1 および 2 の見出しが含まれますが、レベル 3 以下の見出しは含まれません。 |
見出しを含める |
| 特定の条件に従って含める見出しを絞り込みます。ワイルドカード文字を使用できます。 概要および要約の見出しのみを表示したい場合は、このフィールドに Overview|Summary と入力します。 大文字と小文字は区別されます。両方のインスタンスを含める場合は、両方の形式の単語を入力してください。 |
見出しを除外する |
| 特定の条件に従って除外する見出しを絞り込みます。ワイルドカード文字を使用できます。 除外したい見出しが概要または要約の場合は、このフィールドに「Overview|Summary」と入力します。 大文字と小文字は区別されます。両方のインスタンスを除外する場合は、両方の形式の単語を入力してください。 |
印刷可能 | オン | 既定では、TOC は印刷用に設定されています。このチェックボックスをクリアすると、ページを印刷した際に TOC は表示されなくなります。 |
CSS クラス名 |
| お使いの CSS スタイル シートにカスタムの TOC がある場合、このパラメーターを使用して、指定した "class" 属性で <div> タグ内に TOC を出力できます。 |
絶対 URL |
| 既定では、TOC のリンクは現在のページを示す相対的な URL です。これを選択した場合、TOC のリンクは完全な URL になります。 |
次の例は、この目次の構成に基づいています。
この例では。"Favorite" を含むすべての見出しをフィルターし、"Things" という単語で終わる見出しを除外しています。リスト スタイルは大文字ローマ数字です。
パラメーター | 値 |
---|---|
リスト スタイル | upper-roman |
見出しを含める | 1
Favourite.* |
見出しを除外する | 1
.*Things |
コンテンツの結果の表は次のようになります。
この例では、すべての見出しをフィルターし、角括弧 (既定のリスト スタイル) で囲まれた「Unknowns」のフラット リストをレンダリングします。
パラメーター | 値 |
---|---|
出力タイプ | フラット |
最大見出しレベル | 1
2 |
見出しを含める | 1
Unknown.* |
コンテンツの結果の表は次のようになります。
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=.*}
テンプレートで目次マクロを使用すると、テンプレート自体をプレビューしたときにエラーが表示されます。しかし、目次マクロがユーザーがテンプレートから作成するしたページで機能し、目次はページを保存した後に表示されます。(これはおそらく、テンプレートがページとして定義されておらず、目次マクロがページに対してのみ機能するためです。)
目次マクロは、ページまたはブログ投稿の内容のみを表示します。例えば、コメントの見出しの目次を追加することはできません。
目次マクロは、追加されたページ、ブログ、またはマクロ内でのみ機能します。複数のページやブログをまたいでの参照や被参照は行えません。たとえば、抜粋マクロに追加すると、抜粋内にある見出しのみが表示されます。それらの見出しリンクからはソース ページに移動できません。
この内容はお役に立ちましたか?