Au départ mon blog était constitué d’une suite de pages. A chaque modification de structure il fallait repasser sur toutes les pages. Je suis passé par les iframes, la génération de code en JavaScript…​ Mais je n’étais pas satisfait.

Les premiers CMS sont apparus mais en tant que développeur je n’avais pas envie d’aller vers des solutions toute prêtes. Avec les hébergements PHP gratuits, je me suis créé un petit framework MVC en PHP utilisant des templates, et qui me facilitait la création de pages. Je ne dénigre pas le langage PHP mais je n’ai jamais été vraiment fan. J’ai donc essayé de générer mon blog en Java. Mais je me suis rendu compte que des langages comme PHP ou Java ne simplifiaient pas grand chose et que mes solutions étaient un peu lourde pour servir quelques pages statiques…​

Comme mes différents essais étaient non concluants je me suis résigné à utiliser un CMS en 2010. J’aurai pu mettre en place un site WordPress mais je voulais aller vite. J’ai donc choisi de publier mes articles sur un CMS en ligne et je me suis rabattu sur https://www.blogger.com. Certes la personnalisation est limitée mais ces outils visuels permettent de vite publier du contenu, de faciliter le référencement, de générer les liens pour relayer les articles sur les réseaux sociaux…​

Ce cadre imposé par les CMS m’a laissé insatisfait. Je préfère coder que paramétrer. J’ai donc continué d’expérimenter. J’ai créé des maquettes de blog écrites en Angular qui avaient le mérité d’être full stack web, de proposer des templates…​ Mais là je me suis heurté aux problèmes de référencements…​

J’ai testé Jekyll notamment via l’intégration sous Github pages. Ecrire des articles au format markdown est sympa, on se rapproche d’une solution qui me plait. Mais j’aimerai une solution que je puisse intégrer facilement à mon site institutionnel en modifiant simplement mon process de build existant…​

Toutes ces expérimentations m’ont en fait permis de savoir ce que je voulais, qu’elle était ma solution idéale. Je parle de MA solution idéale car vous avez le droit de ne pas être d’accord avec moi.

Une solution idéale pour mettre en place un blog ou un site perso doit à mon sens proposer les choses suivantes

En 2015 la keynote de Dan Allen à MiXiT m’a inspiré. Mais comme beaucoup de personnes qui font de la veille technique j’ai incrit Asciidoctor tout en bas de ma liste des choses à creuser et comme ce sujet n’était pas prioritaire, je l’ai un peu oublié. En 2016 je me suis réveillé lors de l’intervention de Hubert Sablonière au Lyon Jug. Il était venu présenter l’écosystème Asciidoctor et il a réveillé mon besoin de mettre à jour mon site et mon blog. Je dois dire que j’ai eu un peu de mal pour démarrer car je ne pouvais facilement mettre en place mes templates avec Asciidoctor ni exploiter les métadonnées des documents.

Et là c’est la magie d’avoir des gens hyper réactifs et motivés sur des projets Open Source comme Asciidoctor. On branche un membre de la team

En quelques jour j’avais tout pour démarrer à implémenter le blog de mes rêves dans mon site https://www.dev-mind.fr

Voici un exemple d’article en Asciidoc

Je suis rédacteur du blog JavaMind depuis maintenant 7 ans. Quand j’ai lancé le blog, j’ai choisi un CMS en ligne (Blogger) qui m’offrait de la souplesse mais qui n’était pas très personnalisable. Depuis un bon moment maintenant je cherchais une solution de remplacement simple et intégrable facilement dans mon site web.

Pour comprendre le cycle de vie de mon site web vous pouvez consulter le fichier de description du build Gulp. Les principales tâches sont

Regardons un peu plus en détail la partie de génération du blog

La tâche blog-indexing permet de construire un index au format Json qui sera interrogeable via un simple fichier JS pour naviguer ou retrouver facilement un article de blog. La tâche blog convertit quand à elle, les articles Asccidoctor en HTML en utilisant les templates Handlebar.

asciidoctorRead, asciidoctorConvert, asciidoctorIndexing, …​ sont des extensions à notre build Gulp ou des scripts permettant de transformer les flux de données lus.

Si le code JS de ces extensions vous intéresse je vous laisse consulter les sources sous Github. Le plus intéressant à exposer est la philosophie derrière

Les principales technologies utilisées sont les suivantes