Source Code

Le code source de Roboconf est hébergé sur GitHub.
Voir https://github.com/roboconf.

Compiler Roboconf

La plupart des projets Roboconf sont des projets Java. Ils utilisent tous Maven comme outil de construction. L’administration web de Roboconf est un projet Javascript. Et le site web est quant à lui construit avec Jekyll. Ce sont les seules exceptions notoires. Elles sont évoquées plus en détail en bas de cette page.

Il vous faut avoir installé Maven (version 3) pour compiler Roboconf.
Pour les projets Java comme la plate-forme, le plug-in Maven ou les outils Eclipse, il vous suffit de cloner le dépôt de sources et d’exécuter…

mvn clean install

Si vous travaillez sur un tag ou une branche, il se peut que la compilation échoue à cause des vérifications faites par Checkstyle. Vous pouvez désactiver ces vérifications en utilisant…

mvn clean install -Dcheckstyle.skip=true

Même chopse si vous souhaitez travailler en mode déconnecté.

mvn clean install -o -Dcheckstyle.skip=true

Par défaut, les tests d’intégration ne sont pas exécutés lors de l’assemblage standard.
Pour les faire tourner (seuls), vous devez utiliser…

mvn clean install -Dit-only

Pour compiler la plate-forme et exécuter les tests d’intégration, vous devez utiliser…

mvn clean install -P it-all

Pour faire tourner un test spécifique (unitaire ou d’intégration)…

# Naviguer jusqu'au module
cd ...

# Ajouter la propriété ou le profil Maven adéquat
mvn test -Dtest=*nom-partiel*

Quand les projets utilisent un outil d’assemblage différent, des instructions sont données dans le readme du projet.

Contribuer au Projet

Le projet est open-source.
Toutes les contributions sont les bienvenues. Nous utilisons le mécanisme des pull requests sur GitHub.

Ces liens (en anglais) devraient vous aider si vous n’en êtes pas familier.
Sinon, il y a probablement des blogs francophones qui auront fourni d’autres explications.

• Understanding pull requests
• Forking a repository
• Creating a pull request

Assembler / Contribuer à l’Administration Web

Les informations relatives au développement de l’administration web (Angular JS) sont regroupées dans le fichier « readme » du projet.

Assembler / Contribuer au Site Web

Le site est généré avec Jekyll. Il est hébergé avec GitHub, et est réalisé avec Twitter Bootstrap et Glyph Icons.

Les sources du site web sont elles-aussi hébergées sur GitHub.
Pour proposer des corrections ou des évolutions, il vous suffit de forker ce dépôt, d’y appliquer vos modifications et de soumettre une pull request.

Le guide développeur explique les grandes lignes de la configuration Jekyll, ainsi que la façon dont le site fonctionne.