Changes between Initial Version and Version 1 of GestionDeDocumentsAvecSVN


Ignore:
Timestamp:
Jul 15, 2009, 4:16:36 PM (16 years ago)
Author:
/C=FR/O=CNRS/OU=UMR8607/CN=Christian Arnault/emailAddress=arnault@…
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GestionDeDocumentsAvecSVN

    v1 v1  
     1= Cette page décrit le gestionnaire de documents pour le projet SuperB_PID =
     2
     3[[TracNav]]
     4[[TOC(inline)]]
     5
     6'''Note-1:''' ''le gestionnaire est basé sur la technologie SVN''
     7
     8Il est nécessaire d'avoir installé sur son PC l'utilitaire [http://tortoisesvn.net/ Tortoise] qui offre une interface utilisateur vers l'outil de gestion de versions de documents [http://subversion.tigris.org/ SVN].
     9
     10== 1. Le mécanisme de base ==
     11
     12L'outil SVN permet:
     13 * de stocker dans une espace disque partagé (un Dépôt) des documents de nature quelconque.
     14 * de structurer ce dépôt librement (en dossiers et sous-dossiers)
     15 * de maintenir les versions successives de ces documents
     16
     17Les documents sont transférés (via Tortoise) du dépôt vers l'espace disque de l'utilisateur et réciproquement, en détectant automatiquement les différences. Lors d'un transfert vers le dépôt, SVN complète l'historique.
     18
     19L'accès aux fonctions de SVN se fait à travers des options ajoutées aux menus standards de Windows dans le gestionnaire de fichiers. Ainsi, on pourra:
     20 * ramener un document, un ensemble de documents, ou même tous les documents du projet SuperB_PID dans son espace disque
     21 * sélectionner une version particulière d'un document
     22 * envoyer une nouvelle version d'un document après l'avoir modifié vers le dépôt
     23
     24== 2. Le dépôt ==
     25
     26Il est référencé en utilisant une adresse web :
     27
     28!https://svn.lal.in2p3.fr/projects/SuperB_PID/
     29
     30La fonction Repo Browser permet de naviguer et de manipuler la structure du dépôt. Ce navigateur est lancé par le menu suivant:
     31
     32[[Image(source:/Documentation/Image01.jpg)]]
     33
     34Ce qui ouvre la fenêtre du navigateur où l'on donnera l'adresse du dépôt:
     35
     36[[Image(source:/Documentation/Image02.jpg)]]
     37
     38Le navigateur permet, par clic-droit sur un des éléments du dépôt, d'effecteur de nombreuses opérations sur ces éléments, comme de rajouter un dossier, de renommer ou supprimer des éléments, de déplacer un élément, etc...
     39
     40[[Image(source:/Documentation/Image03.jpg)]]
     41
     42
     43
     44== 3. Installer un document dans le dépôt ==
     45
     46Supposons que l'on ait créé le document !MaNote.doc. En utilisant le navigateur de dépôt, on pourra ajouter cette note dans le dépôt. Dans cet exemple, on ajoute ce document dans le dossier Documents du dépôt.
     47
     48[[Image(source:/Documentation/Image04.jpg)]]
     49
     50Ce qui donnera, une fois le document sélectionné:
     51
     52[[Image(source:/Documentation/Image05.jpg)]]
     53
     54
     55
     56== 4. Utiliser un document du dépôt pour le modifier ==
     57
     58On va commencer par extraire du dépôt le dossier contenant le document qui nous intéresse:
     59
     60[[Image(source:/Documentation/Image06.jpg)]]
     61
     62On spécifiera l'endroit dans le disque local où le document doit être installé:
     63
     64[[Image(source:/Documentation/Image07.jpg)]]
     65
     66Le document est désormais prêt à être utilisé:
     67
     68[[Image(source:/Documentation/Image08.jpg)]]
     69
     70== 5. Envoyer dans le dépôt une nouvelle version du document après modification ==
     71
     72Nous avons donc travaillé sur notre document !MaNote.doc (par exemple en utilisant Word das le cas de notre exemple). Dans le navigateur de Windows, déjà nous pouvons voir que ce document présente une icône spéciale indiquant qu'il a été modifié localement (par rapport au dépôt):
     73
     74[[Image(source:/Documentation/Image09.jpg)]]
     75
     76Toujours en utilisant le clic-droit sur le document, nous allons utiliser la fonction {{{Commit}}} qui ''valide'' nos modifications et sauvegarde cette version du document.
     77
     78[[Image(source:/Documentation/Image10.jpg)]]
     79
     80Il nous faudra simplement ajouter un commentaire indiquant la nature de la modification.
     81
     82[[Image(source:/Documentation/Image11.jpg)]]
     83
     84Désormais on pourra continuer d'utiliser ou de modifier notre document simplement en répétant cette dernière opération.
     85
     86== 6. Partager un document ==
     87
     88Plusieurs utilisateurs peuvent installer un ou plusieurs documents du dépôt sur leur espace disque personnel. Il leur suffit à chacun d'appliquer l'opération décrite au [wiki:GestionDeDocuments#a4.Utiliserundocumentdud%C3%A9p%C3%B4tpourlemodifier paragraphe 4].
     89
     90Ensuite chacun peut vérifier si ce document a évolué et éventuellement le mettre à jour si c'est le cas, en utilisant la fonction ''Update''
     91
     92[[Image(source:/Documentation/Image12.jpg)]]
     93
     94
     95