Transclude HTML content from a remote server.
Transcludes an HTML snippet from a resource on a server.
The intention is to fetch the HTML structure of widgets from a dashboard and render them on a wiki page. Note that the content is not indexed with Lucene.
Including unknown text snippets inside a web page is dangerous!
Please be very careful when transcluding information from external servers!
Usually you should only transclude pages or parts of pages, if you also are in control of the contents. Transcluding arbitrary information my result in executing scripts on your server. A malicious attacker may steal other user's authentication cookie or do other harmful things!
In contrast to the System Transclusion Macro, the HTML Snippet Macro allows to specify the link to the resource directly and therefore does not provide system identifiers to define a space-wide base URL.
The URL to the resource to transclude.
The selector is required to specify an HTML element.
Introduce the selector with '#' to specify the unique identifier of an HTML element.
Use jsoup's Selector Syntax to specify queries. The first element in the result set is transcluded content.
Transclude whole File?
The selector is mandatory. If you want to transclude the whole page, consider using the Text Snippet Macro.
The encoding of the file. Defaults to the character type announced by the response.
Plain
If unchecked, the snippet is rendered within the Code Block Macro (only then do the following code attributes apply). Otherwise it is rendered as plain text fragment.
Code Language
If the snippet is rendered not in plain text, this value is passed to the Code Block Macro.
The value "Default Language" refers to the value provided by the space property "Code Language".
Code Title
If the snippet is rendered not in plain text, this value is passed to the Code Block Macro.
Code Theme
If the snippet is rendered not in plain text, this value is passed to the Code Block Macro.
Code Line Numbers
If the snippet is rendered not in plain text, this value is passed to the Code Block Macro.
Code First Line
If the snippet is rendered not in plain text, this value is passed to the Code Block Macro.
Code Collapse
If the snippet is rendered not in plain text, this value is passed to the Code Block Macro.
If the macro cannot find the HTML element to transclude, an error message is displayed.
If you encounter a 200: OK message, the file has been found on the remote server, but the HTML element to transclude cannot be located. Please check the selector syntax.
If the result is a 404, the specified file cannot be found to transclude from.
Prior to version 1.4 the macro does not provided means to access resources that are protected by a password.
Transcluded Content
The whitespace formatting of the transcluded content is currently not preserved (see
PDEXINFOSY-20
-
JSoup does not preserve Linebreaks
To Do
).