Comment contribuer

Vous voulez participer au projet Solarus ? Toute la communauté vous remercie et toute aide, même très petite, est la bienvenue. Venez parler avec nous sur Discord pour nous dire ce que vous voulez apporter au projet.

Développement

Tous le source code des projets Solarus se trouve sur Gitlab. Le moteur est fait en C++. Il est recommandé d'être compétent dans ce langage et de maîtriser la programmation de jeu vidéo avant d'être capable de contribuer. L'éditeur de quête Solarus Quest Editor est fait en C++ avec Qt.

Si vous voulez nous informer d'un bug, ou si vous avez une demande de nouvelle fonctionnalité:

  1. Regardez si quelqu'un n'a pas déjà créé un ticket sur la page Gitlab du projet.
  2. Créez votre ticket, et soyez aussi précis que possible. Joignez des captures d'écran si besoin.

Si vous voulez modifier le code source de n'importe quel projet :

  1. Clonez le dépôt pour lequel vous voulez contribuer.
  2. Créez votre propre branche et faites vos modifications dans cette branche.
  3. Créez une Merge Request.

Tutoriels pour créateurs de quêtes

Vous savez déjà très bien comment créer une quête Solarus ? Alors pourquoi pas aider les autres à apprendre aussi ? Des tutoriels ont besoin d'être écrits pour aider les débutants et les créateurs de quête plus expérimentés. Nous avons un dépôt sur Gitlab pour les tutoriels officiels. Ceux-ci sont écrits en markdown, dont la syntaxe est très simple.

Suivez les mêmes étapes qu'un développeur si vous voulez contribuer aux tutoriels :

  1. Clonez le dépôt pour lequel vous voulez contribuer.
  2. Créez votre propre branche et faites vos modifications dans cette branche.
  3. Créez une Merge Request.

Site Internet

Amélioration du site

Le site Internet de Solarus utilise Kokori, notre backend PHP libre et open-source, utilisant des fichiers Markdown pour le contenu. Nous sommes encore loin d'avoir fini ce site Internet et un peu d'aide est bienvenu.

Vous pouvez contribuer de 2 manières :

  1. Améliorer le moteur de site Kokori
  2. Ajouter du contenu au site

Pour comprendre comment fonctionne Kokori, nous avons un tutoriel ainsi que de la documentation. Veuillez prendre en compte que c'est encore en travaux.

Ajouter mon jeu à la Bibliothèque de quêtes Solarus

Si le développement de votre jeu est fini, ou suffisamment avancé, vous pouvez l'ajouter à la page Jeux de ce site, qui recense les jeux faits avec Solarus.

Pour cela, nous avons rédigé un tutorial (en anglais). Créez une Merge Request quand votre branche est prête à être intégrée, et nous vérifierons l'éligibilité de votre jeu ainsi que la validité des fichiers ajoutés.

Art

Si vous avez la fibre artistique, nous avons besoin d'aide dans le département pixel-art. Toute contribution de tileset, font ou sprite sont les bienvenues ! Vous voulez peut-être également aider pour le design du site Internet ?

Traductions

Éditeur de jeu et Lanceur de jeu

L'éditeur et le lanceur de quête ont besoin d'être traduits dans toutes les langues possibles ! N'hésitez pas à ajouter votre propre langue. Puisqu'ils sont faits avec Qt, vous devriez utiliser le logiciel de Qt fait pour cela, appelé Qt Linguist. Qt propose de la documentation sur la traduction d'une application Qt.

Jeux

Les jeux peuvent également bénéficier de nouvelles traductions. Solarus Quest Editor inclut un système de traduction pour vous simplifier le travail. Veuillez lire la documentation sur la traduction de quête.

Site Internet

Le site Internet peut également être traduit dans votre langue. Il est important de savoir que cela peut prendre du temps, car vous devez vous assurer que la traduction suit les mises à jour régulières du site (pages, articles de blog, tutoriels). Nous maintiendront toujours les traduction françaises et anglaises, car nous parlons ces langues. Cependant, vous nous pouvons maintenir les traductions de langues que nous ne savons pas parler. Veuillez lire la documentation sur la traduction du site.

Dons

Les développeurs de Solarus réalisent ce moteur sur leur temps libre. Si vous appréciez notre travail, vos dons pourront contribuer aux frais d'héberger et nous montrer que Solarus est apprécié.