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.

Architecture du projet

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

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

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

  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.