Confluence 4.x
You must disable the html-migration macro provided in the Atlassian bundled Confluence Html Macros plugin under System Plugins in order to avoid Unknown Macro errors when inserting wiki markup with the html macro. Or surround with the wiki macro or any other non-migrated (compatibility mode) macro. Unfortunately, Atlassian ships the html-migration macro as enabled even though their html macro is disabled. This causes any html macro to be migrated without a supporting macro . See CONF-25656.
Users upgrading to Confluence 4.x should use HTML 4.0.0 to avoid issues caused by the problem above. Prior to 4.0.0, the html macro works in compatibility mode - see Confluence 4.0 compatibility for Table and other plugins
HTML Macro
Features
- Supports security restrictions as described in Macro Security for Confluence.
- Supports capabilities for including data similar to other scripting macros.
Other HTML macros
- {html} and {html-include} macros shipped with Confluence. See the Confluence User Guide: http://confluence.atlassian.com/display/DOC:HTML Macro and http://confluence.atlassian.com/display/DOC:HTML Include Macro. These macros are disabled by default in Confluence, since it is a security exposure unless you only have trusted users on your site. The Confluence HTML macro must be disabled for the new html macro to be used.
- HTML Tag - a safer alternative to the standard {html} macro but does not allow for arbitrary html to be included.
Parameters
- output- Determines how the output is formated:
- html - Data is output as HTML (default).
- wiki - Data is surrounded by a {noformat} macro.
- script- Location of HTML data. Default is the macro body only. If a location of data is specified, the included data will follow the body data.
- #filename - Data is read from the file located in confluence home directory/script/filename. Subdirectories can be specified.
- #http://... - Data is read from the URL specified.
- ^attachment - Data is read from an attachment to the current page.
- page^attachment - Data is read from an attachment to the page name provided.
- space:page^attachment - Data is read from an attachment to the page name provided in the space indicated.
- noPanel - When output=wiki, show the data within a panel (default) unless nopanel=true
- encoding - File encoding for an external file if different from the system default handling. Example: UTF-8.
- clean - Default is true. Some HTML tags (like body and html) are removed to help with formatting in Confluence. Set to false to surround the complete html with an iframe.
- head - Default is false. If set to true and clean=true, then the head tags will be removed and this will allow confluence to treat the content as standard body content on the page. Style information in particular.
- width - Default is 500. Sets the width for the iframe (when clean=true).
- height - Default is 500. Sets the height for the iframe (when clean=true).
Usage
Example - HTML from a file in the script folder in the Confluence home directory
{html:script=#example.html}
{html}
Example - HTML from an attachement
{html:script=^example.html}
{html}
Example - HTML put within {noformat} panel
{html:output=wiki|noPanel=true}
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam fermentum vestibulum est. Cras rhoncus.
{html}
Example - HTML from an URL
{html:script=#http://localhost/example.html}
{html}
Example - use of CSS inline style sheet
{html}
<P style="font-size: x-large; color: #8000">
Using inline style sheets - or is that inline styles?
</p>
{html}
Example - use of CSS external style sheet
{html}
<LINK href="http://www.cssgarden.com/css/T22/keylime_0001.css" rel="stylesheet" title="default" type="text/css"></LINK>
<H1>Absolute </H1>
{html}
Note: Make sure that style sheet is available on a server and provide absolute URL reference to this external style sheet resource.
