If you apply changes to a document you may like to know which documents transclude content from this document. This way you are able to check quickly, if your changes call for changes in some of the transcluding documents. | Note Box |
|---|
| title | Explicit Transclusions are supported |
|---|
| Only explicit transclusions are tracked with this approach. Explicit transclusions are set with the Transclusion Macro. These transclusions are evaluated at the time the page is saved. If you employ searches for your transclusion, the references are not tracked. Searches are evaluated at the time the search is executed. Therefore transclusions rendered with the Transclude Documents Macro will not show up in this list. This is similar to the fact that links rendered within the Display Table Macro are also not counting as references to the page. |
Using the projectdoc Toolbox makes this very easy. Actually some doctypes, such as the Module, automatically add this information.  Use a constraint on the search result like this: | Code Block |
|---|
| $<TranscludedDocumentTitles>=[${Space Key}.${Name}] |
Here is the code in storage format to add in order to list the transcluding pages: | Code Block |
|---|
<ac:structured-macro ac:name="projectdoc-display-table">
<ac:parameter ac:name="render-no-hits-as-blank">true</ac:parameter>
<ac:parameter ac:name="select">Name, Short Description, Doctype</ac:parameter>
<ac:parameter ac:name="sort-by">Sort Key, Name</ac:parameter>
<ac:parameter ac:name="where">$<TranscludedDocumentTitles>=[${Space Key}.${Name}]</ac:parameter>
</ac:structured-macro> |
| Tip Box |
|---|
If you want to show the transclusion information only to authors, you may hide the section dependent on user privileges. See Information for Audiences for details. |
| 
