hass.tibber_prices/docs/user/sidebars.ts
Julian Pawlowski d73eda4b2f git commit -m "feat(docs): add dual Docusaurus sites with custom branding and Giscus integration
- Split documentation into separate User and Developer sites
- Migrated existing docs to proper Docusaurus structure
- Added custom Tibber-themed header logos (light + dark mode variants)
- Implemented custom color scheme matching integration branding
  - Hero gradient: Cyan → Dark Cyan → Gold
  - Removed standard Docusaurus purple/green theme
- Integrated Giscus comments system for community collaboration
  - User docs: Comments enabled on guides, examples, FAQ
  - User docs: Comments disabled on reference pages (glossary, sensors, troubleshooting)
  - Developer docs: No comments (GitHub Issues/PRs preferred)
- Added categorized sidebars with emoji navigation
- Created 8 new placeholder documentation pages
- Fixed image paths for baseUrl compatibility (local + GitHub Pages)
- Escaped MDX special characters in performance metrics
- Added GitHub Actions workflow for automated deployment
- Created helper scripts: dev-user, dev-developer, build-all

Breaking changes:
- Moved /docs/user/*.md to /docs/user/docs/*.md
- Moved /docs/development/*.md to /docs/developer/docs/*.md
2025-12-06 01:37:06 +00:00

63 lines
1.5 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: '📊 Features',
items: ['sensors', 'period-calculation', 'dynamic-icons', 'icon-colors', 'actions'],
collapsible: true,
collapsed: false,
},
{
type: 'category',
label: '🎨 Visualization',
items: ['dashboard-examples', 'chart-examples'],
collapsible: true,
collapsed: false,
},
{
type: 'category',
label: '🤖 Automation',
items: ['automation-examples'],
collapsible: true,
collapsed: false,
},
{
type: 'category',
label: '🔧 Help & Support',
items: ['faq', 'troubleshooting'],
collapsible: true,
collapsed: false,
},
],
};
export default sidebars;