HTML インクルード マクロ
HTML インクルード マクロを使用すると、Confluence ページに外部 HTML ファイル (web ページ) のコンテンツを含めることができます。
HTML マクロは既定では無効になっています
このマクロは、管理者によって有効化されている場合にのみ利用可能です。このマクロを有効にすると、Confluence サイトがクロスサイトスクリプティング攻撃に対して脆弱になります。
HTML インクルード マクロを使用する
ページに HTML インクルードマクロを挿入する方法
- Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートでマクロエントリを高速化： タイプ{とマクロ名の先頭には、提案したマクロの一覧を表示します。詳細は、こちらを参照ください。リンク、ファイル、マクロ、メンションのオートコンプリート
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。
パラメーター
Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
HTML ページの URL(url) | はい | なし | インクルードするページの URL。 |
HTML インクルード マクロを有効化する
HTML インクルード マクロは既定では無効になっています。このマクロを有効化するには、Confluence 管理者権限またはシステム管理者権限が必要です。
このマクロを有効にすると、Confluence サイトがクロスサイト スクリプティング攻撃に対して脆弱になる可能性があります。すべてのユーザーがこのような攻撃を試みない確信がある場合にのみ、このマクロを有効化してください。セルフサインアップ、または匿名ユーザーによるコンテンツ作成を許可している場合、このマクロは無効化したままにしておくことを強くおすすめします。
HTML インクルード マクロを有効化する方法
Go to
> Add-ons- ドロップダウンからシステム を選択し、Confluence HTML マクロ アドオンを検索します。
- アドオンを展開し、html-include (html-include-xhtml)モジュールを有効化します。
管理者はホワイトリストを使用して、HTML インクルード マクロに表示できる URL を制限することもできます。
トラブルシューティング
- 管理者は信頼済みの URL のホワイトリストを定義できます。URL がホワイトリストにない場合、HTML インクルード マクロはエラーメッセージを表示します。
You can only use the HTML Include macro for pages with absolute links. If you use the macro to include an HTML page that has relative links, you will see a 'Page Not Found' error. See
CONFSERVER-6567 - HTML Include macro should rewrite relative links to point to remote site Closed .
コードの例
次の例は、Confluence ページの基本的なマークアップを調べたり、編集したりする上級ユーザー向けに提供されています。
マクロ名: html-include
マクロ本体: なし。
保存形式の例
<ac:structured-macro ac:name="html-include">
<ac:parameter ac:name="url">
<ri:url ri:value="http://www.example.com"/>
</ac:parameter>
</ac:structured-macro>
Wiki マークアップ例
{html-include:url=http://www.example.com}