-
Notifications
You must be signed in to change notification settings - Fork 3
Prise de notes
Revoir la manière dont est conçu le moteur de blog pour permettre de générer :
- de la documentation
- un site vitrine (site statique avec quelques pages)
- un blog
Peut-être voir pour faire plusieurs templates à cette fin ? Mais si on veut un blog avec des pages statiques, comment procéder ? Ou bien les 3 à la fois ?
À ce moment, peut-être n'est-ce que la page d'accueil qui va donner un template "global" afin de dire si on voit la documentation en premier, un mode blog, ou bien le site vitrine avec la page index.md qui se trouve dans le dossier pages.
Serait-il possible d'utiliser le pattern "Factory" afin de générer ce qu'il faut ?
Le wiki de Github n'est pas bon pour cela car on ne garde pas d'historique.
Exporter la documentation dans une branche à part pour permettre d'avoir la documentation de chaque version :
- un tag = 1 version donnée
- sinon on a toujours la dernière version
Quel format choisir pour la documentation ?
- Makefly lui-même ?
- Asciidoctor ?
Il faudrait pouvoir choisir soit d'avoir UN dépôt qui contient tout, soit un dépôt par axe principal :
- tests
- documentation
- principal (code de base)
- scripts de génération de la documentation, de génération des archives compressées du projet pour une version donnée, etc.
Il serait intéressant d'utiliser :
- lua-resty-template pour faciliter la création des templates
- lua-resty-libcjson ou lua-cjson (de openresty)
- une bibliothèque pour la parallélisation des coroutines
Il faudrait pouvoir paralléliser les tâches dans Makefly afin d'améliorer le temps d'exécution.