Cette page présente brièvement les systèmes de gestion de version et explique comment installer l'un d'entre eux (svn) pour travailler à plusieurs.

Introduction

La plupart des systèmes de gestion de versions fonctionnent en mode client-serveur :

• un serveur informatique centralise les fichiers de référence et les met à disposition grâce à un programme qui tourne en tâche de fond
• les postes clients disposent de copies locales des fichiers et viennent se synchroniser sur le serveur de référence

L'extension freeplane-collaborative-tools s'appuie sur cet écosystème pour permettre le travail collaboratif.

Dans la suite nous verrons donc comment :

• installer un client SVN
• installer un serveur SVN si votre organisation n'en dispose pas déjà
• créer sont premier référentiel partagé

Installer un client SVN

Cette opération est à réaliser chez chaque utilisateur qui souhaitera utiliser "freeplane-collaborative-tools".

Vous pouvez télécharger le client svn : TortoiseSVN.

Durant l'installation, il faut bien sélectionner : command line tools.

C'est aussi simple que ça.

Installer un serveur SVN

Cette opération n'est à réaliser qu'une fois pour toute sur un serveur centralisé (windows, linux ou autre).

Si vous n'avez pas de serveur centralisé, l'installation peut très bien être réalisée sur un poste de travail windows. Il faut cependant que celui-ci soit allumé quand les contributeurs souhaitent partager leurs cartes.

Vous pouvez télécharger le serveur svn ici : Win32SVN. (Il n'y a aucune action spécifique durant l'installation.)

La configuration du serveur se déroule en deux temps :

1. créer un répertoire qui contiendra les fichiers de référence
2. démarrer le serveur svn

Création du référentiel

1. Créer un référentiel C:\svn-ref grâce à la commande svnadmin create "c:\svn-ref" dans une fenêtre de commande (programme "cmd.exe" auquel on peut accéder avec le raccourcis "touche windows + r")
   
2. Dans le répertoire créé, ouvrir le fichier c:\svn-ref\conf\svnserve.conf et décommenter les lignes suivantes (en retirant les "# ") :

   anon-access = read
   auth-access = write
   password-db = passwd
   

   De cette manière, vous autorisez les utilisateurs listés dans le fichier c:\svn-ref\conf\passwd à se connecter au référentiel.
3. Ajouter des utilisateurs autorisés dans le fichier c:\svn-ref\conf\passwd. Le fichier contient des exemples. Commen dans le cas précédent il faut retirer "# " pour que ce soit pris en compte :

   [users]
   bob = motDePasseDeBob
   

Démarrage du serveur

Il faut maintenant s'assurer que le serveur SVN démarrera automatiquement avec windows. Encore une fois ça se passe en ligne de commande. Attention, il faut bien respecter la syntaxe en laissant un espace après le signe "=".

La commande est la suivante :

sc create svn
	binpath= "\"C:Program Files (x86)\Subversion\bin\svnserve.exe\" --service -r C:\svn-ref\"
	displayname= "SVN Server"
	depend= Tcpip
	start= auto

Il faut l'exécuter en ligne de commande en tant qu'administrateur. Pour cela, lancer cmd.exe en tant qu'administrateur :

Ce qui ressemble à ça :

Pour le démarrer la première fois, il faut juste saisir la commande suivante :

net start svn

Créer son premier espace partagé

Pour cela nous allons utiliser le client svn Tortoise svn.

L'opération ne prend que quelques étapes (cette première étape n'est à réaliser qu'une fois) :

1. aller dans le répertoire contenant votre carte, faire un click droit et choisir d'importer un projet
   
2. préciser l'adresse du référentiel (en local 127.0.0.1, et à distance il faudra récupérer l'adresse IP)
   
3. saisir les informations d'authentification
   

Les fichiers sont maintenant dans le référentiel.

Maintenant il n'y a plus qu'à les extraire du référentiel pour travailler dessus (cette phase sera à réaliser sur chaque poste client) :

1. aller là où vous souhaitez extraire les cartes et fait un click droit
   
2. préciser l'adresse du référentiel
   

Maintenant que toute l'initialisation est terminée, la suite se passera sous freeplane :)

Ouvrez la carte normalement, travaillez dessus et publiez là avec "F12".

Si d'autres contributeurs travaillent dessus en parallèle, mettez là à jour avec "F11".