When creating your own pages, you can include other Pages and Excerpts.
Including Pages and Excerpts maintains a live link between pages. If the original content is updated, anywhere that content is included, it will be updated as well.
By including other pages and excerpt you can quickly build content which is super-easy to keep up-to-date.
| Info |
|---|
Regardless which editor you use, whenever creating documents, please follow |
The good (and the bad) of Confluence Excerpts and Include-pages:
A page can include any number of Excerpts.
A page can contain only one Excerpt.
An Excerpt can be part of a page, or the whole page.
An Excerpt can be used in any Page, from any Space, as long as you have permission.
An Excerpts retains the original formatting, headers, tables, etc.
Headers are retained and will show in the table of content of the page where it is included.
An Excerpt can blends seamlessly into the page where included.
Include-pages do not blend seamlessly into the page where included. Especially
| Status | ||||
|---|---|---|---|---|
|
| Info |
|---|
Use Include-page for including simple content. |
How to use Excerpts
Creating and including Excerpts is a two step process.
Step 1 - Create
The creator (yes, that can be you) makes part of a page available by using the Excerpt macro.
The macro creates a panel on the page.
The creator (again, that can be you) adds content in the panel.
The creator (can be you) Publish the page.
Step 2 - Include
After Publishing the page, the Excerpt is available for any user with permissions to the space where the page is published.
To include an excerpt in your pages, use the Excerpt Include macro.
To include an Excerpt:
Select the page where you want to include the excerpt.
Click the Edit icon.
Position your cursor where you want the content.
Type /excerpt
Select Excerpt Include from the popup
Type the first letters of the Excerpt you wish to include.
To include a page from another Confluence Space, prefix the page name with SPACEKEY and a colon.Select the Excerpt.
Select Remove Surrounding Panel.
Click the Refresh icon.
Check the Preview and click Save.
Click Publish.
| Note |
|---|
To see your updated content in another page or tab, hit the Refresh icon in your browser. |
Include-Page
You can include all content from a page by using the Include Page macro.
Edit the page.
Position your cursor where you want the content.
Type /include.
Select Include Page from the popup.
Type the first letters of the Page you wish to include.
To include a page from another Confluence Space, prefix the page name with SPACEKEY and a colon.
Select the page and click the Refresh icon.
Control the Preview and click Save.
Click Publish.
...
This is just a container for sub-sections used in the manual.