The Excerpt macro is used to mark a part of a page's content for re-use. Defining an excerpt enables other macros, such as the Excerpt Include and Blog Posts macros, to display the marked content elsewhere.

抜粋は 1 ページにつき 1 つのみ定義できます。つまり、抜粋マクロはページに 1 回のみ追加できます。

抜粋マクロを使用する

ページに抜粋マクロを追加するには:

マクロに再利用可能なコンテンツを追加するには:

  1. 抜粋マクロ プレースホルダー内にコンテンツを追加します。
  2. マクロプレースホルダーを選択し、オプションパネルを開きます。次に、オプション;新たに行を追加して表示またはインラインで表示を選択します。既定値では、行を追加してマクロのコンテンツを表示します。インラインを選択すると、マクロのコンテンツは前後のテキストと同一パラグラフの一部として表示されます。このオプションは抜粋マクロを含むページにのみ影響します。コンテンツを再利用したページには影響しません。

スクリーンショット:抜粋マクロプ レースホルダーとオプション パネル

パラメーター

パラメーター

既定

説明

抜粋したコンテンツを非表示にする
(hidden

false

抜粋マクロプレースホルダーに含まれるページコンテンツをページに表示するか否か管理します。

このオプションは抜粋マクロを含むページにのみ影響します。コンテンツを再利用したページには影響しません。

コー​​ドの例

次の例は、Confluence ページの基本的なマークアップを調べたり、編集したりする上級ユーザー向けに提供されています。 

マクロ名: excerpt

マクロ本文: リッチ テキストの利用可

以下の付加パラメータは保存形式および Wiki マークアップで使用可能です。エディターのオプションパネルと同様に機能します。 

パラメーター名必須既定パラメーターの説明と指定可能な値
atlassian-macro-output-typeいいえBLOCK

抜粋マクロ本体に含まれるコンテンツを新たに行を追加して表示するか、インラインで表示するか決定します。

利用可能な値:

  • BLOCK – マクロのコンテンツを新しい行で表示します。
  • INLINE – マクロのコンテンツを前後のテキストと同じ段落の一部として表示します。

このオプションは抜粋マクロを含むページにのみ影響します。コンテンツを再利用したページには影響しません。

保存形式の例

<ac:structured-macro ac:name="excerpt">
  <ac:parameter ac:name="hidden">true</ac:parameter>
  <ac:parameter ac:name="atlassian-macro-output-type">BLOCK</ac:parameter>
  <ac:rich-text-body>
    
<p>This is the <strong>text</strong> I want to reuse in other pages. This text is inside an Excerpt macro.</p>
  </ac:rich-text-body>
</ac:structured-macro>

Wiki マークアップ例

{excerpt:hidden=true|atlassian-macro-output-type=BLOCK}
This is the *text* I want to reuse in other pages. This text is inside an Excerpt macro.
{excerpt}

ページの一部を「抜粋」として定義し、他のページで表示されるようにします。