It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

How do I include a specific version of a page?

This question is in reference to Atlassian Documentation: Include Page Macro

Oftentimes, I need to include a specific (released) version of one page in another page. How can this be done?

2 answers

0 votes
Timothy Community Leader Jan 27, 2017

Don't think the Include Page Macro does that but you can place a link to the version of the page:

 

We want to be able to print a collection of specific versions of pages as PDF. For that, I need to include them, not just link them, right?

Correct, but the include macro will always take the current version of a page, that's what it's for.

Is there another macro then that is for including a specific version of another page?

No.

It's because a page in a wiki is in theory a live working document, so readers will generally always want to see the current version.

When doing documentation though, that can be wrong.  Atlassian themselves use "Scroll Viewport" on their own Confluence to support documentation properly.

No, I'm afraid not.

Conflluence is a wiki, with an implicit assumption that the users will want to see the current version of a page.

This doesn't work too well for documentation though, and it's a bit of a weakness IMHO.  Even Atlassian admit it implicitly - their docs on the products are, of course, held in Confluence.  With Scroll Viewport in use to enable Conflluence to do the required "fetch version of pages related to specific versions of products".

Scroll Viewport looks like an interesting solution that could solve our problems. Is something similar available also for Cloud hosting?

@Nic Brough _Adaptavist_ You mention Scroll Viewport to manage page versions for publications. There is also a plug-in App Scroll Versions which indicates to do this as well. Although the license price is much higher then for Scroll Viewport. Do we need to use the Scroll Version in combination with Scroll Viewport to publish specific page versions as a package or is this functionality also include in Scroll Viewport? We are looking into a solution to publish a certain package version of a space.

Hi @Henk Aarts, versions functionality is not included with Scroll Viewport, for this you would need Scroll Verisons.

Atlassian is using both Scroll Versions and Scroll Viewport to create, manage and publish their documentation. The version picker you see in Confluence documentation is achieved by publishing each version to a separate space with the help of Scroll Versions. The content on this published Confluence page is then added to a second "view" and presented with a custom Scroll Viewport template.

Scroll Versions is available for Confluence Server and can be tried out for free from the Marketplace.

Cheers,
Roman.

0 votes
Radek Janata Community Leader Feb 13, 2020

You can write your own user macro (we did it this way first but we had problems displaying embedded attachments/images from that page).

Or, you can use Adaptavist ScriptRunner for Confluence that has Include Version macro bundled. It displays embedded attachments/images correctly.

Check out their documentation:
https://scriptrunner.adaptavist.com/latest/confluence/macros/BundledMacros.html#_include_version_macro

Suggest an answer

Log in or Sign up to answer
TAGS
Community showcase
Posted in Confluence

Lessons and Learnings: Six Months of Working Remote [Discussion]

Hey there, folks! For most of us, the past six months- yes, you read that right- have been a journey. More people than ever before have pivoted to working remotely, and navigating being on-scre...

5,966 views 4 6
Join discussion

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you