Skip to content

Overview

Knowledge is a reading-first theme for product documentation, help centres, technical handbooks, and API references. It provides a structured documentation frame with a navigation tree, search-led landing content, long-form article aids, changelog and API-reference sections, callouts, and reader feedback presentation.

  1. Open the theme-management extension entry for Knowledge Base and activate the Knowledge theme for the intended site.
  2. In Theme Studio, choose Knowledge for the light paper-style preset or Late Edition for the dark reading preset, then adjust the standard theme controls.
  3. Build documentation pages in Layout Builder. Place the document tree in the Knowledge-only sidebar area and add the relevant article, table-of-contents, API-reference, changelog, callout, search, or feedback sections to the page.
  4. Preview long pages and the sidebar at desktop and mobile sizes before making the changes live.
  • A responsive documentation frame with a theme-scoped sidebar.
  • Sections for document trees, in-article navigation, search, changelogs, API parameters, admonitions, and article feedback.
  • Optional links into Knowledge Base and frontend Search when their public routes are available.
  • Install Foundation Theme and Layout Builder first.
  • This theme is separate from the Knowledge Base package. The theme controls presentation; Knowledge Base owns collections, articles, feedback storage, and its public endpoints.
  • When Knowledge Base or its public routes are unavailable, search and feedback sections stay in a non-submitting fallback state instead of exposing a broken or signed admin URL. Feedback is enabled only when the rendered widget has both collection and article context.
  • The theme adds no package-specific settings, permissions, public routes, or database tables. Content access, publishing, and retention remain the responsibility of the packages that own the underlying content.
  • capell:theme-knowledge-demo can install sample pages for selected sites and languages. Existing populated layouts are preserved unless you deliberately pass --force; replace fictional documentation and endpoints before publishing.

For developers: see the README.