Table des matières
- Pour commencer
- Importer des données dans un référentiel
- Extraire une copie de travail
- Livrer vos changements au référentiel
- Mettre à jour votre copie de travail avec les changements des autres
- Résoudre des conflits
- Obtenir des information sur le statut
- Listes de changements
- La boîte de dialogue du Journal de révision
- Appeler la boîte de dialogue du Journal de révision
- La boîte de dialogue du Journal de révision
- Obtenir des informations supplémentaires
- Obtenir plus de commentaires
- Révision de la Copie de Travail Courante
- Fonctionnalités de Suivi des Fusions
- Changer le commentaire et l'auteur
- Filtrer les commentaires
- Informations statistiques
- Mode hors ligne
- Refraîchissement de l'affichage
- Voir les différences
- Ajouter de nouveaux fichiers et répertoires
- Copier/Déplacer/Renommer des Fichiers et des Dossiers
- Ignorer des fichiers et des répertoires
- Supprimer, déplacer et renommer
- Annuler les changements
- Nettoyer
- Configuration des projets
- Eléments externes
- Brancher / Étiqueter
- Fusionner
- Verrouiller
- Créer et appliquer des patches
- Qui a changé quelle ligne ?
- l'explorateur de référentiel
- Graphiques de révision
- Exporter une copie de travail Subversion
- Relocaliser une copie de travail
- Intégration avec des systèmes de bug tracking / traqueurs d'incidents
- Intégration avec des explorateur de référentiel de type web.
- Configuration de TortoiseSVN
- Configuration générale
- Options du Graphe des Révisions
- Configuration du recouvrement d'icônes
- Configuration du réseau
- Réglages des programmes externes
- Configuration des données sauvegardées
- Mise en Cache des messages de log
- Scripts hook côté client
- Configuration de TortoiseBlame
- Dossiers de travail de Subversion
- Advanced Settings
- Étape Finale
Ce document décrit l'utilisation quotidienne du client TortoiseSVN. Ce n'est pas une introduction aux systèmes de contrôle de version, ni une introduction à Subversion (SVN). C'est plutôt un endroit où vous pouvez regarder quand vous savez approximativement ce que vous voulez faire, mais vous ne vous rappelez pas tout à fait comment le faire.
If you need an introduction to version control with Subversion, then we recommend you read the fantastic book: Version Control with Subversion.Si vous avez besoin d'une introduction au contrôle de version avec Subversion, alors nous vous recommandons la lecture du livre fantastique : Version Control with Subversion.
Ce document est aussi un travail en cours, de même que TortoiseSVN et Subversion. Si vous trouvez des erreurs, veuillez les annoncer sur la mailing list pour que nous puissions mettre à jour la documentation. Certaines copies d'écran dans le Guide d'Utilisation Quotidienne (GUQ) pourraient ne pas refléter l'état actuel du logiciel. Veuillez nous pardonner. Nous travaillons sur TortoiseSVN pendant notre temps libre.
Pour se servir au mieux du guide d'utilisation quotidienne :
Vous devez avoir déjà installé TortoiseSVN.
Vous devriez être familier avec les systèmes de contrôle de version.
Vous devez connaître les bases de Subversion.
Vous devriez avoir mis en place un serveur et/ou avoir accès à un référentiel Subversion.
Une des fonctionnalités les plus visibles de TortoiseSVN sont les recouvrements d'icônes qui apparaissent sur les fichiers de votre copie de travail. Celles-ci vous montrent en un clin d'oeil quels fichiers ont été modifiés. Référez-vous à la section intitulée « Recouvrement d'icônes » pour découvrir que représentent les différentes icônes.
Toutes les commandes de TortoiseSVN sont invoquées à partir du menu contextuel de l'explorateur Windows. La plupart sont directement visibles quand vous faites un clic droit sur un fichier ou sur un dossier. Les commandes disponibles dépendent si le fichier ou le dossier ou son dossier parent sont sous contrôle de version ou non. Vous pouvez aussi voir le menu TortoiseSVN comme un partie du menu fichier de l'Explorateur.
Astuce
Quelques commandes qui sont très rarement utilisées ne sont accessibles que dans l'extension du menu contextuel. Pour afficher cette extension, appuyer sur Shift au moment où vous faites le click-droit.
Dans certains cas, vous pouvez voir plusieurs entrées TortoiseSVN. Ce n'est pas un bug !
Cet exemple est pour un raccourci non versionné dans un dossier versionné et dans le menu de fichier de l'Explorateur il y a trois entrées pour TortoiseSVN. L'une est pour le dossier, une autre pour le raccourci lui-même et la troisième pour l'objet sur lequel pointe le raccourci. Pour vous aider à les distinguer entre elles, les icônes ont un indicateur dans le coin inférieur droit pour montrer si l'entrée de menu est pour un fichier, un dossier, un raccourci ou pour des plusieurs éléments sélectionnés.
Si vous êtes un utilisateur de Windows 2000 vous verrez le menu contextuel sans icone. Nous savons que cela fonctionnait dans les versions précédentes, mais Microsoft has changed the way its icon handlers work for Vista, requiring us to use a different display method which unfortunately does not work on Windows 2000.
Figure 4.4. Menu pour un répertoire sous contrôle de version lors d'un glisser-déplacer avec le bouton droit
D'autres commandes sont disponibles par glisser-déposer, quand vous glissez-déposez avec le bouton droit des fichiers ou des dossiers vers un nouvel emplacement à l'intérieur des copies de travail ou quand vous glissez-déposez avec le bouton droit un fichier non versionné ou un dossier dans un répertoire qui est sous contrôle de version.
Quelques opérations communes ont des raccourcis Windows bien connus, mais qui n'apparaissent ni sur les boutons ni dans les menus. Si vous ne savez pas comment faire quelque chose d'évident, comme le rafraîchissement d'une vue, regardez ici.
- F1
L'aide, bien sûr.
- F5
Rafraîchir la vue courante. C'est peut-être la commande d'une touche la plus utile. Par exemple... Dans l'Explorateur cela rafraîchira le recouvrement des icônes sur votre copie de travail. Dans la boîte de dialogue de livraison il re-parcourra la copie de travail pour voir ce qui peut avoir besoin d'être livré. Dans la boîte de dialogue du journal il entrera à nouveau en contact avec le référentiel pour vérifier s'il y a des changements plus récents.
- Ctrl-A
Sélectionner tout. Cela peut être utilisé si vous obtenez un message d'erreur et que vous voulez copier-coller dans un email. Utilisez Ctrl-A pour choisir le message d'erreur et ensuite...
- Ctrl-C
... Copier le texte choisi.
Si le référentiel auquel vous essayez d'avoir accès est protégé par un mot de passe, une boîte de dialogue d'identification s'affichera.
Entrez votre nom d'utilisateur et votre mot de passe. La case à cocher fera que TortoiseSVN stockera les accréditations dans le répertoire de Subversion par défaut : %APPDATA%\Subversion\auth dans trois sous-répertoires :
svn.simplecontains credentials for basic authentication (username/password). Note that passwords are stored using the WinCrypt API, not in plain text form.svn.ssl.servercontient des certificats serveur SSL.svn.usernamecontient les accréditations pour l'authentification avec le nom d'utilisateur uniquement (aucun mot de passe nécessaire).
Si vous voulez effacer le cache d'authentification pour tous les serveurs, vous pouvez le faire à partir de la page Données Sauvegardées de la boîte de dialogue de configuration de TortoiseSVN. Ce bouton effacera toutes les données d'authentification gardées en cache dans les répertoire auth de Subversion, aussi bien que les authentifications stockées par des versions précédemment installées de TortoiseSVN. Référez-vous à la section intitulée « Configuration des données sauvegardées ».
If you want to clear authentication for one realm only then you will have to dig into those directories, find the file which contains the information you want to clear and delete the file.
Certains préfèrent que leurs données d'identification soient supprimées à l'ouverture ou à la fermeture de Windows. Le moyen de le faire est d'utiliser un script de fermeture pour supprimer le répertoire %APPDATA%\Subversion\auth, i.e.
@echo off rmdir /s /q "%APPDATA%\Subversion\auth"
Vous pouvez trouver le mode d'emploi pour installer ce type de script à cette adresse windows-help-central.com.
Pour plus d'informations sur la façon de mettre en place l'authentification et le contrôle d'accès pour votre serveur, référez-vous à la section intitulée « Accéder au référentiel »
Beaucoup de fenêtres de TortoiseSVN ont nombre d'informations à afficher, mais il est souvent plus utile de maximiser leur largeur ou leur hauteur plutôt que de les afficher en plein écran. Pour ce faire, il y a des raccourcis dans le bouton Maximiser. Utilisez le bouton du milieu de la souris pour agrandir la hauteur, et le bouton droit de la souris pour élargir.