Dalibi — Documentation

Site de documentation de Dalibi (logiciel de gestion scolaire open source), propulsé par Nextra 3 (thème nextra-theme-docs) sur Next.js 14 (Pages Router).

Stack

• Next.js 14 (Pages Router)
• Nextra 3 + nextra-theme-docs (sidebar, recherche plein-texte, MDX, fil d'Ariane)
• React 18

Nextra 4 (App Router) s'est révélé instable avec la dernière version de Next ; on s'appuie donc sur Nextra 3, éprouvé et stable.

Démarrage

npm install
npm run dev      # http://localhost:3000

Structure

• pages/ — pages de documentation en MDX + _meta.js (ordre et libellés de la sidebar).
• pages/_app.jsx — importe le style du thème (nextra-theme-docs/style.css).
• theme.config.jsx — configuration du thème (logo, lien GitHub, footer, recherche…).
• next.config.mjs — intégration Nextra (withNextra).

Ajouter une page

1. Créer un fichier pages/ma-page.mdx (un frontmatter title est recommandé).
2. Ajouter une entrée dans pages/_meta.js pour l'ordre et le libellé dans la sidebar.

Build

npm run build
npm run start

Projet séparé du site vitrine (dalibi-showcase) afin d'isoler le thème Nextra et ses versions. Le site vitrine renvoie vers cette documentation.