抜粋インクルード マクロ
抜粋のインクルードマクロは、とあるページから他のページへコンテンツを「抜粋」（一部分）して表示する際に使用します。
このマクロを使用する前に、抜粋マクロで、抜粋が定義されている必要があります。抜粋インクルードマクロは 1 ページで複数使用することが可能です（抜粋マクロは 1 ページにつき 1 つのみ）。
例
下記では、抜粋マクロページで定義された抜粋からのコンテンツを含む、抜粋インクルードマクロの例です。下記の抜粋インクルードマクロでは、ページタイトルとコンテンツ周囲のパネルの両方を表示するオプションを設定しています。
ページの一部を「抜粋」として定義し、他のページで表示されるようにします。
抜粋インクルードマクロを使用する
ページに抜粋インクルードマクロを追加するには：
- Confluence のエディタで、
> [その他のマクロ] を選択します。 - 対象のマクロを見つけて、選択します。
オートコンプリートでマクロを素早く入力する方法
- 新しいエディタ - 「/」と要素 (ツールや挿入メニューのアイテム) の先頭の文字を入力すると、提案の一覧が表示されます。
- 従来のエディタ - 「{」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。
詳細については、「キーボード ショートカット、マークダウン、およびオートコンプリート」をご参照ください。
既存のマクロを編集する方法
マクロ プレースホルダーをクリックして、編集を選択します 。 マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメーター名がブラウザで使用されるラベルと異なる場合は、以下に括弧付きで一覧表示されます (example)。
パラメーター | 既定 | 説明 |
|---|---|---|
抜粋を含むページ | なし | 表示する抜粋を含むページ名を入力します。抜粋は、同じスペースまたは同じ Wiki の別のスペースにあるページから行います。 抜粋インクルードマクロ ダイアログにページ名を入力すると、他のスペースのページも含め、Confluence がマッチするページをリスト表示します。 あるいは、以下のようにスペースキーとページ名をコロン (:) でつなげて入力することも可能です。 このパラメーターは Wiki マークアップで名前が付けられていません。 |
周囲のパネルを削除 | false | Confluence で抜粋コンテンツの周囲にパネルを表示するか否か決定します。パネルは抜粋を含むページタイトルとパネルのボーダーを表示します。既定値では、パネルとタイトルが表示されます。 |
Wiki マークアップの例
Wiki マークアップは従来のエディタでのみサポートされます。
Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。
マクロ名: excerpt-include
マクロ本文: なし。
{excerpt-include:My page name|nopanel=true}