Working with Remote Transclusion

Learn about macros from the projectdoc Toolbox help teams to transclude content snippets from remote information servers.

The HTML Include Macro makes it easy to transclude HTML content provided on a remote server. This is useful if your team generates information on a server you want to render in your wiki server instance.

The projecdoc Toolbox adds some features with the  Text Snippet Macro so that teams can transclude from any text file and limit the transclusion to a portion of the page.

Transclude Remote Content

HTML Include Macro

The usage of the macro is very simple:

Add the URL to the HTML page you want to render inside your wiki and you are done.

Text Snippet Macro

The macro provides options to specify the URL to the resource and to locate content within the resource either by text marker or line numbers

In addition to that it also provides the features of the Code Block Macro .

This makes rendering the code snippet nicely formatted a breeze.

Summary

The HTML Include Macro is an easy-to-use tool to grab an HTML document and render it on a page.

The Text Snippet Macro is one of the macros provided by the projectdoc Toolbox that allows to grab parts of any text file from a remote server.

The following table lists features that are related to one of the macros discussed, but are implemented by different macros. In this case the macro providing the feature is listed. No extra cost is involved to use the mentioned macros, since all these macros are either part of Confluence or the projectdoc Toolbox Add-on.

FeatureHTML Include MacroText Snippet Macro
Transclude Content based on Line Numbers
NO
YES
Transclude Content based on Text Markers
NO
YES
Cost
FREE
No Extra Installation required
YES
NO
VendorAtlassiansmartics