Home

Additions and corrections to above

Description

Collection of macros for rendering HTML and related markup inside a Confluence page.

• HTML macro - Renders HTML markup code and scripts inside a Confluence page (described below)
• XSLT macro

HTML Macro

Features

• Supports security restrictions as described in [Macro Security Plugin].
• Supports capabilities for including data similar to other scripting macros.

  Security

  If you have untrusted users on your site, then you should setup [Macro Security Plugin] before enabling the html macro.

Other HTML macros

• {html} and {html-include} macros shipped with Confluence. See the Confluence User Guide: [DOC:HTML Macro] and [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.

Documentation

• Help available in the notation guide.

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

  Direct file access

  The script macros access the script directory in Confluence home for file access.

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.

Version History

• Previous versions were included in [Scripting and External Content Macros]

Release Notes

• 3.1.0
  When: 22-Jun-2007
  Who: [~bob.swift@charter.net]
  What:
  jiraissues: com.atlassian.confluence.extra.jira.exception.JiraIssueMacroException: com.atlassian.confluence.macro.MacroExecutionException: Unable to locate Jira server for this macro. It may be due to Application Link configuration.
  jiraissues: com.atlassian.confluence.extra.jira.exception.JiraIssueMacroException: com.atlassian.confluence.macro.MacroExecutionException: Macro params are invalid

Open Issues