FANDOM


Traduit de Guidance for Bards

Bard
Les bardes contribuent à Habitica en créant des interactions sonores personnalisées pour des événements tels que remplir une tâche à faire ou trouver un butin.

La page Audio décrit les thèmes audio qui sont déjà disponibles sur Habitica. Les bardes souhaitant créer un nouveau thème audio peuvent lire cette page pour apprendre quels effets sonores doivent être créés. Les informations ci-dessous vous aideront à créer votre thème.

Si vous avez des questions à propos du processus ou pour savoir si le thème que vous avez en tête serait approprié, posez-les sur la guilde Aspiring Legends: Habitica Helpers.

Formats de fichiersModifier

Les fichiers de sons que vous créez doivent être fournis à la fois en format ogg et mp3 pour être acceptés dans tous les navigateurs (par exemple, pour un effet sonore de récompense, vous devriez créer à la fois Reward.mp3 et Reward.ogg).

Il existe différents outils pour convertir des fichiers entres les différents formats. Par exemple, si vous créez initialement les fichiers au format *.wav, vous pouvez utiliser les outils en ligne de commande oggenc et lame :

  # convertir du wav en ogg :
  oggenc -q 3 filename.wav
  # convertir du wav en mp3 :
  lame -V 5 filename.wav

Noms des fichiersModifier

Il est important d'utiliser les noms de fichiers corrects pour vos fichiers de sons.

  • Si vous créez un nouveau thème, regardez les noms de fichiers utilisés pour les thèmes existants et utilisez exactement les mêmes noms pour vos propres fichiers.
  • Si vous créez de nouveaux effets sonores qui n'existent pas encore dans le thème, essayez de choisir des noms de fichiers ayant un style similaire à l'existant. Veuillez néanmoins noter que de nouveaux effets sonores peuvent ne pas être implémentés - demandez d'abord sur la guilde Aspiring Legends: Habitica Helpers.

Ajouter vos fichiers au dépôt d'HabiticaModifier

Après avoir créé vos fichiers, il faudra qu'ils soient chargés sur le dépôt habitica sur GitHub, et plusieurs modifications doivent être faites sur les fichiers du site Habitica. Cette section décrit les étapes à suivre.

Si vous n'êtes pas à l'aise pour faire cela vous-même, les membres de la forge vous aideront ! Chargez vos fichiers dans une archive zip, n'importe où sur internet, et rendez vous sur la guilde Aspiring Blacksmiths (Habitica Coders). Expliquez-y que vous avez réalisé un nouveau thème audio, indiquez leur le nom du thème (par exemple, "Frankie's Theme", "Brave Warrior Theme"), et donnez leur le lien du fichier zip. Vous pouvez également leur dire de lire cette page pour trouver comment intégrer le thème, il se peut que cette page ne soit pas connue. Si vous n'avez pas de réponse au bout de quelques jours, demandez à nouveau. Cela peut prendre plusieurs jours pour qu'un membre trouve le temps de l'intégrer, mais quelqu'un vous y aidera !

Les consignes ci-dessous devraient être suivies par les personnes qui intégreront le thème audio sur GitHub.

  • Clonez le dépôt git et installez Habitica localement. Ces instructions peuvent être trouvées sur le guide de la forge.
  • Créez une nouvelle branche pour vos modifications (dans ces exemples, remplacez "add_business_theme" par n'importe quel nom approprié pour le thème audio) :
   # dans votre clone du dépôt HabitRPG/habitica :
   git fetch upstream # récupère les dernières nouveautés du dépôt
   git checkout -b add_business_theme upstream/develop  # créé une nouvelle branche dédiée
  • Pour ajouter de nouveaux effets sonores à un thème existant, copiez les fichiers de sons dans le sous-répertoire approprié dans votre nouvelle branche sous website/assets/audio/.
  • Pour ajouter un nouveau thème :
    • Créez un nouveau sous-répertoire dans website/assets/audio/ (par exemple business), et copiez les fichiers de son dedans. N'utilisez pas d'espace ou de ponctuation dans le nom du sous-répertoire.
    • Modifiez website/assets/locales/en/generic.json et ajoutez un texte similaire à ce qui a déjà été fait pour les thèmes existants (faites une recherche sur audioTheme_ dans le fichier). La clé à créer doit être audioTheme_xyz, où "xyz" correspond au nom précis du sous-répertoire que vous avez créé dans website/assets/audio.
    • Ouvrez le fichier website/server/models/user/schema.js dans un éditeur et cherchez-y le nom d'un thème existant (par exemple "danielTheBard"). Vous trouverez une ligne qui contient la liste des thèmes. Ajoutez le nouveau thème à cette ligne, en utilisant exactement la même syntaxe que celle utilisée pour les thèmes existants. Le texte ajouté doit correspondre précisément au nom du sous-répertoire que vous avez créé.
    • Ouvrez le fichier website/views/shared/header/menu.jade dans un éditeur et cherchez-y le nom d'un thème existant (par exemple "danielTheBard"). Vous trouverez une ligne qui contient la liste des thèmes. Ajoutez le nouveau thème à cette ligne, en utilisant exactement la même syntaxe que celle utilisée pour les thèmes existants. Le texte ajouté doit correspondre précisément au nom du sous-répertoire que vous avez créé.
  • Dans votre installation locale, recompilez et redémarrez le serveur en lançant npm start. Testez la nouvelle entrée de menu pour le thème, et chacun des sons.
  • Utilisez les commandes git add et git commit pour valider les nouveaux fichiers et les fichiers modifiés, puis envoyez-les sur votre fork d'Habitica sur GitHub.
  • Créez une pull request. Si vous n'avez pas créé le thème vous-même, indiquez la personne qui l'a créé dans votre pull request. Si possible, indiquez son nom de profil et son UID Habitica.

Paliers de contribution Modifier

Vous avez de la chance ! Si vous créez un thème audio ou que vous aidez à l'intégrer à Habitica, vous n'avez rien de spécial à faire pour recevoir un palier de contribution. Le palier sera accordé par l'équipe de développement lorsque la soumission sera vérifiée et acceptée.

Projets collaboratifs Modifier

Pirate Foley Modifier

Référez-vous à la guilde Pirate Foley.

Voir également Modifier