Confluence HTML Plugin

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 for Confluence.
• 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 for Confluence before enabling the html macro.

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.

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: [~bswift]
  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.

Open Issues