ページ ツリー検索マクロ
ページ ツリー検索マクロを使用して、Confluence ページに検索ボックスを追加できます。閲覧者が検索語を入力すると、すると、Confluence は指定された親 (ルート) ページから開始するページ階層を検索し、検索結果を返します。
また、動的ページ ツリーの一部として、目次のような検索ボックスを追加することもできます。ページ ツリー マクロを参照してください。
ページ ツリー検索マクロの使用
ページ ツリー検索マクロをページに追加するには:
- エディタのツールバーで、[挿入]
> [その他のマクロ] を選択します。 - 対象のマクロを見つけて、選択します。
オートコンプリートを活用して素早く入力: 「{」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。
パラメーター | 既定 | 説明 |
|---|---|---|
ルート ページの名前 | なし | このマクロでページ階層が検索されるルート ページの名前。指定しない場合、ルート ページは現在のページとなります。 注: ページ ツリー マクロとは異なり、ページ ツリー検索マクロでは、"@" 記号で開始する特殊値を使用できません (例:"@home" や "@self" など)。 |
Wiki マークアップの例
以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: pagetreesearch
マクロ本文: なし。
{pagetreesearch:root=My page name}