To use this feature of Scroll Documents you will need to install Scroll Viewport first. Trial the app for free for 30 days.
In Scroll Viewport, your content can come from multiple content sources. Content sources can be Confluence spaces or Scroll Documents.
The advantage of adding a Scroll Document as a content source is that it allows you to configure and show different versions of your content on your Viewport site.
Adding a Scroll Document to Viewport
To be able to select a Scroll Document in Viewport, make sure you create a document first.
Already have a site with a Confluence space as a content source and want to replace it with a Scroll Document? Learn how you can convert a space to a Scroll Documents.
To start, open Scroll Viewport (from your top navigation in Confluence select 'Apps' → Scroll Viewport) and create a new site or go to one of your existing sites.
To add content sources to your site, from the single site overview click on the plus (+) button on the top right of your Content sources table.
A new window will pop up where you can add one new content source at a time:
In the content source field, enter the name of your document. Type ‘document’ in the field to get a full list of all your Scroll Documents.
Select the space or document from the drop down list and click Next.
Select which versions you want to add to your site. Check at least one version from the list. Which versions should I add to my site?
Configure the URL path for each of your content sources. By default, Viewport will use the space key or document name for the content source segment of the URL.
Click save and see your content source appear in the content source table.
Click update site to go live with your new content source.
If you select two versions or more, a version picker will be added to your site. Use this picker to navigate between all the versions you selected for your site. Learn more.
You can always go back to the + button and add more documents to your live site. Don’t forget to update your site and go live so that the new documents appear in your live site.
Learn how to get the most out of Scroll Viewport.
Checklist for going live
The document title, cover image and document summary is used on the content source page and portal page of your Viewport site. Go to Edit document details in the Document Manager to change this information before you generate your site.
Make sure that the Scroll Documents you add have the right permissions set, so that Scroll Viewport can access its content and display it on your site.
The document version name will appear as a segment in all of the URLs of that content source. Check if you’re happy with the displayed version names and, if necessary, change the version name before going live. If you change the version name later on and update your site the URL paths in all article pages of that version will change as well. Any links that use the old version name would then break.