Après avoir download et installé le logiciel, on peut lancer dans le dossier voulu `faircamp --preview` pour afficher la preview de notre site.
`faircamp --preview --theming-widget` permet d’avoir un widget de prévisu du changement de theme, très utile pour tweak le thème.
`faircamp` seul permet de générer le build. C’est le résultat de ce build que l’on peut publier en tant que site.
Voir les autres commandes ici :https://simonrepp.com/faircamp/manual/command-line-arguments.html
## Site statique
Comme tout générateur de site statique, le site est généré sur notre ordinateur, et ne bougera plus tant que le site n’est pas ré-généré pour un nouvel épisode ou une modification.
Pour permettre de générer un site sans base de données, les générateurs de sites statiques se reposent généralement sur des métadonnées nourries par l’user, en frontmatter ou dans des fichiers spécifiques.
Ici, c’est le langage `eno` qui est utilisé. [Voir la documentation de ce langage](https://simonrepp.com/eno/).
## Architecture du projet
```tree
│ .gitignore
│ catalog.eno (*)
│ README.md
│
├───artists
│ ├───cast
│ │ ├───adalanerd
│ │ │ artist.eno (*)
│ │ │ profil.png
│ │ │
│ │ └───MicroCheapFx
│ │ artist.eno (*)
│ │ profil.jpg
│ │
│ └───guests
├───img
│ bg.png
│ Logo.png
│
└───releases
├───Midiverse #001 - Sylvhem
│ Cover.png
│ La midinale des fées diverses #1 - 13 janvier 2025-0p-hls.mp3
│ Midiverse #1 - 13_01_2025.md
│ release.eno (*)
│
└───Midiverse #002 - Duo chaos
Cover.png
Midiverse #2 - Duo chaos - 20 janvier 2025.md
Midiverse #2 - Duo chaos - 20 janvier 2025.mp3
release.eno (*)
```
J’ai signalé par un (*) les `.eno`. Ce sont eux qui, combinés avec la hierachie des dossiers, vont permettre de générer le site et ses différentes pages.
En règle général, avec faircamp, le nom des dossiers n’a pas d’importance, il faut juste que les `.eno` soient dans un dossier avec le contenu auxquels ils se rapportent. On pourra faire une hiérarchie de dossiers plus complexe au besoin, pour trier mieux les choses.
-`catalog.eno` est le fichier de config principal, à la racine du site, le plus important. C’est ici que l’on règle les fonctions de base du site, les formats des audios, le thème, etc.
[Se référer à la doc pour la liste des options du catalog](https://simonrepp.com/faircamp/manual/catalog-catalog-eno.html).
-`release.eno` est le fichier de config de l’album/de l’EP/de l’épisode, bref, de la release. Il permet de renseigner les infos de la release. C’est ici que l’on renseigne les métadonnées (le permalien, le titre et la date principalement) et le transcript / les infos de l’épisode, entre autre.
Il peut aussi override les options générales de `catalog.eno`, et se rapporte à son dossier seul. On peut par exemple avoir un thème spécifique différent pour chaque release ou pour une release particulière. Pareil pour des qualités de fichier différents, la possibilité de download ou non, etc.
[Se référer à la doc pour la liste des options des releases](https://simonrepp.com/faircamp/manual/releases-release-eno.html).
-`artist.eno` est le fichier de config qui permet de renseigner les infos
des auteurices / artistes. Le nom des dossier n’est pas important, comme ailleurs.
[Se référer à la doc pour la liste des options des artistes](https://simonrepp.com/faircamp/manual/artists-artist-eno.html).
__Important :__ si l’option `label_mode` n’est pas présente dans `catalog.eno`, le site généré ne prendra pas en compte les pages artist puisqu’il considère qu’il s’agit du site d’un artiste seul.
## Autres logiciels
Autres logiciels utilisés pour la création de ce site:
