-= LiflForge =-

Utilisation d'un projet LiflForge

Si votre projet se nomme MonProjet :

  • l'accès au contenu Trac se fait par l'URL http://forge.lifl.fr/MonProjet ou, pour un projet sécurisé, par https://forge.lifl.fr/MonProjet
  • l'accès au dépôt SVN MonDepot (main pour une installation par défaut) se fait par l'URL http://forge.lifl.fr/MonProjet/svn/MonDepot ou, pour un projet sécurisé, par https://forge.lifl.fr/MonProjet/svn/MonDepot.
    La commande de checkout, par exemple, est donc svn checkout http://forge.lifl.fr/MonProjet/svn/MonDepot
  • l'accès au dépôt Git MonDepot.git se fait par l'URL http://forge.lifl.fr/MonProjet/git/MonDepot.git ou, pour un projet sécurisé, par https://forge.lifl.fr/MonProjet/git/MonDepot.git
    La commande pour cloner le dépôt, par exemple, est donc git clone http://forge.lifl.fr/MonProjet/git/MonDepot.git

Le Guide Utilisateur de Trac est accessible par le lien Help/Guide disponible en haut des pages Trac.

Le guide d'utilisation SVN est disponible en ligne. Un certain nombres de clients graphiques SVN sont référencés sur Wikipedia http://en.wikipedia.org/wiki/Comparison_of_Subversion_clients

Il n'y a pas de documentation officielle de Git, mais le livre Pro Git, disponible en ligne, est une référence indispensable en la matière.

Quelques conseils d'utilisation

Première utilisation d'un dépôt

Voir la F.A.Q. à ce sujet : Premier import vers un dépot SVN et Premier import vers un dépôt GIT

Arborescence SVN pour un projet de développement

Il est habituel avec SVN de déposer les fichiers sources au sein d'un répertoire nommé trunk. Cela permet de créer ensuite d'autres arborescences, classiquement : branches et tags. (voir la documentation SVN).

Le premier import se fera donc avec la commande suivante : svn import http://forge.lifl.fr/MonProject/svn/main/trunk /path/to/directory/to/import

Il est très délicat de créer cette hiérarchie après coup. Nous vous conseillons donc de le faire tout de suite.

Utilisation pour la rédaction collaborative de documents

Un dépôt SVN ou Git se prête très bien au stockage de documents textes (ASCII, Latin 1, UTF-8…) et assurera la gestion de la collaboration et du versioning.

Pour ce type de dépôt, l'utilisation de l'arborescence SVN conventionnelle (trunk, branches, tags) n'est pas forcément très appropriée.

Un dépôt SVN ne sera par contre pas réellement utile pour des documents binaires (Word, OpenOffice…). En effet, SVN ne sachant comment calculer la différence entre 2 documents binaires, il ne vous permettra pas de retrouver les modifications effectuées entre 2 versions. De plus, il stockera l'intégralité de toutes les versions, ce qui peut représenter un gâchis d'espace de stockage. Il vaut mieux dans ce cas utiliser une page wiki à laquelle ces documents binaires seront attachés.
Cette remarque est valable également pour l'utilisation d'un dépôt Git.

Regroupement de sous-projets dans un dépôt SVN

Si il est possible d'associer plusieurs dépôts à un projet Trac, il peut dans certains cas être préférable de regrouper plusieurs sous-projets au sein d'un unique dépôt (par exemple dans le cas d'un projet décomposé en librairies). On utilisera alors une arborescence SVN pour séparer chaque sous-projet. La gestion fine des droits d'accès au dépôt SVN permettra, si besoin est, de restreindre les accès à ces sous-projets.

Dans le cas d'utilisation de l'arborescence SVN conventionnelle, 2 configurations types sont envisageables :

  • Branches communes :
    + trunk + module1 + toto.c
    |       |         + titi.c
    |       |
    |       + module2 + foo.c
    |                 + bar.c
    |
    + tags - module1 - version1.0 + toto.c
                                  + titi.c
    
  • Branches séparées
    + module1 + trunk + toto.c
    |         |       + titi.c
    |         |
    |         + tags - version1.0 + toto.c
    |                             + titi.c
    |
    + module2 - trunk + foo.c
                      + bar.c
    

La différence entre les 2 configurations est plutôt affaire de choix d'organisation, le compteur de numéro de révision étant dans tous les cas global au dépot SVN.

On procédera, par exemple, de la manière suivante pour créer la deuxième configuration :

svn mkdir http://forge.lifl.fr/MonProjet/svn/main/module1
svn import /path/to/local/module1 http://forge.lifl.fr/MonProjet/svn/main/module1/trunk

svn mkdir http://forge.lifl.fr/MonProjet/svn/main/module2
svn import /path/to/local/module2 http://forge.lifl.fr/MonProjet/svn/main/module2/trunk
Last modified 4 years ago Last modified on 01/29/13 11:13:03