Interface en ligne de commande

Lumen s’appuie sur le CLI d’Astro et ajoute des commandes spécifiques pour gérer le cycle de vie de votre documentation.

Commandes principales

`astro dev`

Lance le serveur de développement avec rechargement à chaud (HMR).

pnpm dev
# équivaut à :
pnpm astro dev

Options disponibles :

Option	Description
`--host`	Expose le serveur sur le réseau (par défaut : localhost).
`--port`	Port du serveur (par défaut : 4321).
`--open`	Ouvre automatiquement le navigateur.

Exemple :

pnpm astro dev --host 0.0.0.0 --port 3000

`astro build`

Génère le site statique pour la production. Le résultat est placé dans le dossier dist/.

pnpm build
# équivaut à :
pnpm astro build

Options disponibles :

Option	Description
`--verbose`	Affiche les logs détaillés du processus de build.
`--drafts`	Inclut les pages marquées comme brouillons.

`astro preview`

Sert localement le site généré pour prévisualiser le rendu de production.

pnpm preview

`astro check`

Vérifie les types TypeScript dans l’ensemble du projet sans générer de sortie. Utile pour détecter les erreurs avant le build.

pnpm astro check

Commandes Starlight

Génération de types

La commande astro sync génère les types TypeScript pour les collections de contenu et la configuration.

pnpm astro sync

Cette commande s’exécute automatiquement avant astro dev et astro build. Lancez-la manuellement si vos types semblent désynchronisés.

Analyse du contenu

L’outil Pagefind indexe automatiquement votre contenu pendant le build. Pour vérifier l’index en développement :

pnpm build
pnpm preview

La recherche est disponible côté client et ne nécessite pas de serveur externe.

Scripts recommandés

Voici les scripts à configurer dans votre package.json pour un flux de travail optimal :

{
  "scripts": {
    "dev": "astro dev",
    "start": "astro dev",
    "build": "astro build",
    "preview": "astro preview",
    "astro": "astro",
    "check": "astro check",
    "check:watch": "astro check --watch",
    "format": "prettier --write .",
    "format:check": "prettier --check ."
  }
}

Script	Usage
`dev` / `start`	Développement local avec HMR.
`build`	Génération du site statique.
`preview`	Prévisualisation du build de production.
`check`	Vérification des types TypeScript.
`check:watch`	Vérification continue pendant le dev.
`format`	Formatage automatique du code.
`format:check`	Vérification du formatage (CI).

Variables d’environnement

Le CLI respecte les variables d’environnement standard d’Astro :

Variable	Description
`PORT`	Port du serveur de développement.
`HOST`	Hôte du serveur de développement.
`NODE_ENV`	Environnement (`development` ou `production`).
`SITE`	URL de déploiement (utilisée pour les liens canoniques).

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.