What is the impersonator feature?

First: What is transclusion? The Transclusion Macro allows to reuse content from another projectdoc document. The content is referenced from the page that contains the Transclusion Macro. The content is rendered in the referenced page and the rendered content is then inserted at the location of the Transclusion Macro.

Now impersonation: The Transclusion Macro is also in use for impersonation. In the this case the Impersonate parameter of the Transclusion Macro must be checked. The Transclusion Macro still references content on another page, but this time the unrendered content is delivered to the transcluding page and the this content is rendered in the context of the transcluding page. The context is typically the document properties and the document sections of the transcluding document.

That's the theory. Now let's have a look at an example!