抜粋インクルード マクロ

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

抜粋を含めるマクロを追加すると、別のページの抜粋マクロのコンテンツを表示できます。 

これは、重要な情報を一元化する場合に適しています。たとえば、各プロジェクト ページから取得した連絡先の詳細情報や日付を要約ページに表示できます。抜粋の情報が更新されると、その抜粋が使用されている他のすべての場所に反映されます。

これは 2 段階のマクロです。抜粋を含めるマクロを使用するには、別のページに抜粋マクロを追加する必要があります。

このページの内容

以下の例では、エディタに表示される抜粋インクルード マクロと、ページを表示した際にそれがどう見えるかを示しています。ページ タイトルとコンテンツ周囲のパネルの両方を表示するオプションを設定しています。

  1. エディタに表示される抜粋インクルード マクロ。 
  2. ページを表示した際の抜粋インクルード マクロ。 

コンテンツは、"reusable note" と呼ばれるページの抜粋マクロから取り込まれます。 

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

抜粋を含めるマクロをページに追加するには、次の手順を実行します。

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

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

ページに複数の抜粋マクロが含まれる場合、抜粋を含めるマクロはページの最初の抜粋マクロのコンテンツを表示します。同じページにある複数の抜粋マクロのコンテンツを表示することはできません。 

抜粋よりも多くのコンテンツを表示したい場合は、ページを含めるマクロを使用すると、別のページのコンテンツ全体を含めることができます。


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

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

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

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

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

パラメーター

既定

説明

抜粋を含むページ
(default-parameter

なし

表示する抜粋を含むページ名を入力します。抜粋は、同じスペースまたは同じ Wiki の別のスペースにあるページから行います。

抜粋インクルードマクロ ダイアログにページ名を入力すると、他のスペースのページも含め、Confluence がマッチするページをリスト表示します。

あるいは、以下のようにスペースキーとページ名をコロン (:) でつなげて入力することも可能です。

SPACEKEY:Page name

このパラメーターは Wiki マークアップで名前が付けられていません。

周囲のパネルを削除
(nopanel)
 

false

Confluence で抜粋コンテンツの周囲にパネルを表示するか否か決定します。パネルは抜粋を含むページタイトルとパネルのボーダーを表示します。規定値では、パネルとタイトルが表示されます。

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

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

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

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

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

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

マクロ名: excerpt-include

マクロ本文: なし。

{excerpt-include:My page name|nopanel=true}
最終更新日 2020 年 8 月 12 日

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

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