The Page Tree macro displays a dynamic, hierarchical list of pages starting from a specified parent (root) page. It can act as a table of contents or a list of related topics.

When viewing the page tree, your reader can click a link to view the relevant page. The page's current position is highlighted in the page tree.

Creating a navigation panel for your space

The Page Tree macro is used in the Confluence Documentation theme, to create a navigation panel showing a table of contents for your space. Read the instructions on Configuring the Documentation Theme.

ページツリー マクロの使用

ページ ツリー マクロをページに追加するには:

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

オートコンプリートでマクロを素早く入力する方法

Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

To edit an existing macro: Click the macro placeholder and choose Edit. This will display the parameters of the macro in the Macro Browser.

Click Refresh in the Macro Browser to see the effect of changes to the macro parameters.

マクロ パラメーター

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。

パラメーター

既定

説明

Root Page

スペースのホームページ

ページ ツリーの親ページを指定します。ツリーには指定されたページのすべての子と、それらの子と孫などが含まれます。ツリーには、ページ自体は含まれません

ページのタイトルまたは特別な値を次のように指定します:

  • ページ タイトル — ツリーの親やルートのページ名を指定します。ツリーには、指定したルートのすべての子と孫が含まれます。ツリーには、指定したルート ページ自体は含まれません
  • 「@home」— スペースのホーム ページ以下のすべてのページが含まれます (デフォルト)。
  • '@self' — 現在のページにすべてのページを含めます。
  • '@parent' — 現在のページの親ページの下のすべてのページ (現在のページを含む) を含めます。
  • '@none' — スペース内のすべてのページ (孤立ページや親ページを含む) を含めます。

Sort Pages By

職位

ツリー内でのページの表示順を指定します。この並べ替えは表示目的のみです。ページの順序を永続的に再配置するものではありません。次のいずれかの値を使用できます。

  • bitwise — アルファベット順に並べ替えます。例: title1、title10、title2。
  • 作成 — コンテンツの作成日順で並べ替えます。
  • modified — 最近変更された順に並べ替えます。
  • natural — 「自然数」のアルファベット順に並べ替えます。例: title1、title2、title10。
  • position — デフォルトの Confluence 並べ替え規則で並べ替えます。ページを手動で並べ替えた場合、この並べ替えは定義済みの順序を尊重します。そうでない場合、ページは「自然数」のアルファベット順で表示されます。例: title1、title2、title10。

Include Excerpts in Page Tree

false

Select if you want the page tree to show excerpts from each page. The excerpts must be defined on each page by the Excerpt macro.

Reverse Order

false

ページを自然な順序の逆 (降順) で表示する場合に選択します。並べ替えパラメーターと併用する必要があります。

Include Search Box above Page Tree

false

ページツリーの上の検索ボックスに含める場合に選択します。この検索ボックスでは、読者に指定した値のページ内での検索を許可することができます。

Show Expand/Collapse Links

false

ページツリーの一番上に「すべて展開」および「すべて折りたたみ」リンクを表示する場合に選択します。読者はこれらのリンクをクリックし、一度にツリーのすべてのブランチを開く/閉じることができます。

Start Depth

1

最初に開いたときに、ツリーに表示する子の数を設定するには、0 より大きい数を入力します。

関連トピック

Page Tree Search Macro
Adding a Navigation Sidebar
Working with Macros

Take me back to the Confluence User's Guide.

  • ラベルなし