Rédiger des articles de blog

Configuration et paramètres

Avant toute étape, lisez Avant de commencer et Principes de base du terminal. Ces instructions supposent que vous avez ouvert le monorepo supastack complet dans VS Code ; sa racine package.json marque la racine du référentiel. Dans les commandes pnpm, un package d'espace de travail est une application ou un dossier de code partagé ; dans le produit, un espace de travail est le conteneur de données et la limite de sécurité d'une équipe. corepack pnpm --filter ... sélectionne un package dans le monorepo tandis que les commandes sont exécutées à partir de sa racine. Si vous avez ouvert uniquement un dossier mobile ou de bureau synchronisé, il ne contient pas le backend Web, la configuration Docker ou les scripts racine : exécutez le backend à partir de ce monorepo ou d'un serveur hébergé accessible et utilisez les propres scripts du dossier de plateforme. Une variable d'environnement est un paramètre nommé stocké dans un fichier .env local ou dans votre tableau de bord d'hébergement ; redémarrez l'application concernée après l'avoir modifiée et conservez les secrets du serveur en dehors des valeurs NEXT_PUBLIC_ et EXPO_PUBLIC_.

1. Dans VS Code, ouvrez apps/web/src/resources/content.ts et copiez un article complet à proximité comme point de départ ; la copie de l'article se trouve dans le référentiel, pas dans un tableau de bord de publication.

2. Donnez à l'article un nouveau slug, un titre, une catégorie, une date, des sections et un nouveau slug de guide existant.

3. À partir de la racine du référentiel, exécutez corepack pnpm --filter @supastack/web dev et ouvrez http://localhost:3000/blog/<your-slug>.. Attendu : l'article et son lien de guide associé se chargent localement avant de partager le URL.

Le contenu du blog est stocké dans src/resources/content.ts et blog-posts.ts ; il est géré dans le dépôt, sans service CMS de publication. Chaque Post exige un slug, un titre, une description, une catégorie, une date, un guide associé et des sections uniques.

{
  slug: 'your-article',
  title: 'A specific reader question',
  category: 'Guides',
  date: '2026-09-07',
  guide: 'web/local-setup',
  sections: [{ id: 'start', title: 'Start here', paragraphs: ['Your original text.'] }]
}

Commandes à copier

Suivez les commentaires pour voir dans quel dossier une commande s'exécute. Si deux terminaux sont étiquetés, ouvrez deux fenêtres de terminal et laissez la première commande s'exécuter pendant que vous utilisez la seconde.

corepack pnpm --filter @supastack/web dev

# Replace <your-slug> with the article slug:
# http://localhost:3000/blog/<your-slug>
corepack pnpm test -- apps/web/src/resources/content.test.ts

Processus d’implémentation

Suivez un objet Post existant complet pour renseigner les autres champs de type. Gardez le slug stable après publication afin que les URL partagées continuent de fonctionner. Chaque titre de section doit avoir un identifiant unique pour la table des matières et les liens d’ancrage.

Les catégories sont dérivées du catalogue d’articles. L’index utilise un filtrage par URL et les routes d’articles génèrent leurs métadonnées à partir du contenu. La valeur guide doit correspondre à un slug de documentation existant ; le contenu associé doit proposer une suite utile.

Vérification et dépannage

Si l'article renvoie 404, vérifiez que son slug est unique et qu'il a été ajouté à la liste d'articles dans apps/web/src/resources/content.ts.. Si la table des matières ne saute nulle part, attribuez à chaque section un identifiant unique. Exécutez corepack pnpm test -- apps/web/src/resources/content.test.ts à partir de la racine pour afficher les erreurs de validation de contenu.

Exécutez les tests de contenu, ouvrez la route de l’article, suivez son guide associé et vérifiez l’index filtré. Vérifiez les dates et les affirmations par rapport à leur source. Ne publiez pas de liens provisoires et n’affirmez pas qu’une intégration a été validée uniquement parce qu’elle est mentionnée dans un article.