ページを含めるマクロ

マクロ

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

" ページを含める" マクロをページに追加すると、別のページのコンテンツやブログ投稿をこのページに表示できます。 

このマクロは以下の場合に適しています。

  • 手順や説明を一元化する
  • 役立つ情報を複数のスペースで共有する
  • あらゆるタイプのコンテンツを再利用する

複数の "ページを含める" マクロをページに追加して、それらをテキスト、画像、表、およびその他のマクロと組み合わせることができます。

ほかのページのコンテンツを複製せずに含めているだけなので、元のページに変更が加えられると、そのページが使用されている場所に自動的に反映されます。  

"ページを含める" マクロはスペース権限とページ制限の影響を受けるので、含めるページを閲覧できるユーザーを確認するようにします。

On this page:

スクリーンショット: 再利用可能な警告が上部に表示されたミーティング議事録ページ。 

再利用可能なコンテンツ ライブラリを作成する方法については、「Confluence で技術文書を開発する」をご覧ください。

このマクロをページに追加する

ページにインクルードページ マクロを追加するには:

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. [Confluence コンテンツ] カテゴリから [ページを含める] を選択します。
  3. 含めたいページのタイトルを入力します。このスペース内のページでも、別のスペースのページでもかまいません。
  4. [挿入] をクリックします。 

その後、ページを公開するとマクロの動作を確認できます。  

スクリーンショット: エディタで注意マクロ内にネストされた "ページを含める" マクロ。  


マクロ パラメーターを変更する

マクロ パラメーターは、マクロの動作を変えるために使用します。

マクロ パラメーターを変更するには、次の手順を実行します。

  1. エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
  2. 必要に応じてパラメーターを更新し、[挿入] を選択します。

このマクロで使用できるパラメーターの一覧は、次のとおりです。 

パラメーター

既定

説明

Page to Include

なし

現在のページにインクルードする Confluence ページまたはブログ投稿の名前。ページタイトルの入力を開始すると、Confluence が現在のスペースと他のスペースからマッチするページを提示します。

あるいは、以下の方法でページを指定することも可能です。

  • ページやブログ投稿が異なるスペースにある場合、ページ名の前にスペース キーとコロンを追加します (例: DOC:My page name)。スペース キーでは大文字 / 小文字が区別されます。
  • ブログ投稿を含めるには、日付とブログ投稿のタイトルを指定します。例: /2010/12/01/My blog post
  • 個人用スペースのページを含めることができます。この場合、"username" が名前とすると、スペース キーに "~username" を使用します。例: ~jsmith:My page name

Confluence の保存形式または wiki マークアップで使用されるパラメーター名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

制限事項

このマクロにはいくつか制限事項があるのでご注意ください。

  • このマクロはスペース権限とページ制限の影響を受けます。含まれたページを表示するための適切な権限を持たないユーザーには、そのページのコンテンツが表示されません。 
  • このマクロには、ページ全体のコンテンツが含まれます。ページの一部のみを表示したい場合は、代わりに抜粋を含めるマクロをご利用ください。 
  • このマクロは、現在のサイトに存在するページのみを表示します。"ページを含める" マクロを使用して、ほかの Confluence サイトのページのコンテンツを表示することはできません。   

このマクロを追加するその他の方法

手入力でこのマクロを追加する

{」と入力してからマクロ名の入力を開始すると、マクロの一覧が表示されます。

Wiki マークアップを使用してこのマクロを追加する

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

マクロ名: include

マクロ本文: なし。

{include:DOC:My chocolate page}
Last modified on Mar 22, 2022

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.