Je choisis VitePress pour mon site personnel

Depuis des années, j'essaie de construire un site personnel qui me corresponde. Jusqu'à présent, je n'ai jamais réussi. Et peut-être que cette tentative échouera aussi, mais je n'ai jamais été aussi confiant dans mon choix. Laissez-moi vous expliquer pourquoi !

Le Site Personnel ​

À première vue, je dois admettre que construire un site personnel semble facile. Si facile que c'est le premier véritable projet que j'ai réalisé il y a 5 ans, esteban-s-website, avec Express.js lorsque j'apprenais Node.js.

Après cela, j'ai essayé d'utiliser Nuxt 2, esteban-soubiran.site/tree/v2, puis Nuxt 3, esteban-soubiran.site, mais à la fin, il manquait toujours quelque chose. Je n'étais jamais satisfait du résultat et l'utiliser n'était pas un plaisir. S'il n'y a pas de plaisir, il n'y a pas de motivation à le maintenir. Alors quel est l'intérêt d'avoir un site personnel ?

Je veux être fier de mon site pour le montrer à tout le monde, mais ces tentatives étaient clairement l'opposée de ce que je voulais.

Histoire ​

Construire un site personnel est bien plus compliqué que je ne le pensais.

Au cours du chemin d'apprentissage et de construction de sites web, j'ai beaucoup évolué, tant dans mes besoins que dans mes compétences et les choses que j'apprécie.

Au début, je voulais créer un site avec une base de données, un éditeur markdown, et une authentification comme je le voyais dans des tutoriels et de nombreux sites. Mais pourquoi voulais-je quelque chose d'aussi complexe ? Pour apprendre et écrire des articles. Et au final, j'ai beaucoup appris mais je n'ai jamais écrit d'articles car déployer une telle chose, pour un débutant, est un cauchemar. Et j'étais un débutant.

Pour mon prochain site de blog, je me suis demandé pourquoi je voulais construire ce site personnel. C'est bon pour le CV et c'est une façon d'essayer de nouvelles choses. C'est exactement ce que j'ai fait. J'apprenais Nuxt 2 alors je l'ai utilisé. Pour cette deuxième tentative, je n'imaginais jamais écrire des articles.

Un jour, je pensais à publier un article, un tutoriel pour apprendre Adonis 5, mais je n'avais nulle part où le publier. J'ai fini par le publier sur dev.to. Je n'étais pas satisfait. L'expérience n'était pas bonne et je n'avais aucune sauvegarde de mon article.

Quelques mois plus tard, j'ai décidé de réécrire mon site depuis zéro en utilisant Nuxt 3. Avoir une section d'articles était sur la feuille de route mais essayer de nouvelles choses était l'objectif principal, encore une fois.

Et aujourd'hui, je suis ici, en train de reconstruire mon site personnel encore une fois. Le temps passe mais maintenant, je sais exactement ce que je veux.

Besoins ​

La première chose que je veux, c'est un blog. Je veux pouvoir créer et publier du contenu facilement. Ma façon préférée d'écrire est d'utiliser markdown dans mon éditeur de texte. J'adore cette expérience grâce à des plugins qui m'aident à mieux écrire.

Ce markdown doit être personnalisé pour avoir des composants personnalisés et une syntaxe étendue comme les alertes GitHub.

Je veux un blog sans maintenance. Moins j'ai à faire pour publier un article, mieux c'est. Je ne veux pas mettre à jour mon site tous les jours à cause de problèmes de sécurité ou à cause d'une nouvelle version d'un package. Moins j'ai de dépendances, plus j'ai de temps pour écrire.

Je veux être capable de créer un flux RSS et une image Open Graph pour chaque article. Je veux que ce processus soit facile et automatique lorsque je publie un article.

La chose à retenir est que je veux me concentrer sur le contenu, pas sur le code.

Outils ​

Je sais comment construire un site web en utilisant WordPress, Adonis, Astro, Nuxt, et Vite avec Vue.

Étant donné mes besoins, WordPress et Adonis ne sont pas les meilleurs choix. Je ne veux pas maintenir un serveur et une base de données. Pour Adonis, il y a un moyen de générer un site statique, mais ce n'est pas documenté. Je ne veux pas perdre de temps là-dessus.

Nuxt avec le plugin Content est un bon choix, mais au cours de l'année passée, j'ai créé de nombreux sites avec cette pile. L'expérience développeur du plugin Content est terrible. Cela rend le serveur de développement (jusqu'à 30 secondes pour démarrer) et la construction lente (jusqu'à 2 minutes), et cela demande trop de maintenance. Je ne veux plus l'utiliser pour ce genre de projet.

Astro est un bon choix. C'est rapide et prêt à l'emploi. Le seul inconvénient que je vois est qu'il pourrait avoir trop de fonctionnalités. J'ai l'impression qu'il est trop facile de créer un désordre, et configurer le module de contenu n'est pas quelque chose que je veux faire.

Créer un projet personnalisé en utilisant Vite et Vue est aussi un bon choix pour plonger profondément dans les plugins de Vite. Cette technologie alimente le site d'Anthony Fu, donc j'ai un bon exemple à suivre.

Je vais construire mon prochain site en utilisant un projet personnalisé avec Vite et Vue. C'est décidé (c'est ce que je pensais).

Choix Final ​

3 jours après avoir choisi et commencé à construire mon site, j'ai utilisé VitePress au travail pour documenter un ensemble de fonctions. C'était un plaisir à utiliser, mais le modèle est orienté vers la documentation. Je ne veux pas d'un site personnel qui ressemble à un site de documentation.

2 jours plus tard, Evan You a annoncé VitePress 1.0 et a dit :

Lisez la suite pour savoir pourquoi nous pensons que c'est l'un des meilleurs moyens de construire des sites statiques (pas seulement des docs !)

Mmmh, cela attise ma curiosité. Alors j'ai lu chaque page de la documentation, et j'étais là, "c'est ce que je veux." Ça correspond parfaitement à mes besoins.

La Réalité Derrière VitePress ​

En réalité, VitePress est un outil qui analyse des fichiers Markdown pour créer des routes et les afficher en HTML. La partie documentation n'est qu'un thème, une couche au-dessus de ce noyau puissant avec routage basé sur des fichiers, analyse markdown, hooks, chargement de données au moment de la construction, et SSG.

Cela signifie que nous pouvons utiliser ce noyau puissant pour construire notre site personnel avec notre thème. Et c'est exactement ce que je vais faire. Enfin, ce noyau est ce que j'essayais de construire avec la pile Vite et Vue. Avec VitePress, c'est une dépendance, et je peux me concentrer sur le contenu dès le premier jour. Écrire un thème est très facile car c'est uniquement esthétique. Le noyau est déjà là.

Je vais garder ce blog aussi minimal que possible, et grâce à VitePress, écrire du contenu et le déployer est maintenant un jeu d'enfant.

Vous devriez vraiment essayer VitePress, malgré le marketing orienté vers un constructeur de documentation. Ça en vaut vraiment la peine, et c'est bien mieux que vous ne le pensez. 📖