-= LiflForge =-

Version 19 (modified by degrande, 7 years ago) (diff)

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 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
  • 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

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.

Conseils d'utilisation du dépôt SVN

Utilisation 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/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 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.

Il ne sera par contre pas réellement utile pour des documents binaires (Word, OpenOffice?…). En effet, SVN ne pouvant 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.

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.

Gestion multi-projets

Si il est possible d'associer plusieurs dépôts SVN à 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 dans ce cas 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 cette configuration :

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

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