Aller au contenu

Documentation

Contribuer

Découvrez comment soutenir le projet et contribuer à améliorer Bonjourr.

Bonjourr est développé et maintenu par deux personnes, sur leur temps libre. Le projet est une vraie passion, et l’objectif est de pouvoir y consacrer de plus en plus de temps à l’avenir.

Les dons permettent de couvrir les coûts du projet, de soutenir le développement, et de se rapprocher d’un modèle où le travail sur l’open source peut devenir plus durable. Chaque contribution, même petite, fait une différence (et permet d’avoir son nom dans Bonjourr le mois suivant !).

Laisser un avis est l’un des moyens les plus simples de soutenir Bonjourr. Les notes positives aident le projet à être découvert et encouragent les boutiques de navigateurs à le recommander.

Il est aussi possible d’en parler autour de soi : si Bonjourr plaît, il y a de bonnes chances qu’il plaise aussi à d’autres.

Grâce aux contributeurs, Bonjourr est aujourd’hui disponible en 43 langues.

Les traductions ne sont pas toujours parfaitement à jour, surtout lors de nouvelles versions. Bonne nouvelle : il est possible de les améliorer.

Les traductions se trouvent dans le dossier /_locales/ sur GitHub. Chaque langue contient trois fichiers :

  • translations.json pour les textes principaux.
  • messages.json pour le titre et le sous-titre de l’extension.
  • overview.md pour la description utilisée sur les stores.

Pour ajouter une nouvelle langue, il suffit de copier le dossier en et de l’adapter à la langue souhaitée. Il faut aussi ajouter le code langue et son nom dans la liste située dans /src/scripts/langs.ts. Une pull request peut ensuite être envoyée sur GitHub. Sinon, il est aussi possible d’envoyer les fichiers modifiés par email via email ou sur le serveur Discord.

Cette étape est optionnelle, mais permet de voir le rendu d’une traduction directement dans Bonjourr.

  1. Aller sur online.bonjourr.fr et sélectionner la langue souhaitée.

  2. Utiliser l’un des raccourcis suivants : F12, Ctrl + Shift + J ou Ctrl + Shift + I.

  3. Copier la traduction dans la commande suivante et la coller dans la console :

    const myTranslationFile = "/* coller ici translations.json */";
    localStorage.translations = JSON.stringify(myTranslationFile)
  4. Les nouvelles traductions devraient apparaître.

🧑‍💻 Nouvelles fonctions et corrections de bugs

Section intitulée « 🧑‍💻 Nouvelles fonctions et corrections de bugs »

Les développeurs souhaitant contribuer au code de Bonjourr peuvent consulter les issues sur GitHub afin de trouver des idées de fonctionnalités ou de corrections.

Il est aussi possible de proposer ou créer des extraits CSS et des profils personnalisés.