Manuals

Intégration avec des visionneuses de dépôt web

Il existe plusieurs visionneuses de dépôt web compatibles avec Subversion, comme ViewVC et WebSVN. TortoiseSVN vous fournit le moyen de vous relier à ces visionneuses.

Vous pouvez intégrer la visionneuse de dépôt de votre choix dans TortoiseSVN. Pour ce faire, vous n'avez qu'à renseigner quelques propriétés permettant la liaison. Elles sont à positionner sur les dossiers : (la section intitulée « Configuration des projets »)

webviewer:revision

Positionnez cette propriété à l'URL où votre visionneuse de dépôt vous affiche tous les changements d'une révision spécifique. Elle doit être correctement encodée comme une URI et doit contenir %REVISION%. %REVISION% est remplacé par le numéro de la révision en question. Cela permet à TortoiseSVN d'afficher un élément de menu contextuel dans la boîte de dialogue du journal menu contextuelVoir la révision dans la visionneuse web.

webviewer:pathrevision

Positionnez cette propriété à l'URL où votre visionneuse de dépôt vous affiche les changements d'un fichier spécifique dans une révision spécifique. Elle doit être correctement encodée comme une URI et doit contenir %REVISION% et %PATH%. %PATH% est remplacé par le chemin relatif à la racine du dépôt. Cela permet à TortoiseSVN d'afficher un élément de menu contextuel dans la boîte de dialogue du journal menu contextuelVoir la révision pour le chemin dans la visionneuse web. Par exemple, si, dans le panneau du bas de la boîte de dialogue du journal, vous faites un clic droit sur l'entrée d'un fichier /trunk/src/fichier, alors le %PATH% dans l'URL sera remplacé par /trunk/src/fichier.

Vous pouvez utiliser des URLs relatives à la place des URLs absolues. Cela peut être utile quand votre visionneuse est sur le même serveur que votre dépôt. Ainsi, si vous changez de nom de domaine, vous n'aurez pas à modifier les propriétés webviewer:revision et webviewer:pathrevision. Le format est le même que pour la propriété bugtraq:url. Voir la section intitulée « Intégration avec des systèmes de gestion de bug / gestion d'incidents ».

Positionnez les propriétés sur les dossiers

Ces propriétés doivent être positionnées sur les dossiers pour que le système fonctionne. Quand vous livrez un fichier ou un dossier, ce sont les propriétés de ce dossier qui sont lues. S'il n'y trouve pas les propriétés, TortoiseSVN va les chercher en remontant l'arborescence jusqu'à ce qu'il arrive à un dossier non versionné ou à la racine (par exemple C:\). Si vous pouvez être sûr que chaque utilisateur extrait à partir du même endroit, par exemple de trunk/ et pas d'un sous-dossier, alors il suffit de positionner les propriétés sur trunk/. Si vous ne pouvez pas en être sûr, vous devriez positionner les propriétés sur chaque sous-dossier de manière récursive. Une propriété positionnée plus bas dans la hiérarchie du projet surcharge celles positionnées sur les niveaux plus élevés (c'est-à-dire plus près de trunk/).

Pour les propriétés de projet uniquement, c'est-à-dire tsvn:, bugtraq: et webviewer: vous pouvez utiliser la case à cocher Récursif pour appliquer la propriété à tous les sous-dossiers, sans avoir à la mettre aussi sur tous les fichiers.

Lorsque vous ajoutez un nouveau sous-dossier à une copie de travail via TortoiseSVN, toutes les propriétés de projet du dossier parent seront automatiquement ajoutées à ce nouveau dossier fils.

Limitations de l'utilisation de l'explorateur de dépôt

Comme l'intégration d'une visionneuse de dépôt repose sur l'accès aux propriétés Subversion, vous n'en verrez les résultats que quand vous travaillez sur une copie de travail extraite. Récupérer des propriétés sur le serveur est une opération lente, donc vous ne verrez pas cette fonctionnalité à l'œuvre dans le navigateur de dépôt, à moins que vous n'ayez démarré le navigateur de dépôt depuis votre copie de travail. Si vous avez démarré le navigateur de dépôt en saisissant l'URL du dépôt, vous ne verrez pas cette fonctionnalité.

Pour la même raison, les propriétés du projet ne seront pas propagées automatiquement quand un dossier enfant est ajouté en utilisant le navigateur du dépôt.

TortoiseSVN homepage