.png)
Overview:
The {excerpt-include} macro displays the an excerpt from another locaiton in your content...
This macro allows you to insert the excerpt from another page (or news item, etc) in to your content. It's useful if you want to provide a quick summary next to a link as you can use the pre-written summary for the page that the link refers to.
Parameters:
Add the macro to your page as follows:
{excerpt-include:page|nopanel=true/false}
| Parameter | Required | Notes |
|---|---|---|
| default |  |
The default "page" parameter must be a valid page (or news item) name within the same space as the content that is using the {excerpt-include} macro. |
| nopanel |  |
By default this is set to true and causes a panel to be drawn around the excerpt. If you set it to false the panel will not be displayed. |
Examples:
Hints and Tips:
If you're linking to another page that has an excerpt, including the exerpt for that page alongside the link ensures visitors know what's on the other end of the link. This is a great usability feature!
You can use the clickable macro to make the excerpt itself link to the other page - if it's also wrapped in a panel, it becomes a custom button.
Frequently Asked Questions:
| Q | How do I define an excerpt in the first place? |
|---|---|
| A | Use the excerpt macro. |
Comments (6)
Dec 20, 2006
Anonymous says:
There seems to be an issue with excerpt-include and the show-to macro. If I set...There seems to be an issue with excerpt-include and the show-to macro. If I set up a show-to section in a document, and then excerpt-include something from another page within that show-to, it sort of breaks. All formatting breaks down (but not necessarily all at once, which is weird).
Anyone else have this problem?
Charles Ellmaker
ETR Associates
Dec 21, 2006
Guy Fraser says:
If you use excerpt-include without the show-to macro does the formatting look ok...If you use excerpt-include without the show-to macro does the formatting look ok? I know that there are certain things where normal usage of the excerpt macro causes formatting to degrade, eg. I don't think macros in the excerpt will be rendered (or otherwise work properly) with the excerpt-include macro.
Feb 01, 2007
Anonymous says:
Sorry I wasn't watching this space. Further experimentation seems to suggest th...Sorry I wasn't watching this space.
Further experimentation seems to suggest that it's an issue of multiple show-tos embedded. Same with hide-from.
I'll have to experiment and see if that's the case.
Chas
Apr 19, 2007
Charles Ellmaker says:
Guy - Sorry for the long delay. Had been working on entirely different work bu...Guy -
Sorry for the long delay. Had been working on entirely different work but now am back on a confluence project.
If you have a construct such as:
deck
show-to some group
card
excerpt-include
card
show-to
deck
much of the simple formatting for what's in the excerpt breaks. That would include simple stuff like h1. , h2., etc. Oddly, more complex formatting such as a panel within the excerpt renders properly.
Formatting is correct if you don't use the show-to macro with a card
However, you can use show-to within the excerpt (as opposed to for the whole card or the whole deck), and then it formats correctly.
Further the same construct above, but without the excerpt-include (meaning, putting the content directly into the card intead of as an include) also works.
This may look like nit-picking, I'm sure, but if you use excerpts extensively in order to compartmentalize/simplify complex pages, this is a problem. We have lots of complex structures for which we want certain usergroups to see certain cards/tabs but not others, etc, and the pages become almost impossibly long and difficult to edit if we have to put everything on one page.
Any idea how this might be fixed?
Many thanks,
Chas
(ETR Associates/Gates Foundation)
Feb 20, 2008
Hugh Dolden says:
The notes for the nopanel parameter are reversed. Set nopanel=true to make the ...The notes for the nopanel parameter are reversed.
Set nopanel=true to make the panel invisible
Jul 17, 2008
Chris Mitchell says:
Is there a double negative in play in the Parameters, which state 'By default ...Is there a double negative in play in the Parameters, which state
'By default this is set to true and causes a panel to be drawn around the excerpt. If you set it to false the panel will not be displayed.'
Given that the Parameter is nopanel shouldn't this read
'By default this is set to false and causes a panel to be drawn around the excerpt. If you set it to true the panel will not be displayed.'
Or is it me?