Documentation de la forge Redmine du GIPSA-lab¶

• Contenu
• Documentation de la forge Redmine du GIPSA-lab
  • Redmine pour les utilisateurs
    • Mise en forme du texte
    • Utilisation des dépôts de code source SVN
    • Goodies
  • Redmine pour les responsables de projets
    • Création d'un nouveau projet Redmine
    • Création et administration d'un dépôt de code source SVN
    • Création d'un compte d'utilisateur externe
    • Utilisation parcimonieuse des modules Redmine

$\frac{1}{2}$

La plate-forme Redmine du GIPSA-lab est une forge ; elle offre différents outils (wikis, forums, gestionnaires de tickets, gestionnaires de révisions) pour faciliter le travail collaboratif autour de projets de recherche comportant généralement du code source (ex. : rédaction d'articles scientifiques, projets de recherche, projets de développement...). Le système est accessible aux utilisateurs membres du GIPSA-lab ainsi qu'aux utilisateurs externes (sur demande).

Cette documentation technique comporte deux principales parties. La première est à destination de l'ensemble des utilisateurs ; la seconde concerne plus particulièrement les responsables de projets.

Redmine pour les utilisateurs¶

Mise en forme du texte¶

Redmine utilise le langage Textile pour mettre en forme le texte dans la plupart des zones de saisie. Ce langage faiblement typé est relativement intuitif, mais certaines de ses fonctionnalités avancées sont décrites ci-dessous.

• La documentation officielle du langage Textile utilisé dans Redmine est disponible ici : http://www.redmine.org/projects/redmine/wiki/RedmineTextFormatting.
• Le plugin Wiking permet d'étendre les possibilités du langage, tel que décrit ici : http://projects.andriylesyuk.com/projects/wiking/wiki/Syntax.
• Le plugin MathJax permet d'écrire des expressions mathématiques avec la syntaxe LaTeX : par exemple $\sum_i x_i$ donne $\sum_i x_i$.

Utilisation des dépôts de code source SVN¶

Lorsqu'un projet dispose d'un dépôt de code source SVN, son adresse est sous la forme :

https://svn.gipsa-lab.grenoble-inp.fr/reposit/nom-projet

où nom-projet doit être remplacé par le nom court du projet Redmine.

Pour apprendre à utiliser SVN, il est recommandé de lire cette page. Les principales commandes sont synthétisées dans une refcard.

Goodies¶

Les avatars

Il est possible d'utiliser un avatar sous Redmine, mais à première vue ce n'est pas dans la rubrique Mon compte que cela se passe. En fait, la plate-forme n'héberge pas les avatars des utilisateurs, ces derniers sont téléchargés à la volée à partir de Gravatar. Voici comment procéder...

1. Se créer un avatar, par exemple en utilisant http://www.faceyourmanga.com conjointement avec une habile capture d'écran.
2. Se créer un compte sur https://en.gravatar.com en mentionnant l'adresse e-mail utilisée sous Redmine, puis charger l'avatar créé précédemment.

Redmine pour les responsables de projets¶

Création d'un nouveau projet Redmine¶

La création d'un nouveau projet s'effectue sur demande au service informatique du GIPSA-lab, à l'adresse sos-info@gipsa-lab.grenoble-inp.fr. Il est nécessaire de fournir les éléments suivants :

• nom du projet (préférer les noms courts) ;
• nom du responsable du projet (doit être membre du GIPSA-lab).

Une fois le projet créé, son responsable a la possibilité d'ajouter des sous-projets.

Création et administration d'un dépôt de code source SVN¶

Un dépôt de code source SVN peut être associé à chaque projet Redmine, il permet la gestion collaborative du code source. Sa création est optionnelle et est réalisée manuellement par le service informatique (via sos-info@gipsa-lab.grenoble-inp.fr). Le dépôt de code source SVN peut être initialisé dans deux cas de figure :

• en même temps qu'un projet Redmine ;
• n'importe quand, pour un projet Redmine existant.

La gestion des permissions relatives au dépôt sont ensuite gérée par le responsable du projet, via l'interface intranet...

{TODO} Cette partie est à compléter par Christian ou Anne.

Création d'un compte d'utilisateur externe¶

La création d'un compte d'utilisateur externe s'effectue sur demande adressée au service informatique du GIPSA-lab, à l'adresse sos-info@gipsa-lab.grenoble-inp.fr. Les renseignements suivants doivent être fournis :

• nom ;
• prénom ;
• fonction ;
• affiliation ;
• adresse e-mail.

Utilisation parcimonieuse des modules Redmine¶

Pour chaque projet, la plate-forme collaborative Redmine offre une grande variété de modules (wikis, forums, visualiseur de dépôts de code source, gestionnaire de tickets, annonces...). Un trop grand nombre de fonctionnalités peut être rapidement déroutant pour les utilisateurs. Par conséquent, il du ressort des gestionnaires de projets de limiter ces dernières (onglet Configuration) en fonction des méthodes de développement envisagées (ex. : inutile d'afficher l'explorateur de code source si aucun dépôt n'a été initialisé, limiter le nombre de trackers des tickets...).