106 lines
No EOL
5 KiB
Markdown
106 lines
No EOL
5 KiB
Markdown
# midiverse-faircamp
|
||
|
||
Un site faircamp pour publier les podcasts du midiverse.
|
||
|
||
## TO DO
|
||
|
||
- Définir une licence
|
||
- Check les questions de vies privées pour auteurices des podcasts et tout
|
||
- Importer les autres épisodes
|
||
- Corriger les cover non-prévues pour un format carré
|
||
- Vérifier que le flux RSS est correct
|
||
- Créer une favicon
|
||
- Uploader le site quelque part
|
||
- Mettre à jour l’url du site en fonction du choix final de ndd & co.
|
||
|
||
## Liens
|
||
|
||
Faircamp : https://simonrepp.com/faircamp/
|
||
Manual : https://simonrepp.com/faircamp/manual/
|
||
Repository : https://codeberg.org/simonrepp/faircamp
|
||
|
||
### Download
|
||
https://simonrepp.com/faircamp/manual/installation.html
|
||
|
||
## Getting started
|
||
|
||
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 :
|
||
- ffmpeg pour convertir du mp4 vers mp3
|
||
- Sur windows, `choco install ffmpeg-full`
|
||
- Sur linux, `apt install ffmpeg`
|
||
|
||
La commande :
|
||
`ffmpeg -i <input-file.mp4> -vn -acodec libmp3lame -ac 2 -ab 160k -ar 48000 <output-file.mp3>`
|
||
|
||
- Inkscape, pour éditer les svg / adapter les différents visuels pour le site. |