ページ ツリー検索マクロを使用して、Confluence ページに検索ボックスを追加できます。閲覧者が検索語を入力すると、すると、Confluence は指定された親 (ルート) ページから開始するページ階層を検索し、検索結果を返します。

また、動的ページ ツリーの一部として、目次のような検索ボックスを追加することもできます。ページ ツリー マクロを参照してください。

ページ ツリー検索マクロを使用する

ページ ツリー検索マクロを追加するには、次の手順に従います。

  1. Confluence エディタで、 > [詳細を表示] の順に選択します。
  2. 挿入するアイテムを探して選択します
  3. [挿入] を選択します。

このページに「/」と入力して、ツールバーからを選択し、同じリストを表示することも可能です。

ページ ツリー検索マクロを編集するには、次の手順に従います。

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。
  2. [編集] を選択します。右側のパネルが開きます。
  3. パラメータを修正します。変更内容は、移動するごとに保存されます。
  4. ページの編集を再開すると、パネルが閉じます。

パラメーター

パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

パラメーター

既定

説明

ルート ページの名前
(root

なし

このマクロでページ階層が検索されるルート ページの名前。指定しない場合、ルート ページは現在のページとなります。

: ページ ツリー マクロとは異なり、ページ ツリー検索マクロでは、"@" 記号で開始する特殊値を使用できません (例:"@home" や "@self" など)。

Wiki マークアップの例

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


robotsnoindex
robotsnoindex

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

マクロ名:  pagetreesearch

マクロ本文: なし。

{pagetreesearch:root=My page name}