抜粋マクロを挿入する

抜粋マクロは、ページの一部を再利用できるようしるしをつけるために使用します。抜粋を定義すると、しるしをつけたコンテンツを抜粋の挿入マクロや ブログ投稿の挿入マクロ など、他のマクロで表示することが可能になります。

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

抜粋マクロを追加するには、次の手順に従います。

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

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

3. 抜粋挿入マクロを使用して別のページで参照できるように、マクロ名を入力します。
   マクロに名前を付けない場合は、このページの最初の抜粋マクロのコンテンツのみを含められます。

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

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

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

抜粋マクロを編集するには、次の手順に従います。

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

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

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

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

パラメーター

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

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