FAQs for the HTML for Confluence app
- Manisha Kharga
- Smita Nair
Overview
This page provides answers to the most frequently asked questions for the HTML for Confluence app.
FAQ
Yes, you can use the HTML for Confluence app if the native Confluence HTML module is disabled. After disabling the native Confluence HTML macro, you must disable and re-enable the BobSwift HTML for Confluence app to work.
Yes. A Confluence administrator can toggle the Allow JavaScript switch on the HTML for Confluence Configuration screen to allow Javascript in the HTML macro. Note that this parameter is available from the app version 5.4.0.
- Place the image file in the <confluence_home_directory>/script/filename location.
- Log in to your Confluence instance and navigate to the intended space.
- Edit the relevant page and include the HTML macro.
- Click Edit and in the Edit 'HTML' Macro screen, enter the filename, with # prefix, under Location of HTML data.
- Click Save.
No, it is not possible to bulk import HTML pages using this app.
Alternatively, you can use the Confluence Command Line Interface (CLI) app to bulk import HTML pages. The following code uses the loadFiles action to import HTML files from the specified location and space:
--action loadFiles --space "spacekey" --file "<path of the folder which has multiple html pages>" --replace
In the specified location, mime, text/HTML, text/text, and, text/markdown file types are converted to pages. All other file types are added as attachments and all HTML files are wrapped with the HTML macro. Visit the CLI reference site for more information.
Yes, a xsltVersion parameter is available as part of XSLT macro. This lists the XSLT versions that the macro is compatible with.
Select the version based on your style (XSLT) input document. To learn more, refer to XSLT Macro. Note that this parameter is available from app version 5.4.0 onwards.
This parameter controls whether the URL parameter on the HTML macro must conform to the Confluence Whitelist, provided whitelisting is enabled.
Confluence allows the administrator to turn on whitelisting and restrict incoming and outgoing connections to only those connections that are configured in the settings. By enabling this option, the URL parameter for this app is restricted to URLs that are configured in the Confluence Whitelist settings.
Yes, it is possible to find and replace string using regex.
In the Edit 'HTML' Macro screen, enter the regex pattern under Find regex patterns and the text to be replaces with under Replacement strings.
Yes, you can display HTML content in an iframe with this app.
In the Edit 'HTML' Macro screen, deselect the Remove conflicting tags option.
The output of the shown example is:
Yes, you can display the header section of an HTML file attachment.
In the Edit 'HTML' Macro screen, check the option Include head section HTML.
Before selecting the option:
After selecting the option:
Yes, you can format the JTidy content of an HTML file attachment.
In the Edit 'HTML' Macro screen, check the Select to use JTidy option.