Aller au contenu principal

4 articles pour 'Générateurs de sites statiques'

Articles de blog sur l'usage des générateurs de sites statiques (SSG - Docusaurus, Hugo, MkDocs) pour créer des docs utilisateur et développeur.

Voir tous les mots-clés

Comment j'ai fait le SEO de mon site

· 6 minutes de lecture
Florence
Rédactrice Technique Expert

Mettre en œuvre un SEO concret sur un site Docusaurus, avec le GEO en ligne de mire

Le SEO fait partie de ces sujets dont tout le monde parle, mais que peu de personnes pratiquent réellement de bout en bout sur un vrai site. C'est un véritable métier, avec de vraies compétences, et certainement pas quelque chose que l'on improvise en se contentant de bourrer le <head> de mots-clés.

Lorsque j'ai construit CoffeeCup.tech, je ne voulais pas que le SEO reste une simple checklist théorique (contrairement à ce que j'ai pu faire pour mon précédent site Hugo Coffee Cup, je l'avoue).

Mon parcours d'IA – Épisode 2️⃣

· 4 minutes de lecture
Florence
Rédactrice Technique Expert

Le temps des travaux pratiques

Après avoir collecté tout ce que je pouvais sur l'intelligence artificielle (Épisode 1), élaboré des cas d'usages pour mon métier, j'ai décidé de passer de la théorie à la pratique en retravaillant entièrement mon site Web.

Objectif : appliquer mes nouvelles connaissances et tester, en conditions réelles, ce qu'une IA peut vraiment apporter à un professionnel du contenu.

Les fondamentaux de la doc en ligne

· 4 minutes de lecture
CoffeeCup
Rédactrice Technique Senior

L'évolution des fichiers d'aide : des pop-ups et frames à la simplicité du Markdown

Je crée de l'aide en ligne depuis les débuts — à l'époque où HTML régnait et où les éditeurs étaient en essentiellement en texte brut. Beaucoup de choses ont changé, mais certains fondamentaux restent solides.
Dans cet article, je retrace l'évolution de l'aide en ligne, de RoboHelp et des structures en trois frames jusqu'à l'univers plus épuré du Markdown et des générateurs de sites statiques. Un mélange de nostalgie, de pragmatisme — et toujours dans l'objectif d'améliorer la documentation.

J'ai testé Docusaurus V2

· 4 minutes de lecture
CoffeeCup
Rédactrice Technique Senior

Migrer en toute confiance : de Hugo à Docusaurus V2

Cet été, je me suis replongée dans la documentation d'un client avec une double mission : expliquer leur nouvelle API et migrer l'ensemble du site vers Docusaurus V2.
Du moteur de recherche aux admonitions stylisées en passant par l'intégration ReDoc, cette version ne se contente pas d'être belle — elle fonctionne brillamment. Voici ce que nous y avons gagné, et ce à quoi il faut faire attention.