Ajout d'une documentation

This commit is contained in:
Simon 2022-07-20 17:24:20 +02:00
parent 2063ea4d1f
commit 3d4bffaad7
1 changed files with 31 additions and 0 deletions

31
README.md Normal file
View File

@ -0,0 +1,31 @@
# Le site WEB de Jarnat
Vous retrouverez dans ce dépôt l'ensemble des sources et la documentation autour du site WEB Jarnat.
## Mise à jour du contenu
Il est possible de changer le contenu du site internet directement depuis Gitea où est hébergé le code.
Vous pouvez retrouver les parties suivantes :
- La configuration du site [généric](./config/config.yml) et spécifique à une langue : [français](./config/languages.fr.yml) [anglais](./config/languages.fr.yml)
- Les traduction sont dans le dossier [i18n](./i18n/), on peut retrouver [le français](./i18n/fr.yaml) ainsi que [l'anglais](./i18n/en.yaml)
- Les articles de blog sont dans le dossier [content](./content/) et sont spécifique aux langues
- Les images statiques sont dans le dossier [static/images](./static/images/) aucun traitement n'est effectué par Hugo, il faut donc qu'elles soient optimisées
- Les données des différentes parties de la page d'accueil sont dans le dossier [data](./data/) avec une partie en [français](./data/fr/) et en [anglais](./data/en/)
- L'ordre des parties sur la page d'accueil sont dans le fichier [index.html](./themes/meghna-hugo/layouts/index.html)
## Technologie
Il a été choisi d'utiliser le générateur de site statique [Hugo](https://gohugo.io/) qui fait parti [des plus utilisé](https://jamstack.org/generators/) et des plus rapide.
Le site utilise :
- le système de template de Hugo (template Go)
- du HTML
- du Javascript pour intéragir avec l'utilisateur
- du CSS pour le design
- du [Markdown](https://fr.wikipedia.org/wiki/Markdown) pour le contenu
# Thème
Pour créer le site nous sommes partis du thème [Meghna](https://gethugothemes.com/products/meghna) de la société [Themefisher](https://themefisher.com/) que nous avons adapté pour correspondre au plus prêt des besoin de Jarnat. Le template a été acheté par la société Weko - CAP Services.