Comment je suis passé à GitHub & JBake
* Cette page est ~~en construction~~ inachevée... *
Tout d'abord : Ce n'est pas mon invention ! Beaucoup l'ont fait avant moi, il y a de nombreuses descriptions disponibles. Cela m'a tout de même pris un certain temps ;)
Ce et ce furent les sources les plus inspirantes et les explications les plus simples (qui donnent confiance ;) ).
Configuration
Voici donc la configuration générale que j'ai :
- Un répertoire sur mon Mac qui contient le contenu. J'utilise la structure de base que Jbake utilise.
- Un répertoire cloné par git sur mon Mac avec le résultat du processus jBake
- Un petit script que je lance chaque fois que je modifie quelque chose. Le script effectue la "cuisson" et la publication via git
- Et bien sûr, les réglages DNS pour pointer mon nom de domaine vers les IPs de Github
JBake
Pourquoi j'utilise JBake ? J'aime le principe et je me sens plus à l'aise en Java que dans d'autres langages de programmation. Je n'ai pas touché au code interne de JBake, mais je suis confiant que je pourrais le faire. Le principe de fonctionnement de JBake est similaire au célèbre Jekyll : Il analyse les fichiers de contenu et crée des fichiers HTML (statiques) à partir de ceux-ci. Les fichiers de contenu peuvent contenir du Markdown ou d'autres formats ; j'utilise uniquement Markdown.
Ma structure de répertoire ressemble à ceci :
.
|-- assets
| |-- favicon.gif
| |-- robots.txt
| |-- img
| | |-- logo.png
| |-- js
| | |-- custom.js
| |-- css
| |-- style.css
|
|-- content
| |-- about.html
| |-- 2013
| |-- 01
| | |-- hello-world.html
| |-- 02
| |-- weekly-links-1.ad
| |-- weekly-links-2.md
|
|-- templates
| |-- index.ftl
| |-- page.ftl
| |-- post.ftl
| |-- feed.ftl
|
|-- jbake.properties
Par défaut, JBake produit le répertoire de sortie dans cet arbre. Dans mon cas, je "cuits" mes éléments dans un répertoire qui est synchronisé avec git.
La configuration GitHub
Les réglages DNS
Prochaines étapes
Il y a quelques éléments que je prévois de changer.