distorsion.interhacker.space/README.md

[![status-badge](https://woodpecker.deuxfleurs.fr/api/badges/41/status.svg)](https://woodpecker.deuxfleurs.fr/repos/41)

# Le site web de la distorsion !

## Site actuel

Le site est super basique : c'est juste des fichiers statiques html, css et js
servis depuis un bucket S3, hébergé chez les camarades de
[deuxfleurs](https://deuxfleurs.fr).

### Test

Pour tester le site en local, il faut un serveur web local. L'une des options
les plus simples qui ne demande pas de configuration est d'utiliser celui qui
vient avec Python. Depuis la racine du site, lancer 

```
python -m http.server
```

Puis pointer un navigateur vers http://localhost:8000.

Comme on utilise des chemins absolus pour les références entre les fichiers du
site, simplement ouvrir les fichiers html avec le navigateur va casser des
références (aux fichiers css par exemple, ou des liens). On a besoin de passer
par un serveur web pour que le site ait une racine bien définie.

### Déploiement

Si l'informatique marchait bien, le site serait automatiquement mis à jour à
chaque fois qu'on pousse des modification dans le dépot par l'outil
d'intégration woodpecker. En pratique, ça marche rarement. Donc il faut copier
les sources à jour à la main dans le bucket S3.

Pour mettre à jour le site à la main :

```
export AWS_ACCESS_KEY_ID=<key ID>
export AWS_SECRET_ACCESS_KEY=<secret key>
export AWS_DEFAULT_REGION='garage'
export AWS_ENDPOINT='https://garage.deuxfleurs.fr'
s5cmd --endpoint-url $AWS_ENDPOINT sync --delete site/ s3://distorsion.interhacker.space/
```

La clef et son ID ne sont pas stockées ici. Si besoin, ces secrets peuvent être
partagés.

## Ancien site

Avant, on avait un site static généré avec [Hugo](https://gohugo.io). Les
sources sont archivées dans [old-hugo-site](./old-hugo-site).