Tellsanguis aba46f671c 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.

2025-11-15 15:00:45 +01:00

986 B

Raw Blame History

sidebar_position
2

Example

This is an example page in the Current Homelab category.

Description

This page demonstrates how to document a service or configuration of the current homelab.

Docker Compose Configuration

Example service configuration:

version: '3.8'

services:
  example-service:
    image: nginx:latest
    container_name: example
    ports:
      - "8080:80"
    volumes:
      - ./config:/etc/nginx/conf.d
    restart: unless-stopped

Ansible Playbook

Deployment example with Ansible:

---
- name: Deploy example service
  hosts: homelab
  become: yes

  tasks:
    - name: Copy docker-compose file
      copy:
        src: docker-compose.yml
        dest: /opt/example/docker-compose.yml

    - name: Start the service
      command: docker-compose up -d
      args:
        chdir: /opt/example

Maintenance

Important maintenance points:

Regular backups
Docker image updates
Log monitoring
Restore testing

986 B Raw Blame History