Mathieu Limonier
86ac77d06b
- [x] Vérifier qu'aucun JavaScript n'est chargé inutilement - [x] Vérifier les liens cassés : ajout dans le readme et correction d'un lien cassé! - [x] Vérifier les flux RSS Partie Configuration - [x] Configuration `hugo.toml` - [x] Générer `robots.txt`: automatique via configuration - [x] Générer `sitemap.xml` : automatique via configuration - [x] Ajouter une page `404.html` : ajout de l page en français ainsi que la spécificité de yunohost.
76 lines
1.9 KiB
Markdown
76 lines
1.9 KiB
Markdown
# Site Sillycone-village
|
|
|
|
- [Hugo](https://gohugo.io/) en version 160 + [thème nojs](https://nojs.andy.sb/)
|
|
- Toute la création via images Docker
|
|
- Pas de js
|
|
- Image en AVIF et fallback en JPEG
|
|
- Site vitrine
|
|
- Annonce de moins d'un mois sur page principale
|
|
- Menus:
|
|
1. Accueil
|
|
2. Services
|
|
3. Réalisations
|
|
4. À propos
|
|
5. Contact
|
|
- [Todo liste ici](TODO.md)
|
|
|
|
## Environment .env.example
|
|
|
|
Modifier `.env.exemple` en `.env`
|
|
|
|
## Scripts
|
|
### create.sh
|
|
`./script/create.sh` : Permet de créer correctement le site from scratch dans _site_ de _.env_
|
|
|
|
### init.sh
|
|
`./script/init.sh` : Initialise Hugo avec les bons modules Go.
|
|
|
|
### dev.sh
|
|
`./script/dev.sh` : Lance le site avec la commande `hugo server`
|
|
|
|
### hugo.sh
|
|
`./script/hugo.sh` : Si jamais je dois lancer une commande spécifique de hugo.
|
|
|
|
### publish.sh
|
|
`./script/publish.sh` : Publie le site dans le _PUBLISH_DIR_ de _.env_
|
|
|
|
## Spécificités
|
|
### Page 404 et Yunohost
|
|
La page 404.html, si l'option _Activer l'utilisation du fichier d'erreur personnalisé_ est activée, doit être déplacée sur www/error/404.html
|
|
|
|
## Tests
|
|
Travailler sur le site version production. `./script/publish.sh`.
|
|
### Pas de javascript
|
|
Tout doit être sans résultat.
|
|
|
|
```
|
|
grep -R "<script" publish/
|
|
grep -R "javascript:" publish/
|
|
grep -R "cdn" publish/
|
|
grep -R "google" publish/
|
|
grep -R "analytics" publish/
|
|
```
|
|
|
|
### Vérifier les liens morts
|
|
Dans un terminal, lancer `python3 -m http.server 1313 --directory publish`, puis dans un autre
|
|
```
|
|
docker run --rm \
|
|
--network host \
|
|
lycheeverse/lychee \
|
|
http://localhost:1313
|
|
```
|
|
### Vérifier flux RSS
|
|
|
|
- Vérifier sur [le site officiel de validation de flux rss](https://validator.w3.org/feed/check.cgi?url=https%3A//monsite.be/index.xml) une fois mis sur le site monsite.be
|
|
- `grep -R "rss" publish/` ne doit pas être vide.
|
|
|
|
|
|
|
|
## Idées d'évolutions
|
|
|
|
- Témoignages
|
|
- Questions fréquentes (FAQ)
|
|
- Actualités / Blog?
|
|
- Documentation
|
|
- Ressources
|