ページ ツリー マクロ
ページツリー マクロには、指定した親 (ルート) ページから開始するページの動的な階層リストが表示されます。コンテンツ テーブルや関連トピックのリストとして動作することができます。ページ ツリーを表示すると、読者はリンクをクリックして関連ページを表示することができます。ページの現在の位置はページツリーでハイライトされます。
ページツリー マクロの使用
ページ ツリー マクロをページに追加するには:
- エディタのツールバーで、[挿入]
> [その他のマクロ] を選択します。 - 対象のマクロを見つけて、選択します。
オートコンプリートを活用して素早く入力: 「{」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。
マクロ パラメーターへの変更の影響を見るには、マクロ ブラウザーで更新をクリックします。
マクロ パラメーター
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).
パラメーター | 既定 | 説明 |
|---|---|---|
ルート ページ | スペースのホームページ | ページ ツリーの親ページを指定します。ツリーには指定されたページのすべての子と、それらの子と孫などが含まれます。ツリーには、ページ自体は含まれません。
|
ページの並べ替え | 職位 | ツリー内でのページの表示順を指定します。この並べ替えは表示目的のみです。ページの順序を永続的に再配置するものではありません。次のいずれかの値を使用できます。
|
ページ ツリーの抜粋を含む | false | ページツリーで各ページの抜粋を表示する場合に選択します。抜粋は、各ページで抜粋マクロを使用して定義する必要があります。 |
逆順ソート | false | ページを自然な順序の逆 (降順) で表示する場合に選択します。並べ替えパラメーターと併用する必要があります。 |
ページ ツリーの上部の検索ボックスを含める | false | ページツリーの上の検索ボックスに含める場合に選択します。この検索ボックスでは、読者に指定した値のページ内での検索を許可することができます。 |
展開 / 折りたたみリンクの表示 | false | ページツリーの一番上に「すべて展開」および「すべて折りたたみ」リンクを表示する場合に選択します。読者はこれらのリンクをクリックし、一度にツリーのすべてのブランチを開く/閉じることができます。 wikimarkup とストレージ形式で利用可能な値:
|
開始時の深さ | 1 | 最初に開いたときに、ツリーに表示する子の数を設定するには、0 より大きい数を入力します。 |
Wiki マークアップの例
以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: pagetree
マクロ本文: なし。
{pagetree:root=Page Name|sort=natural|excerpt=true|reverse=false|startDepth=3|expandCollapseAll=true|searchBox=true}