HTML インクルード マクロ

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

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

ページに HTML インクルード マクロを挿入する方法

1. In the Confluence editor, choose Insert > Other Macros.
2. Find and select the required macro.

オートコンプリートでマクロを素早く入力する方法

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

パラメーター

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}