# 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_

### publish-akbar.sh
`./script/publish-akbar.sh` : build (`publish.sh`) puis déploiement de `PUBLISH_DIR` vers akbar via `rclone`/SFTP (`SSH_USER`, `SSH_HOST`, `SSH_PORT`, `SSH_REMOTE_PATH` dans `.env`). Le compte de déploiement est restreint au SFTP côté serveur (YunoHost), d'où `rclone` plutôt que `rsync`/`scp` qui nécessitent un shell distant.

Ne pas oublier de vérifier que les 
- dossiers sont en 755 (`find /var/www -type d -exec chmod 755 {} \;`)
- fichiers sont en 644 (`find /var/www -type f -exec chmod 644 {} \;`)

## 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.

### Lighthouse

En mode incognito sur Chromium, <kbd>F12</kbd> puis Lighthouse. Tester smartphone et Pc.

### Éco-score

- https://www.websitecarbon.com/ : 
- https://www.ecoindex.fr/

### Test d'accessibilité
- Tester la navigation au clavier via <kbd>TAB</kbd> et <kbd>SHIFT</kbd> + <kbd>TAB</kbd>
- Vérifier les contrastes: sur Firefox, <kbd>F12</kbd> puis contraste.


Document does not have a meta description


## Idées d'évolutions

- Témoignages
- Questions fréquentes (FAQ)
- Actualités / Blog?
- Documentation
- Ressources