Consider using an excerpt or mutliexcerpt in the following cases:
- Displaying excerpts in a Page Tree or Children Display macro. For information, refer to Putting a List of Child Pages on a Page.
- Displaying excerpts from blog or news posts. For information, refer to Attracting Attention to the Blog (News) Posts.
- Displaying a mutliexcerpt to mark a link as external. For information, refer to Marking Links as External to US Government.
If you want two wiki pages to display the same content, consider using an Include page, rather than using an excerpt or mutliexcerpt, because it is easier to keep track of Include pages. You can look at the Page Information page for an Include page to see where it is used, but it is very difficult to determine where an excerpt or multi-excerpt is used. For information, refer to Including the Content of a Page on Another Page.
This page and the following child pages demonstrate including an excerpt from one page on another page.
Open the child pages and on the Tools menu select View Source to see the Confluence editor view of the macros used.
Example of including an excerpt
The following is an example of the Excerpt include macro. The excerpt is in italics.
This is an Excerpt on a page titled "Page with Excerpt." Excerpts are useful, but each page can have only one. The Multiexcerpt macro allows for creating as many excerpts as needed on a single page.
To create an Excerpt include
- Navigate to the place on the page where you want to include the content from another page.
- Type {exc
- When the list of macros opens, select Excerpt Include and enter the name of the page with the excerpt.
- Select the option to Remove Surrounding Panel if desired.
Example of including multiple excerpts
The following is an example of a Multiexcerpt include macro. The multiexcerpt is in italics.
This is a multiexcerpt on the page titled "Page with Multiexcerpts" and having the name MultiExcerptExampleOne. Use the Multiexcerpt macro to create more than one excerpt on any page.
The following is another example of a Multiexcerpt include macro, for a mutliexcerpt on the same page. The multiexcerpt is in italics.
This is a multiexcerpt on the page titled "Page with Multiexcerpts" and having the name MultiExcerptExampleTwo. This shows more than one excerpt on a single page for including on another page.
To create a Multiexcerpt include
- Navigate to the place on the page where you want to include the information.
- Type {multiexcerpt
- When the macro browser opens, select Multiexcerpt Include and enter the name of the page with the mutliexcerpt and the name of the multiexcerpt.
- Select the option for no panel if desired.
You can define as many excerpts as needed on a single page with the Multiexcerpt macro. You can include a Multiexcerpt from a page in another space. The page title is in the form "spacykey:pageName."
If you include Multiexcerpts inside one another (nest them) bulleted lists will not be rendered properly. Links in a Multiexcerpt include may not be rendered properly in another Multiexcerpt include.
