Avant de lire !
Cette documentation va expliquer étape par étape comment générer un site web avec HzMycelium, mais attention !!!
▓ Ici, le but c'est d'accompagner toustes les artistes depuis le début, donc partant d'un niveau de connaissances techniques de ZÉRO.
Si tu es déjà à l'aise avec le système de dépôt sur git, l'utilisation et le lancement de scripts Python, tu vas pouvoir sauter une grosse partie des explications du début (cool).
▓ Toute cette page est aussi dispo sous la forme d'un tuto sur YouTube, pour celleux qui préfèrent ! Ce sera peut-être plus facile à suivre.
- installation Python (+troubleshoot Path)
- création venv (+ troubleshoot scripts execution)
- création de dossier, déplacer dans le terminal
- téléchargement depuis codeberg
- installation requirements
- organisation des dossiers + fichiers audios/covers
- présentation des templates
- écriture fichiers configs
- écriture commande + lancement du script
- ouvrir, vérifier, modifier le site généré
- hébergement du site
Questions et réponses
▒ J'ai pas d'images à mettre dans mon dossier médias, je peux en trouver où ?
Il y a pas mal de sites qui mettent à disposition des images du domaine public, ça conviendra pas à tout le monde mais ça vaut le coup d'aller chercher là-bas :
Le musée de Chicago met à disposition des images en accès libre. Il suffit juste de taper «public domain» dans leur barre de recherche.
La Librairie du Congrès de Washington a aussi un catalogue assez grand, trié selon plein de catégories, très pratiques.
En France, la Bibliothèque Nationale de France a aussi un catalogue d'images très étendu. La plupart sont libres de droits, mais il faut faire attention à cocher le paramètre correspondant dans la recherche, juste au cas où.
/!\ Je recommande pas vraiment Pinterest pour plusieurs raisons. L'algorithme de recommandation est certes très puissant et recommande plein d'images similaires, donc ça fait envie pour se constituer un dossier très joli en 5 minutes.
C'est déjà assez risqué car la provenance et les auteur·ices des images sont très rarement crédité·es, donc assez problématique au pire et pas franchement sympa au mieux.
Ensuite, je trouve que les images présentes et recommandées ont tendance à se répéter, et à perdre en originalité, aussi à cause de cet algorithme peut-être trop efficace. Je trouve ça beaucoup plus intéressant de regrouper soi-même un ensemble d'images qu'on trouve cools, sans qu'elles soit servies sur un plateau.
▒ Pourquoi mes sons sont disponibles en téléchargement ???
C'est un choix que j'ai fait pour rester dans cette démarche d'écosystème indépendant et de circulation des morceaux. On est sur internet, tout se partage, se réutilise, et est accessible librement d'une manière ou d'une autre (même si une personne ou plutôt une entreprise veut vous empêcher d'accéder à des fichiers, il y aura toujours un moyen de les récupérer).
De toute façon, si vous publiez vos morceaux sur YoutubeMusic (proposé par Distrokid), tout le monde peut les télécharger avec un simple convertisseur Youtube vers mp3, alors autant simplifier les choses dès le début :)
Profitez-en pour faire des remix, des playlists, les graver sur des CDs, des K7 !!!
▒ J'ai envie de modifier quelque chose sur mon site qui n'est pas prévu par les templates :(
Bonne nouvelle, c'est possible ! Il va juste falloir mettre les mains dans la machine en allant fouiller dans les fichiers HTML ou CSS.
Si tu maîtrises déjà le web, c'est super : t'auras juste à travailler sur ton dossier généré (built_site) comme sur n'importe quelle page web.
Si la mention de HTML et CSS t'as fait paniquer, ça va prendre un peu plus de temps, mais t'inquiètes. Ce sont des langages de programmation simples à comprendre, avec des milliers de tutos et forums adressés aux débutant·es qui partent de zéro.
Je parle rapidement des notions de base dans la documentation, c'est déjà un point de départ qui te permettra de modifier pas mal de trucs !
▒ J'ai trouvé un bug / j'ai envie de faire quelque chose qui ne fonctionne pas ou qui n'est pas prévu
Ça devait arriver, et franchement ça m'étonne pas ! Comme je suis pas développeur à la base, il y a plein de cas de figure et de façon d'utiliser l'outil que je n'ai pas prévu.
Si la réponse au problème ne se trouve pas dans la documentation, contacte-moi via un des liens en bas de la page et j'essaierai de répondre, d'aider, et même de corriger le problème si j'y arrive.
Si c'est un bug, merci de me le signaler, il faut que je corrige ça !
Si c'est une fonctionnalité qui n'existe pas, c'est peut-être quelque chose sur lequel je peux travailler pour l'ajouter et en faire profiter tout le monde !
Ressources et outils utilisés :
- AmplitudeJS et leur documentation ultra pratique pour toute la partie audio
- ThreeJS et cet exemple par Julien Bidoret pour la disposition d'images sur la template Spore
Les ressources, exemples et liens vers les forums dont je me suis servi sont aussi crédités en commentaires dans les fichiers HTML, CSS, JS, Python etc (quand j'ai pensé à le faire).
Polices utilisées :
-Wondertype par Clémence Fontaine
- Inter Semibold
- GNF
- La Machine Company
- MBA Slice Mono