hass.tibber_prices/docs/user/sidebars.ts
Julian Pawlowski cbbfadbf4f refactor(docs): restructure navigation and split large pages
Split sensors.md (1,693 lines) into 7 focused pages:
- sensors-overview: binary sensors, core price, min/max, diagnostics
- sensors-average: median/mean, automation examples, key attributes
- sensors-ratings-levels: 3-level ratings + 5-level system
- sensors-volatility: CV formula, 4 sensors, configuration
- sensors-trends: outlook, trajectory, current/next, decision guide
- sensors-timing: period timing state diagram + examples
- sensors-energy-tax: energy/tax breakdown + use cases

Extract relaxation deep-dive from period-calculation.md into
dedicated period-relaxation.md. Remove duplicate ApexCharts section
from automation-examples.md (cross-references chart-examples.md).

Reorganize sidebar into semantic categories:
- Sensors (7 pages), Price Periods (2), Dashboards & Charts (4),
  Reference (sensor-reference + actions)

Update all cross-references across 10 pages, EntitySearch DOC_NAMES,
and generator template for new page slugs.

Impact: Users can find information faster with shorter, focused pages
and a clearer navigation structure. No content was removed — only
reorganized and deduplicated.
2026-04-11 10:33:58 +00:00

92 lines
2.2 KiB
TypeScript

import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
// This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)
/**
* Creating a sidebar enables you to:
- create an ordered group of docs
- render a sidebar for each doc of that group
- provide next/previous navigation
The sidebars can be generated from the filesystem, or explicitly defined here.
Create as many sidebars as you want.
*/
const sidebars: SidebarsConfig = {
tutorialSidebar: [
'intro',
{
type: 'category',
label: '🚀 Getting Started',
items: ['installation', 'configuration'],
collapsible: true,
collapsed: false,
},
{
type: 'category',
label: '📖 Core Concepts',
items: ['concepts', 'glossary'],
collapsible: true,
collapsed: false,
},
{
type: 'category',
label: '📊 Sensors',
items: [
'sensors-overview',
'sensors-average',
'sensors-ratings-levels',
'sensors-volatility',
'sensors-trends',
'sensors-timing',
'sensors-energy-tax',
],
collapsible: true,
collapsed: false,
},
{
type: 'category',
label: '⏰ Price Periods',
items: ['period-calculation', 'period-relaxation'],
collapsible: true,
collapsed: false,
},
{
type: 'category',
label: '🎨 Dashboards & Charts',
items: ['dynamic-icons', 'icon-colors', 'dashboard-examples', 'chart-examples'],
collapsible: true,
collapsed: false,
},
{
type: 'category',
label: '🤖 Automations',
items: ['automation-examples'],
collapsible: true,
collapsed: false,
},
{
type: 'category',
label: '📖 Reference',
items: ['sensor-reference', 'actions'],
collapsible: true,
collapsed: false,
},
{
type: 'category',
label: '👥 Community',
items: ['community-examples'],
collapsible: true,
collapsed: false,
},
{
type: 'category',
label: '🔧 Help & Support',
items: ['faq', 'troubleshooting'],
collapsible: true,
collapsed: false,
},
],
};
export default sidebars;