Amélioration configuration Docusaurus et implémentation i18n

- Add language switcher to navbar for bilingual site (FR/EN)
- Remove intro page, use presentation as entry point
- Add example pages to all documentation categories
- Configure categories with generated-index for page listings
- Update footer and homepage links to reference presentation
- Enhance configuration with best practices:
  - Add metadata and SEO keywords
  - Enable RSS/Atom feeds for blog
  - Configure sitemap generation
  - Add syntax highlighting for YAML, HCL, Docker
  - Enable Mermaid diagram support
  - Configure table of contents settings
  - Respect user color scheme preferences
  - Add last update metadata to docs
- Fix deprecated onBrokenMarkdownLinks configuration
- Create bilingual example pages with practical code examples
- Update all i18n translations for consistency

This update brings the site in line with Docusaurus 3.x best practices
and provides a solid foundation for documentation growth.
This commit is contained in:
Tellsanguis 2025-11-15 14:57:36 +01:00
parent fda75fdd28
commit aba46f671c
13 changed files with 558 additions and 85 deletions

View file

@ -2,34 +2,48 @@ import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
const sidebars: SidebarsConfig = {
tutorialSidebar: [
'intro',
'presentation',
{
type: 'category',
label: 'Notions',
link: {
type: 'doc',
id: 'notions/index',
type: 'generated-index',
title: 'Notions',
description: 'Concepts et notions techniques fondamentales utilisées dans mes projets.',
slug: '/category/notions',
},
items: [],
items: [
'notions/index',
'notions/exemple',
],
},
{
type: 'category',
label: 'Homelab actuel - Docker Compose & Ansible',
link: {
type: 'doc',
id: 'homelab-actuel/index',
type: 'generated-index',
title: 'Homelab actuel - Docker Compose & Ansible',
description: 'Documentation de mon infrastructure homelab actuelle, basée sur Docker Compose et Ansible.',
slug: '/category/homelab-actuel',
},
items: [],
items: [
'homelab-actuel/index',
'homelab-actuel/exemple',
],
},
{
type: 'category',
label: 'Futur Homelab - OpenTofu, K3S, Ansible & DevOps',
link: {
type: 'doc',
id: 'homelab-futur/index',
type: 'generated-index',
title: 'Futur Homelab - OpenTofu, K3S, Ansible & DevOps',
description: 'Documentation de la migration vers une infrastructure moderne basée sur Kubernetes et les pratiques DevOps.',
slug: '/category/homelab-futur',
},
items: [],
items: [
'homelab-futur/index',
'homelab-futur/exemple',
],
},
],
};