抜粋マクロを挿入する

The excerpt macro is used to mark a part of a page's content for reuse. Defining an excerpt enables other macros, such as the insert excerptand Insert the blog posts macro macros, to display the marked content elsewhere.

ページごとに複数の抜粋を追加して、割り当てた名前で区別できます。これによって、コンテンツのブロックを多く持つページを作成して他のページで再利用できます。抜粋に追加したコンテンツは単一のソースになって、その 1 箇所で変更を加えられます。また、抜粋インクルード マクロによってそのコンテンツを表示しているすべてのページでは、抜粋マクロで行った変更が反映されます。

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

1. Confluence エディタで > [詳細を表示] の順に選択します。

2. 抜粋マクロを見つけて選択します。マクロ プレースホルダーが追加されて、右側のパネルが開きます。

3. Enter a name for the macro so that you can reference it on another page using the insert excerptmacro.
   If you don't give the macro a name, you will only be able to include the content from the first excerpt macro on this page.

4. このページの公開時にマクロ内のコンテンツを非表示にするには [抜粋コンテンツを非表示にする] チェックボックスをチェックします。

5. ページの抜粋マクロ プレースホルダー内にコンテンツを追加します。ほとんどの書式設定オプションを使用できるほか、ツールバーのエレメントをマクロに挿入できます。

さらに、このページに「/」と入力すると、ツールバーから選択したときと同じリストが表示されます。

抜粋マクロを編集するには:

1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。

2. 編集を選択します。右側のパネルが開きます。

3. パラメータを修正します。変更内容は、移動するごとに保存されます。

4. ページの編集を再開すると、パネルが閉じます。

パラメーター

パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence 保存形式で使用されるパラメーター名がブラウザーで使用されるラベルと異なる場合は、以下の一覧に括弧付きで表示されます (example)。

次の追加パラメーターは保存形式で使用可能です。エディターのオプションパネルと同様に機能します。