Skip to content
Navigation

Primary

Shared section settings with a page exception

The API reference section reads in a narrow column without a page outline. One page with a wide table needs a wider column. The page changes only the width and takes everything else from the section.

How it works

  1. section.json sits in the section folder. Every page in this folder and its subfolders gets its settings.
  2. The section makes the column narrow (container.max: 4) and turns off the page outline and the “Previous / Next” links.
  3. The page.json file named after the page changes one setting: the width. The page still has no outline and no previous/next links: the page did not touch them.

The order is: the site’s docara.json, then the sections’ section.json files from outer to inner, then the page’s page.json. Each next file changes only what it contains.

What you can change

Parameter What it changes
layout.container.max Text column width, from 1 to 8
reading.toc The page outline
reading.previous_next Links to neighbouring pages at the bottom
reading.breadcrumbs The “where am I” line above the title

See also