HTML インクルード マクロ

HTML インクルード マクロを使用すると、Confluence ページに外部 HTML ファイル (web ページ) のコンテンツを含めることができます。

HTML インクルード マクロを使用する

To insert the HTML Include macro into a page:

1. Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
2. 対象のマクロを見つけて、選択します。

オートコンプリートでマクロエントリを高速化： タイプ{とマクロ名の先頭には、提案したマクロの一覧を表示します。詳細は、こちらを参照ください。リンク、ファイル、マクロ、メンションのオートコンプリート

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。

パラメーター

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 インクルード マクロを有効化する

HTML インクルード マクロは既定では無効になっています。このマクロを有効化するには、Confluence 管理者権限またはシステム管理者権限が必要です。

このマクロを有効にすると、Confluence サイトがクロスサイト スクリプティング攻撃に対して脆弱になる可能性があります。すべてのユーザーがこのような攻撃を試みない確信がある場合にのみ、このマクロを有効化してください。セルフサインアップ、または匿名ユーザーによるコンテンツ作成を許可している場合、このマクロは無効化したままにしておくことを強くおすすめします。

HTML インクルード マクロを有効化する方法

1. Go to > Add-ons

2. ドロップダウンからシステム を選択し、Confluence HTML マクロ アドオンを検索します。
3. アドオンを展開し、html-include (html-include-xhtml)モジュールを有効化します。

管理者はwhitelistの使用を選択し、HTML インクルードマクロに表示される URL を制限することもできます。

トラブルシューティング

• 管理者は信頼できる URL の whitelistを定義できます。URL が whitelist にない場合、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 CONF-6567 - Getting issue details... STATUS .

コー​​ドの例

次の例は、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}