SummaryInserts the contents of the specified page into the current one. Usage{include:Some page}
{include:spaceKey=KEY|pageTitle=Another page}
Parameters
NotesUsers without permission to view the included page will see an error that the page could not be found. A page cannot include itself or a page that includes itself. An error message will be displayed if this occurs. |
Comments (18)
Aug 08, 2005
Anonymous says:
Very nice macro! Solved a problem I was facing (mirroring pages). But I wonder i...Very nice macro! Solved a problem I was facing (mirroring pages). But I wonder if it can be improved such that the attachment etc. therein could be automatically working?
i.e., if I have a page titled "test" with an attachment "test.xls" in space abc, and its content is simply a link to attachment [display excel|^test.xls]. Now in space def I want to mirror abc:test, I simply create a new page "testmirror" and use the include macro. The problem is, the attachment is missing when viewing "testmirror". One way to solve this is to change the content of "test" to [display excel|abc:test^test.xls], but this is not ideal - when there's a need to rename "test" or move "test" to another space, the link in "test" would break again.
The more elegant way of handling this would thus be that the include macro processes the included content and add missing spacekey or page title when needed, on-the-fly. That'll solve all problems. I guess the difficulty of implementing it depends on how the macro itself is implemented.
Mingyi
Feb 12, 2007
Matt Ryall says:
The linking of content within the included page was fixed in Confluence 1.4. Ple...The linking of content within the included page was fixed in Confluence 1.4. Please raise a bug in JIRA if you find any more problems with this macro.
Nov 17, 2005
Bob Swift says:
Are there any plans to open this up to cross space includes? How about including...Are there any plans to open this up to cross space includes? How about including content from attachments, templates, files - see the scriptiong macros as examples of where content could be taken from? Of course with the proper handling of permissions.
Feb 12, 2007
Matt Ryall says:
Crossspace includes have been available since Confluence 1.4. I've updated the d...Cross-space includes have been available since Confluence 1.4. I've updated the documentation above to reflect this.
Attachment includes are dependent on the kind of content they contain. For Excel spreadsheets we have the Excel macro plugin. For other document types, please raise a feature request so we know what you would like to use.
May 10, 2006
Maria Kruse says:
Are there any plans to make it possible to tag sections of pages and include onl...Are there any plans to make it possible to tag sections of pages and include only specified sections?
We use wiki for most of our plans and that feature would make it possible to create a page which includes for example only the resourceplans for each project at one place.
May 10, 2006
Guy Fraser says:
You can do that with the Metadata Plugin CONFEXT:Metadata Plugin which essentail...You can do that with the Metadata Plugin which essentailly turns Confluence in to a giant spreadsheet
Jun 10, 2006
Ted Husted says:
You could use the excerptinclude and excerpt macros to indicate what block of te...You could use the excerpt-include and excerpt macros to indicate what block of text to include.
Oct 16, 2006
Stephanie Trunzo says:
I am also looking for this function. I don't want to just concatenate data chunk...I am also looking for this function. I don't want to just concatenate data chunks though, so I don't think the Metadata plugin works for me. I'd like for each of my writers to create content plans, and then I want to pull pieces of the various plans into anotehr page in the wiki.
Jun 28, 2006
Madhusudan GR says:
I have created a page which "includes" 45 other pages. Is it possible to create ...I have created a page which "includes" 4-5 other pages. Is it possible to create a view which can display all the pages included alongwith the original page, as a ONE BIG PAGE?
Thanks in advance
Madhu
Apr 20, 2007
Kevin Crosby says:
I'm not sure how to do this with the include macro, but you can use the reporter...I'm not sure how to do this with the include macro, but you can use the reporter macros. I used this handy recipe from Confluence bits.
Oct 09, 2006
Eva Andreasson says:
I am in need of the includefunctionality, but for pageID:s, not page titles. Is ...I am in need of the include-functionality, but for pageID:s, not page titles. Is this something you will add to the include macro, or is it possible to solve the need for including different versions of a page into another page??
Most greatful for a quick response...
/Eva
Feb 12, 2007
Matt Ryall says:
Sorry, Eva, this is not available at the moment. Page IDs would be the easiest w...Sorry, Eva, this is not available at the moment. Page IDs would be the easiest way of implementing this, so please raise a feature request on JIRA.
Mar 27, 2007
Julia says:
Is it possible to include News/Blog pages? The macro only seems to recognize "re...Is it possible to include News/Blog pages? The macro only seems to recognize "regular" Confluence pages.
Mar 27, 2007
Alex Holtz says:
Julia, Check out the \ macro for including news items. It has a variety of opti...Julia,
Check out the {blog-posts} macro for including news items. It has a variety of options for filtering/selecting which posts you want and then including them on a page.
Jul 09, 2007
Mark says:
The new page link is linked to here:The new page link is linked to here:http://confluence.atlassian.com/display/DOC/Include+Page+Macro
This just shows a JPG image, something is busted
Jul 10, 2007
Sarah Maddox says:
Hi Mark I've looked at the new page you linked in the above comment, and the pa...Hi Mark
I've looked at the new page you linked in the above comment, and the page looks OK to me. Please would you describe the JPG image and which page it's on (i.e. the new page or this outdated page)? Also, which browser are you using?
Thank you very much – Sarah
Feb 02, 2008
Anonymous says:
It would be a nice touch to add a parameter to turn off the error message result...It would be a nice touch to add a parameter to turn off the error message resulting from inadequate permissions. Its a really useful feature for building pages which are visible by all but allowing nuances in content for different people. I used it to publish a management report with general activity available to all but comments reserved for more limited viewing - but I still get the error message of course.
Feb 04, 2008
Ming Giet Chong says:
Hi, Thanks for the suggestion. I would suggest you to raise a feature request a...Hi,
Thanks for the suggestion. I would suggest you to raise a feature request at the issue tracker:
Regards,
MG
Add Comment