Excerpt and Excerpt Include macro
The Excerpt macro is used to mark a part of a page's content for re-use. Defining an excerpt enables other macros, such as the Excerpt Include to display the marked content elsewhere.
How to use Excerpt and Excerpt Include macros
You have a template with an excerpt include macro in it. After the instantiation you want the referenced page in the excerpt include to be updated.
Case 1 The Excerpt Include points to an Excerpt in the same page tree
Template page (Excerpt Include points to Template subpage)
→ Template subpage (contains Excerpt)
After the instantiation the Excerpt Include on the Template page will automatically point to the new subpage
New page (Excerpt Include points to the New subpage)
→ New subpage (contains Excerpt)
Case 2 The Excerpt Include points to a non existing page and is copied with the Page Tree Creator
The Excerpt Include can contain an invalid link with tags.
If your template contains an excerpt include with an invalid link, it will show an error message that the macro could not be rendered.
However when instantiating the template you can choose the space key and page title because of the two tags.
When the page is created it will point to a valid page and show the excerpt.
Excerpt Includes with valid references are only updated when in the same page tree.
If your excerpt include contains a valid link to a page which does not belong to the template (not in the copy process involved, then the link in the excerpt won't be updated, even if there are tags in the page title.
Learn more about
To learn more about the Excerpt macro.
To learn more about the Excerpt Include macro.