Redmine

h1. Configuration de Redmine

{{>TOC}}

h2. Général 

h3. Titre de l'application

Titre apparaissant à la une de l'application.

h3. Texte d'accueil

Texte affiché sur la page d'accueil de l'application. Ce texte peut contenir des balises HTML.

h3. Taille max des fichiers attachés

La taille maximum des fichiers déposés (en kilo-octets). _Par défaut: 5120 (i.e. 5 Mo)_

h3. Options d'objets affichés par page

Permet de configurer le nombre d'objets affichés sur chaque page. Lorsque des éléments (Demandes, commits, etc.) sont affichés sur une page, l'utilisateur pourra sélectionner leur nombre à afficher selon les choix que vous aurez configurés sur cette page. 

Défaut: 25, 50, 100

h3. Nombre de jours affichés sur l'activité des projets jours

Permet de sélectionner le nombre de jours d'activité présent sur la page [[FrRedmineActivity|d'activité]]. 

h3. Nom d'hôte et chemin

Nom d'hôte de l'application. Ce nom est utilisé pour écrire les URLs dans les messages envoyés aux utilisateurs. Exemple: www.redmine.org/redmine

h3. Protocole

Le protocole utilisé pour générer les liens dans les messages de notification. _Par défaut: http_

h3. Formatage du texte

Transforme des textes bruts au format HTML et fonctionne à chaque fois qu'un texte mis en forme est envoyé au navigateur (par exemple, la description d'une demande, wiki ...). Ce processus peut être lent sur de grands textes.

h3. Compression historique wiki

Vous permet d'activer la compression du stockage de l'historique des wiki (réduit la taille de la base de données). _par défaut: aucun_

h3. Limite du contenu des flux RSS

Nombre maximum d'enregistrements contenus dans les flux RSS. _Par défaut: 15_

h3. Taille maximum des fichiers texte affichés en ligne KB

Il fournit un moyen de limiter la taille maximale des fichiers texte qui sont affichés en ligne. _Par défaut: 512 kb_

h3. Nombre maximum de lignes de diff affichées

Il fournit un moyen de limiter le nombre maximum de lignes de diff qui sont affichées par Redmine.

h2. Affichage 

h3. Thème

Cette option vous permet de choisir un thème personnalisé. Redmine est livré avec deux thèmes supplémentaires en plus du thème par défaut.

* alternate, ce thème propose principalement la coloration de la liste des demandes en se basant sur les priorités des demandes.

* classic, il est dérivé du thème Redmine 0.5.1 qui affiche un graphique classique.

!Redmine_alternate.png!

Les thèmes sont placés dans @public/themes/@. Vous pouvez en savoir davantage sur les [[frHowTo_create_a_custom_Redmine_theme|thèmes]].

h3. Langue par défaut

La langue par défaut est choisie lorsque l'application ne peut déterminer la langue du navigateur de l'utilisateur. La langue par défaut est également utilisée pour l'envoi de messages à de multiples utilisateurs. _Par défaut: English_

h3. Format de date :

Vous permet de choisir la façon dont les dates sont affichées:

  * *Basé sur la langue de l'utilisateur*: les dates seront affichées spécifiquement pour chaque utilisateur, selon le format défini pour sa langue

  * *Autres formats*: les dates seront toujours affichées en utilisant le format spécifié

_Par défaut: Basé sur la langue de l'utilisateur_

h3. Jour de début des calendriers

Permet de choisir le premier jour utilisé lors de l'affichage d'un calendrier, deux formats possibles :

 * Le lundi

 * Le dimanche 

Par défaut le lundi est utilisé

h3. Format des heures :

Vous permet de choisir la façon dont les heures sont affichées:

  * *Basé sur la langue de l'utilisateur*: les heures seront affichées spécifiquement pour chaque utilisateur, selon le format défini pour sa langue

  * *Autres formats*: les heures seront toujours affichées en utilisant le format spécifié

_Par défaut: Basé sur la langue de l'utilisateur_

h3. Format d'affichage des utilisateurs

Permet de choisir la façon dont les noms d'utilisateur sont affichés. Les combinaisons suivantes sont proposées :

* Nom

* Nom prénom

* Prénom Nom

* Prénom, Nom

* Identifiant 

h3. Afficher les Gravatar des utilisateurs

Si cette option est activée, les "Gravatars":http://fr.gravatar.com/  utilisateurs (reconnu mondialement avatar) seront affichés en plusieurs endroits de Redmine.

h3. Image Gravatar par défaut

Image à utiliser pour les utilisateurs qui n'ont pas de Gravatar.

h2. Authentification

h3. Authentification obligatoire

Si cette option est cochée, aucune page de l'application n'est accessible aux utilisateurs anonymes. Les utilisateurs doivent s'enregistrer pour accéder à l'application. _Par défaut: Non._

h3. Autologin

Cette option permet aux utilisateurs d'employer la fonctionnalité d'autologin. _Par défaut: Désactivé_

Pour améliorer l'ergonomie (au détriment de la sécurité), l'utilisateur peut se connecter automatiquement sans que ce dernier soit obligé de s'authentifier. Pour ce faire, le système conserve un cookie paramétrable en nombre de jours.

h3. Inscription des nouveaux utilisateurs

Cette option vous permet d'activer/désactiver l'auto-enregistrement de nouveaux utilisateurs:

* *désactivé*: les utilisateurs ne sont pas autorisés à s'enregistrer.

* *activation du compte par email*: les nouveaux utilisateurs reçoivent un message contenant un lien utilisé pour activer leur compte (les utilisateurs doivent fournir une adresse de messagerie valide).

* *activation manuelle du compte* _(par defaut)_: les comptes des nouveaux utilisateurs sont créés mais requièrent l'approbation d'un administrateur. les administrateurs reçoivent un message les informant qu'un compte attend leur approbation.

* *activation automatique du compte*: les nouveaux utilisateurs peuvent se connecter dès qu'ils se sont enregistrés.

h3. Longueur minimum des mots de passe

Permet de définir la longueur minimum des mots de passe

h3. Mot de passe perdu

Si cette option est sélectionnée, la fonctionnalité de mot de passe perdu est disponible. _Par défaut: Oui_

h3. Autoriser l'authentification et l'enregistrement OpenID

Permet d'activer les authentification et enregistrements par le biais du protocole  "OpenID":http://www.openidfrance.fr/|OpenID. 

Notez que le paramètre est immuable tant que la dépendance à l'égard de la fonction (ruby-openid gem) n'est pas satisfaite. Vous pouvez simplement l'installer utilisant gem install ruby-openid.

h3. Activer l'API REST

Authentification via l'API REST, Permet une authentification vie le protocole REST via HTTP en utilisant un compte qui existe dans Redmine. 

h2. Projets

h3. Définir les nouveaux projets comme publics par défaut

Si cette option est coché, un projet est créé automatiquement avec un accès public. Le projet peut encore être positionné comme privé soit en créant un nouveau projet après la création du projet

h3. Modules activés par défaut pour les nouveaux projets

Permet de sélectionner les modules qui seront utilisés par un nouveau à sa création. Les modules suivants sont accessibles :

* Suivi des demandes

* Suivi du temps passé sur chaque page

* Publication d'annonces

* Publication de documents

* Publication de fichiers

* Wiki

* Dépôt de sources

* Forums de discussion  

h3. Générer des identifiants de projet séquentiels

This setting will let Redmine propose sequential project identifiers for you. This can still be manually changed only while creating the project, not afterward.

Ce paramètre permet de déléguer à Redmine la génération d'identifiant séquentiel pour les projets. Cela peut encore être modifié manuellement  lors de la création du projet. Une fois le projet créé, l'identifiant ne pourra pas être modifié.

h3. Rôle donné à un utilisateur non-administrateur qui crée un projet

Définit le rôle attribué par défaut à un utilisateur non-administrateur qui crée un projet (ceci s'applique uniquement lorsque vous avez configuré les autorisations dans Redmine, de telle manière que les utilisateurs non-administrateur possèdent les privilégies pour créer des projets).

h2. Suivi des demandes

h3. Autoriser les relations entre demandes de différents projets

Si coché, des relations entre des demandes de différents projets peuvent être créées. _Par défaut: Non_

h3. Afficher par défaut les demandes des sous-projets sur les projets principaux

Si coché, les demandes des sous-projets seront affichées par défaut dans la liste des demandes, dans le calendrier et le gantt du projet principal (Depuis r1198). _Par défaut: Oui_

h3. Calcul de l'avancement des demandes

Définir comment le pourcentage d'avancement des demandes est géré :

* Utiliser le champ % effectué : L'utilisateur peut positionner manuellement le pourcentage

* Utiliser le statut :  Chaque statut peut être positionné selon un niveau de pourcentage. Une fois activée la fonction, un nouveau [[FrRedmineIssueTrackingSetup#Statuts des demandes |menu est accessible pour configurer le niveau de pourcentage des statuts]], la page des statuts est mise à chaque pourcentage par statut. 

h3. Limite export demandes

Nombre maximum de demandes contenues dans les exports CSV et PDF. _Par défaut: 500_

h3. Colonnes affichées par défaut sur la liste des demandes

Ce paramètrage vous permet de définir les colonnes affichées par défaut dans les listes de demande.

Seuls les champs personnalisés marqués "pour tous les projets" peuvent être choisis ici.

h2. Notifications par mail

h3. Adresse d'émission

L'adresse de messagerie utilisée dans le champ "From" des messages envoyés aux utilisateurs.

h3. Destinataire en copie cachée (cci)

Si coché, les messages de notification seront envoyés en copie cachée. _Par défaut: Oui_

h3. Pied-de-page des emails

Vous pouvez enter ici un texte qui sera ajouté aux messages envoyés par l'application.

h2. Emails entrants

Consulter les instructions à propos des paramètres s [[FrRedmineReceivingEmails|Recevoir des mails]].

h3. Tronquer les emails après l'une de ces lignes

Ces paramètres peuvent être utilisés pour éliminer les signatures des courriels entrants.

h3. Activer le WS pour la réception d'emails

Redmine peut être configuré pour permettre la création de demandes ou de commentaires par courriel. Pour pouvoir utiliser cette fonctionnalité, vous devez activer l'API qui reçoit des emails. Par défaut: Off

h3. Clé de protection de l'API

Dans ce cadre, vous pouvez entrer une clé secrète utilisée pour la création de demandes ou de commentaires par l'intermédiaire de la fonction de messagerie.

h2. Dépôts

h3. Récupération auto. des commits

Si cette option est activée, l'application récupère automatiquement les nouvelles révisions lorsqu'un utilisateur consulte le dépôt.

_Par défaut: Oui_

Vous pouvez désactiver cette option et automatiser l'appel à Repository#fetch_changesets pour récupérer périodiquement en tâche de fond les révisions de tous les dépôts.

Exemple:

<pre>ruby script/runner "Repository.fetch_changesets" -e production</pre>

Vous pouvez également appeler cette tâche depuis votre dépôt dans un post-commit ou post-receive, de sorte que de modifications sont récupérés après chaque commit. Voici un tutoriel pour le faire avec git: http://finalcog.com/remine-git-post-receive 

h3. Activer les WS pour la gestion des dépôts

Cette option ne devrait être activée que si vous avez installé le script pour la création automatique de dépôts SVN. _Par défaut: Non_

h3. SCM activés

Ici, vous pouvez (dé) sélectionner les SCM supportés pour les projets individuels. Ce paramètre est utile si vous prenez en charge plusieurs systèmes de  (par exemple, que Git ou seulement SVN).

h3. Encodage des messages de commit

Cette option vous permet de spécifier les encodages préférés des fichiers du dépôt (valeurs multiples autorisées séparées par des virgules). Ces encodages sont utilisés pour convertir le contenu des fichiers et des diff à UTF-8 pour qu'ils soient correctement affichés dans le navigateur.

Lorsque vous entrez plusieurs encodages, le premier encodage valide pour un contenu de fichier donné est utilisé.

Par exemple, pour les utilisateurs français, cette option peut être paramètré à: 

  UTF-8, ISO 8859-15, CP1252

Pour les utilisateurs japonais:

  ISO-2022-JP, EUC-JP, UTF-8, SHIF_JIS, WINDOWS-31J

h3. Nombre maximum de revisions affichées sur l'historique d'un fichier

Il fournit un moyen de limiter le montant des révisions qui sont extraites d'un SCM pour un chemin spécifique.

h3. Référencement des demandes dans les commits

Lorsqu'ils sont récupérés des dépôts, les messages de commit sont analysés pour en déduire l'identifiant des demandes référencées ou corrigées.

Cette option vous permet de définir les mots-clefs pouvant être utilisés dans un message de commit pour référencer ou résoudre automatiquement une demande, et pour spécifier le statut à appliquer à la demande résolue.

Les mots-clefs par défaut sont:

* Mots-clés de référencement : pour référencer une demande: refs, references, IssueID

* Mots-clés de résolution d'une demande: fixes, closes

Il n'y a pas de statut par défaut défini pour les demandes résolues. Vous devrez en spécifier un pour permettre la fermeture automatique de demandes. Si vous voulez référencer une demande sans utiliser de mots-clefs, entrez une seul étoile: * dans le paramètre *Mots-clefs de résolution*. Dans ce cas, tout identifiant de demande trouvé dans le message sera lié au changeset.

Exemple d'un message de commit qui utilise les mots-clefs par défaut:

  Ce commit refs #1, #2 et fixes #3

Ce message référencera les demandes 1 et 2 et résoudra automatiquement la demande 3.

Après un mot-clef, les identifiants de demandes peuvent être séparés par un espace, une virgule ou &.