ページを含めるマクロ
" ページを含める" マクロをページに追加すると、別のページのコンテンツやブログ投稿をこのページに表示できます。
このマクロは以下の場合に適しています。
- 手順や説明を一元化する
- 役立つ情報を複数のスペースで共有する
- あらゆるタイプのコンテンツを再利用する
複数の "ページを含める" マクロをページに追加して、それらをテキスト、画像、表、およびその他のマクロと組み合わせることができます。
ほかのページのコンテンツを複製せずに含めているだけなので、元のページに変更が加えられると、そのページが使用されている場所に自動的に反映されます。
"ページを含める" マクロはスペース権限とページ制限の影響を受けるので、含めるページを閲覧できるユーザーを確認するようにします。
スクリーンショット: 再利用可能な警告が上部に表示されたミーティング議事録ページ。
再利用可能なコンテンツ ライブラリを作成する方法については、「Confluence で技術文書を開発する」をご覧ください。
このマクロをページに追加する
ページにインクルードページ マクロを追加するには：
- エディタのツールバーで、[挿入]
> [その他のマクロ] を選択します。 - [Confluence コンテンツ] カテゴリから [ページを含める] を選択します。
- 含めたいページのタイトルを入力します。このスペース内のページでも、別のスペースのページでもかまいません。
- [挿入] をクリックします。
その後、ページを公開するとマクロの動作を確認できます。
スクリーンショット: エディタで注意マクロ内にネストされた "ページを含める" マクロ。
マクロ パラメーターを変更する
マクロ パラメーターは、マクロの動作を変えるために使用します。
マクロ パラメーターを変更するには、次の手順を実行します。
- エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
- 必要に応じてパラメーターを更新し、[挿入] を選択します。
このマクロで使用できるパラメーターの一覧は、次のとおりです。
パラメーター | 既定 | 説明 |
|---|---|---|
Page to Include | なし | 現在のページにインクルードする Confluence ページまたはブログ投稿の名前。ページタイトルの入力を開始すると、Confluence が現在のスペースと他のスペースからマッチするページを提示します。 あるいは、以下の方法でページを指定することも可能です。
|
Confluence の保存形式または wiki マークアップで使用されるパラメーター名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。
制限事項
このマクロにはいくつか制限事項があるのでご注意ください。
- このマクロはスペース権限とページ制限の影響を受けます。含まれたページを表示するための適切な権限を持たないユーザーには、そのページのコンテンツが表示されません。
- このマクロには、ページ全体のコンテンツが含まれます。ページの一部のみを表示したい場合は、代わりに抜粋を含めるマクロをご利用ください。
- このマクロは、現在のサイトに存在するページのみを表示します。"ページを含める" マクロを使用して、ほかの Confluence サイトのページのコンテンツを表示することはできません。
このマクロを追加するその他の方法
手入力でこのマクロを追加する
Wiki マークアップを使用してこのマクロを追加する
これは、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: include
マクロ本文: なし。
{include:DOC:My chocolate page}