Draconai Documentation

dd_id_52033e6ee3
5. Documentation (Meta)

Page Categories

page_categories

Overview

  • Documentation pages are grouped by categories for navigation.
  • Categories show in a right-hand column on most pages.
  • Clicking a category opens a list of pages in that category.
  • The Categories index lists all categories alphabetically with page counts.

Categories

  • database_tables
  • routes
  • docker
  • workflow
  • email
  • user
  • server
  • ui

Assignment Rules

  • Rules are based on page slugs (auto-assigned).
  • Multiple categories can be assigned to the same page.
  • Examples:
  • table-* -> database_tables
  • route-* -> routes
  • service-* / *docker* -> docker
  • deployment, work-queues, processes, freshness-watchdog, workflows -> workflow
  • *email* / *mail* -> email
  • *user*, *account*, *profile*, login, register, reset-password -> user
  • server* -> server
  • UI pages (menus, themes, sidebars, login/register) -> ui

Implementation

  • Plugin: server/var_www/devdocs_wp/wp-content/plugins/dracon-doc-categories/doc-categories.php.
  • Taxonomy: doc_category (public, taxonomy archive enabled).
  • Theme category listing: server/var_www/devdocs_wp/wp-content/themes/draconai/index.php.
  • Category archive template: server/var_www/devdocs_wp/wp-content/themes/draconai/taxonomy-doc_category.php.
  • Categories index page: server/var_www/devdocs_wp/wp-content/themes/draconai/page-categories.php.
  • The category archive sidebar omits the categories widget; only child navigation remains.