Pagination - Fluid Topics - Latest

Fluid Topics Configuration and Administration Guide

Category
Reference Guides
Audience
public
Version
Latest

In the Reader page administration interface, ADMIN and PORTAL_ADMIN users can access the Pagination section under the General tab, and choose among the following options:

Pagination option Description
Infinite reader This is the default behavior. The content of the document dynamically appears as the user scrolls.
One topic per page Only one topic appears at a time. Users select Previous and Next buttons to read another page.
Custom pagination ADMIN and PORTAL_ADMIN users select at which table of contents level to create another page of content. Users select Previous and Next buttons to read another page.
It is possible to configure the display of parent topics. For example, parent topics can be repeated on all children pages, or displayed in their own page.
Content-driven pagination Only possible with DITA content or Markdown content. Creates section-by-section navigation based on DITA chunking, or the Markdown connector's table of contents file. Users select Previous and Next buttons to read another page.
  • It is possible to add metadata requirements to apply a pagination type to some types of content. It is possible to define pagination rules for shared Personal books by selecting metadata keys under the Edit properties menu.
  • For some pagination types, it is possible to choose whether to display a breadcrumb, or a secondary table of contents (also known as "mini TOC").

Use case

An administrator has the following objectives:

  1. Make infinite scrolling available for all content with the Content = Technical Notes metadata.
  2. Make section-by-section navigation available (split at Level 1 topics) for all other content.

The administrator adds two rules as follows:

A software interface for configuring pagination settings. There are two configured rules. The first rule is labeled 'Infinite reader for Category = Technical Notes'. The second rule is labeled 'Pagination at level 1 for all documents'.

Since Fluid Topics applies the rules in the order they are listed, the more specific rule applies first, and the more general rule applies to the remaining content.

As a result, all content without the Content = Technical Notes metadata appears as follows:

A Reader page with navigation buttons labeled 'Previous section' and 'Next section' at the end of a topic.

Meanwhile, all content with the Content = Technical Notes metadata appears as follows. Notice how the last topic of the first Level 1 section and the first topic of the second Level 1 section appear one after the other in the same page:

A Reader page with topics following one another continuously.