Improve readme #9

Merged
tschwery merged 1 commit from improve-readme into master 2019-10-13 13:21:20 +00:00

View file

@ -3,14 +3,14 @@
Ce repository contient le code source des différents livres de recettes
et du blog des recettes.
Le site est généré automatiquement lorsque les Merge Requests sont acceptées
Le site est généré et publié automatiquement lorsque les Merge Requests sont acceptées
et les modifications intégrées sur la branche `master`.
## URLs utiles
## Usage
Le blog peut être généré en local avec `nodejs`. Il suffit d'installer
les dépendances avec `npm install`, puis, une fois celles-ci installées,
les dépendances avec `npm ci`, puis, une fois celles-ci installées,
lancer la génération avec `npm run build`.
## Ajouter des recettes
@ -26,3 +26,16 @@ lancer la génération avec `npm run build`.
8. `git push` pour envoyer sur le serveur
9. Suivre le lien donné pour créer une Merge Request avec les nouvelles
recettes.
### Visualiser les changements
* En local, il est possible de compiler le site avec `npm run build` puis
visualiser le site généré avec `http-server build`.
* A distance, GitLab compile et déploie sur le site sur une addresse de prévisualisation
disponible dans la MR.
## Technologies
* Le site est généré statiquement avec [metalsmith](https://metalsmith.io/)
* Les fichiers générés sont déployés automatiquement dans un bucket Amazon S3
* Le site web est distribué par Amazon CloudFront
* Un fichier epub avec les recettes est généré à partir des pages générées
statiquement.