 |
Page History
Consider using an excerpt or multiexcerpt 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 multiexcerpt 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 or a multi-excerpt, rather than an excerpt, because it is easier to keep track of where they are used. For information, refer to Finding Where Reused Content Appears or Including the Content of a Page on Another Page.
| Wiki Markup |
|---|
{scrollbar:icons=false} |
...
This page and the following child pages , listed below, demonstrate including an excerpt from one or more pages page on another page.
| Panel | ||
|---|---|---|
| ||
|
Refer to these pages to see the markup for the excerpt and multi-excerpt.
Include Macro Example
The include macro allows you to include an entire page in the same space on another page. Includes can be tagged by means of labels, making them easier to track than excerpts and multi-excerpts.
The following is an included page with one line of text. The page is a child of this one.
...
The markup is:
| Code Block |
|---|
{include:Test Page To Include} |
Excerpt Macro Example
The excerpt macro has a limitation; you can only define one excerpt on a page.
This is the markup:
| Code Block |
|---|
{excerpt-include:Page with Second Excerpt}
|
The markup is rendered as follows:
...
Multi-Excerpt Include Example
This is the markup to place on the page that has the content you want to render into another pager:
| Code Block |
|---|
{multi-excerpt:name=excerptName}
...
{multi-excerpt}
|
This is the markup to place on the page where you want to put content from another page:
| Code Block |
|---|
{multi-excerpt-include:pageTitle=Page with Multi Excerpts|name=Information one page one|nopanel=true}
{multi-excerpt-include:pageTitle=Page with Multi Excerpts|name=Information two page one|nopanel=true}
|
The markup is rendered as follows:
| Wiki Markup |
|---|
{multi-excerpt-include:pageTitle=Page with Multi Excerpts|name=Information one page one|nopanel=true} |
To view the Confluence editor view of the macros in use:
- Open the child pages.
- Click the Tools (...) icon above the page title, on the right side of the page.
- Select View Source.
Example of including an excerpt
The following is an example of the Excerpt include macro. The excerpt is in italics.
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
For instructions, refer to the following Atlassian help pages:
- https://confluence.atlassian.com/conf613/excerpt-macro-964960810.html
Multiexcerpt include MultiExcerptName ExitDisclaimer nopanel true PageWithExcerpt wikicontent:Exit Disclaimer to Include - https://confluence.atlassian.com/conf613/excerpt-include-macro-964960809.html
Multiexcerpt include MultiExcerptName ExitDisclaimer nopanel true PageWithExcerpt wikicontent:Exit Disclaimer to Include
Example of including multiple excerpts
The following is an example of a Multiexcerpt include macro. The multiexcerpt is in italics.
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
The following is another example of a Multiexcerpt include macro, for a multiexcerpt on the same page. The multiexcerpt is in italics.
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
| Tip |
|---|
| Wiki Markup |
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 |
...
| Code Block |
|---|
| {multi-excerpt-include:spaceKey:pageName|name=excerptName|nopanel=true}
. The page title is in the form "spacekey:pageName." |
| Note |
|---|
If you include multi-excerpts Multiexcerpts inside one another (nest them) bulleted lists will not render be rendered properly. Links in a multi-excerpt Multiexcerpt include may not render be rendered properly in another multi-excerpt Multiexcerpt include. |
| Wiki Markup |
For instructions, refer to the following Atlassian help page:
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
