Scroll Viewport is an add-on and framework that makes it very easy to use Confluence as a Content Management System for websites, intranets, documentation sites, and more. However, Scroll Viewport is not a Confluence theme. Other than Confluence themes, Scroll Viewport does not replace the Confluence user interface. Instead, it uses a CMS-like approach by separating viewing the styled content from editing in the Confluence UI. It provides a completely separate way to access pages and blog posts in Confluence.
In order to separate the viewing of the styled content, Scroll Viewport defines the concept of viewports. Each viewport has a unique URL at which the content is displayed in a styled manner (left part of the image), while the authors who edit the content can access Confluence just like they know it (right).
URLs in Scroll Viewport
Scroll Viewport takes great care that URLs are readable and work well for SEO. Therefore Scroll Viewport works with completely different URLs than Confluence.
Each URL in a viewport is has two parts: The Viewport URL, used to lookup a configured viewport, and the path in viewport, used to lookup a page or blog post within the viewport.
Examples 1: Viewport URL with hierarchical path naming
Examples 2: Viewport URL with flat page naming.
Please note that in both examples the viewport URL is the same.
A Viewport URL can define a domain name and a path prefix. The domain name can be configured, if the viewport should be accessible under another domain name than the Confluence installation. The path prefix is the beginning of the path of the HTTP request.
- http://confluence.acme.com/intranet could be the Viewport URL for the viewport for the intranet space.
- http://www.acme.com is the Scroll Viewport URL for the viewport for the pages in (public) website space.
- http://blog.acme.com is the Scroll Viewport URL for the viewport for the blog posts in the (public) website space.
- http://docs.acme.com/product is the Scroll Viewport URL for the product documentation in the product documentation space.
As you can see, viewports can have a different domain name than the confluence system.
When a user accesses the viewport URL, Scroll Viewport will display the content of the home page of the configured Confluence space.
Paths In Viewport
When a user navigates within a viewport, the remainder of the URL (after the Viewport URL) is used to look up the page within a viewport. The path in viewport can be different, depending on the content types, and the URL naming of the viewport.
- The path to pages in a viewport can be constructed differently:
- based on the hierarchy of the pages in the space, for example /administrators-guide/installation
- the flat URL naming is useful for spaces with deep hierarchies or long page titles. Scroll viewport will use the page id in the URL to look up the page: http://docs.acme.com/installation-guide-235314.html
- The path to blog posts start with /blog/YYYY/mm/. Example: http://www.acme.com/blog/2015/02/website-runs-on-scroll-viewport
Since Scroll Viewport 2.0 viewports can display both pages and blog posts (previously a viewport could only display either of them).
Themes define how the pages or blog posts are rendered. Therefore themes contain templates and static resources. Scroll Viewport comes with the default Viewport theme, but additional themes are available for download or can be developed by a web designer.
Themes can be downloaded and installed as Confluence plugins, but Scroll Viewport is actually also a theming framework that lets web designers easily develop their own themes. Please refer to the Developer's Guide for more information.
Depending on the users' permissions and the configuration, they use Scroll Viewport and Confluence differently:
- "Normal" users access the content through a viewport. If they don't need to view or edit the page in Confluence, it is possible to automatically redirect them to the viewport if they are trying to access a Confluence page directly.
- Authors use the normal Confluence UI to create and write content.