Avant d'utiliser Subversion (SVN) comme système de contrôle des versions avec Dreamweaver, vous devez établir une connexion à un serveur SVN. Pour définir une connexion à un serveur SVN, utilisez la catégorie Contrôle de version de la boîte de dialogue Définition du site.

Le serveur SVN est un référentiel de fichiers depuis lequel vous (et d'autres utilisateurs) pouvez obtenir et valider des fichiers. Il est différent du serveur distant qu'on utilise généralement dans Dreamweaver. En cas d'utilisation de SVN, le serveur distant reste le serveur « en direct » pour vos pages Web. Le serveur SVN sert pour sa part au stockage du référentiel des fichiers au sujet desquels vous voulez conserver un contrôle de version. Le processus habituel consiste à obtenir des fichiers depuis le serveur SVN et à les y valider, puis à les publier sur votre serveur distant à partir de Dreamweaver. La configuration du serveur distant est tout à fait distincte de celle de SVN.

Avant de pouvoir entamer cette configuration, vous devez disposer d'un accès à un serveur SVN et à un référentiel SVN. Pour plus d'informations sur SVN, consultez le site Web de Subversion à l'adresse http://subversion.tigris.org/.

Pour configurer la connexion SVN, procédez comme suit :

1. Choisissez Site > Gérer les sites, sélectionnez le site pour lequel vous voulez configurer le contrôle des versions, puis cliquez sur le bouton Modifier.

   Remarque : Si vous n'avez pas encore défini de dossiers locaux et distants pour un site Dreamweaver, vous devrez au moins configurer un site local avant de pouvoir continuer. Le site distant n'est pas nécessaire pour l'instant, mais vous devrez en définir un pour pouvoir publier vos fichiers sur le Web. Pour plus d'informations, voir Configuration d'un site Dreamweaver.

2. Assurez-vous que l'onglet Avancé de la boîte de dialogue Définition du site est bien sélectionné.

3. Choisissez la catégorie Contrôle de version dans la colonne Catégorie de la boîte de dialogue Définition du site.

4. Sélectionnez Subversion dans la liste déroulante Accès.

5. Définissez les options d'accès comme suit :

   • Sélectionnez un protocole dans la liste déroulante Protocole. Les protocoles disponibles sont HTTP, HTTPS, SVN et SVN+SSH.

     Remarque : L'emploi du protocole SVN+SSH exige une configuration spéciale. Pour plus d'informations, voir www.adobe.com/go/learn_dw_svn_ssh_fr.

   • Entrez l'adresse du serveur SVN dans la zone de texte Adresse du serveur (généralement sous la forme nomserveur.domaine.com).

   • Entrez le chemin d'accès à votre référentiel sur le serveur SVN dans la zone Référentiel (généralement sous la forme /svn/votre_répertoire_racine. C'est à l'administrateur du serveur de nommer le dossier racine pour le référentiel SVN).

   • (Facultatif) Si vous voulez utiliser un port de serveur différent du port par défaut, activez l'option Instance spécifique puis entrez un numéro de port dans la zone de texte.

   • Entrez votre nom d'utilisateur et votre mot de passe sur SVN.

6. Cliquez sur Tester pour tester votre connexion, ou sur OK pour fermer la boîte de dialogue. Cliquez ensuite sur Terminé pour fermer la boîte de dialogue Gérer les sites.

Lorsque la connexion au serveur est établie, votre référentiel SVN peut être visualisé dans le panneau Fichiers. Pour le visualiser, vous pouvez choisir le mode Affichage du référentiel dans la liste déroulante Affichage, ou cliquez sur le bouton Fichiers du référentiel dans le panneau Fichiers développé.

Le processus de montage de dossiers du référentiel SVN sur votre ordinateur local crée un mappage précis de la structure des dossiers sur le référentiel SVN. Lorsque vous montez un dossier à partir du référentiel SVN, Dreamweaver obtient tous les fichiers figurant dans ce dossier, ainsi que ses éventuels sous-dossiers.

1. Assurez-vous d'avoir bien défini une connexion SVN.

2. Affichez les fichiers du référentiel SVN en choisissant Affichage du référentiel dans la liste déroulante Affichage du panneau Fichiers ou en cliquant sur le bouton Fichiers du référentiel dans le panneau Fichiers développé.

3. Cliquez avec le bouton droit de la souris (Windows) ou en maintenant la touche Contrôle enfoncée (Macintosh) sur le dossier du référentiel SVN que vous voulez monter, puis choisissez Monter les dossiers.

Lorsque vous obtenez la version la plus récente d'un fichier depuis le référentiel SVN, Dreamweaver fusionne le contenu de ce fichier à celui de la copie locale correspondante. En d'autres termes, si un autre utilisateur a mis à jour le fichier depuis la dernière fois où vous l'avez validé, ses mises à jour sont fusionnées avec la version locale du fichier sur votre ordinateur. Si le fichier n'existe pas sur le disque dur local, Dreamweaver se contente de l'obtenir.

1. Assurez-vous d'avoir bien défini une connexion SVN.

2. Effectuez l'une des opérations suivantes :

   • Affichez la version locale de vos fichiers SVN dans le panneau Fichiers en choisissant Affichage local dans la liste déroulante Affichage. Si vous travaillez dans le panneau Fichiers développé, l'affichage local est automatiquement disponible. Cliquez ensuite avec le bouton droit de la souris (Windows) ou en maintenant la touche Contrôle enfoncée (Macintosh) sur le fichier ou le dossier qui vous intéresse, puis cliquez sur Contrôle de version > Obtenir les versions les plus récentes.

   • Affichez les fichiers du référentiel SVN en choisissant Affichage du référentiel dans la liste déroulante Affichage du panneau Fichiers ou en cliquant sur le bouton Fichiers du référentiel dans le panneau Fichiers développé. Cliquez ensuite avec le bouton droit de la souris (Windows) ou en maintenant la touche Contrôle enfoncée (Macintosh) sur le fichier ou le dossier qui vous intéresse, puis cliquez sur Obtenir les versions les plus récentes.

1. Assurez-vous d'avoir bien défini une connexion SVN.

2. Effectuez l'une des opérations suivantes :

   • Affichez la version locale de vos fichiers SVN dans le panneau Fichiers en choisissant Affichage local dans la liste déroulante Affichage. Si vous travaillez dans le panneau Fichiers développé, l'affichage local est automatiquement disponible. Sélectionnez ensuite le fichier à valider puis cliquez sur Archiver.

   • Affichez les fichiers du référentiel SVN en choisissant Affichage du référentiel dans la liste déroulante Affichage du panneau Fichiers ou en cliquant sur le bouton Fichiers du référentiel dans le panneau Fichiers développé. Cliquez ensuite avec le bouton droit de la souris (Windows) ou en maintenant la touche Contrôle enfoncée (Macintosh) sur le fichier que vous voulez valider, puis cliquez sur Valider.

3. Prenez connaissance des actions dans la boîte de dialogue Archivage, apportez les éventuelles modifications requises, puis cliquez sur OK.

   Vous pouvez modifier des actions en les sélectionnant puis en cliquant sur le bouton dans le bas de la boîte de dialogue Archivage. Deux options sont disponibles : Valider et Ignorer.

Vous pouvez mettre à jour l'état SVN d'un fichier ou d'un dossier. La mise à jour n'actualise pas l'affichage tout entier.

1. Assurez-vous d'avoir bien défini une connexion SVN.

2. Affichez les fichiers du référentiel SVN en choisissant Affichage du référentiel dans la liste déroulante Affichage du panneau Fichiers ou en cliquant sur le bouton Fichiers du référentiel dans le panneau Fichiers développé.

3. Cliquez ensuite avec le bouton droit de la souris (Windows) ou en maintenant la touche Contrôle enfoncée (Macintosh) sur n'importe quel fichier ou dossier du référentiel, puis cliquez sur Mettre à jour l'état.

Vous pouvez mettre à jour l'état SVN d'un fichier ou d'un dossier. La mise à jour n'actualise pas l'affichage tout entier.

1. Assurez-vous d'avoir bien défini une connexion SVN.

2. Affichez la version locale de vos fichiers SVN dans le panneau Fichiers en choisissant Affichage local dans la liste déroulante Affichage. Si vous travaillez dans le panneau Fichiers développé, l'affichage local est automatiquement disponible.

3. Cliquez ensuite avec le bouton droit de la souris (Windows) ou en maintenant la touche Contrôle enfoncée (Macintosh) sur n'importe quel fichier ou dossier du panneau Fichiers, puis cliquez sur Mettre à jour l'état.

1. Assurez-vous d'avoir bien défini une connexion SVN.

2. Effectuez l'une des opérations suivantes :

   • Affichez la version locale de vos fichiers SVN dans le panneau Fichiers en choisissant Affichage local dans la liste déroulante Affichage. Si vous travaillez dans le panneau Fichiers développé, l'affichage local est automatiquement disponible. Sélectionnez ensuite le fichier dont vous voulez consulter les versions, puis choisissez Contrôle de version > Afficher les versions.

   • Affichez les fichiers du référentiel SVN en choisissant Affichage du référentiel dans la liste déroulante Affichage du panneau Fichiers ou en cliquant sur le bouton Fichiers du référentiel dans le panneau Fichiers développé. Cliquez ensuite avec le bouton droit de la souris (Windows) ou en maintenant la touche Contrôle enfoncée (Macintosh) sur le fichier dont vous voulez afficher les versions, puis choisissez Afficher les versions.

3. Dans la boîte de dialogue Historique des versions, choisissez la ou les versions qui vous intéressent, puis effectuez l'une des actions suivantes :

   • Cliquez sur Comparer au site local pour comparer la version sélectionnée à la version locale du fichier.

     Remarque : Vous devez installer un outil de comparaison de fichiers, provenant d'un éditeur tiers, avant de pouvoir comparer les fichiers. Pour plus d'informations sur les outils de comparaison de fichiers, utilisez un moteur de recherche Web tel que Google pour trouver des outils de « comparaison de fichiers » ou « diff ». Dreamweaver fonctionne avec la plupart des outils tiers.

   • Cliquez sur Comparer pour comparer deux versions sélectionnées. Cliquez tout en maintenant la touche CTRL enfoncée pour sélectionner deux versions simultanément.

   • Cliquez sur Afficher pour afficher la version sélectionnée. Cette action n'entraîne pas le remplacement de la copie locale actuelle du fichier concerné. Vous pouvez enregistrer la version sélectionnée sur votre disque dur comme vous le feriez avec n'importe quel autre fichier.

   • Cliquez sur Marquer comme actuel pour faire de la version sélectionnée la version la plus récente du référentiel.

Le verrouillage d'un fichier dans le référentiel SVN permet d'indiquer aux autres utilisateurs que vous êtes en train de travailler dessus. Les autres utilisateurs peuvent toujours modifier le fichier localement, mais ils ne pourront valider le fichier que quand vous l'aurez déverrouillé. Lorsque vous verrouillez un fichier dans le référentiel, vous verrez que ce fichier s'accompagne d'une icône représentant un cadenas ouvert. Pour les autres utilisateurs, l'icône représente un cadenas fermé.

1. Assurez-vous d'avoir bien défini une connexion SVN.

2. Effectuez l'une des opérations suivantes :

   • Affichez les fichiers du référentiel SVN en choisissant Affichage du référentiel dans la liste déroulante Affichage du panneau Fichiers ou en cliquant sur le bouton Fichiers du référentiel dans le panneau Fichiers développé. Cliquez ensuite avec le bouton droit de la souris (Windows) ou en maintenant la touche Contrôle enfoncée (Macintosh) sur le fichier qui vous intéresse, puis choisissez Verrouiller ou Déverrouiller.

   • Affichez la version locale de vos fichiers SVN dans le panneau Fichiers en choisissant Affichage local dans la liste déroulante Affichage. Si vous travaillez dans le panneau Fichiers développé, l'affichage local est automatiquement disponible. Sélectionnez ensuite le fichier qui vous intéresse, puis choisissez Verrouiller ou Déverrouiller.

La présence d'un symbole « plus » bleu sur un fichier dans le panneau Fichiers indique que ce fichier n'existe pas encore dans le référentiel SVN.

1. Assurez-vous d'avoir bien défini une connexion SVN.

2. Dans le panneau Fichiers, sélectionnez le fichier à ajouter au référentiel, puis cliquez sur le bouton Archiver.

3. Assurez-vous que le fichier est sélectionné pour une validation dans la boîte de dialogue Validation, puis cliquez sur OK.

Si votre fichier est en conflit avec un autre fichier sur le serveur, vous pouvez le modifier puis le marquer comme étant résolu. Par exemple, si vous tentez d'archiver un fichier qui est en conflit avec les modifications apportées par un autre utilisateur, SVN ne vous permettra pas de valider ce fichier. Vous pouvez obtenir la version la plus récente du fichier depuis le référentiel, apporter manuellement des modifications à votre copie de travail, puis marquer votre fichier comme étant résolu de façon à pouvoir le valider.

1. Assurez-vous d'avoir bien défini une connexion SVN.

2. Affichez la version locale de vos fichiers SVN dans le panneau Fichiers en choisissant Affichage local dans la liste déroulante Affichage. Si vous travaillez dans le panneau Fichiers développé, l'affichage local est automatiquement disponible.

3. Cliquez avec le bouton droit de la souris (Windows) ou en maintenant la touche Contrôle enfoncée (Macintosh) sur le fichier dont vous voulez résoudre le conflit, puis choisissez Contrôle de version > Marquer comme résolu.

Il peut s'avérer utile de travailler hors ligne, de manière à éviter tout accès au référentiel pendant d'autres activités de transfert de fichiers. Dreamweaver se connecte au référentiel SVN dès que vous lancez une activité qui exige une connexion (Obtenir les versions les plus récentes, Valider, etc.).

1. Assurez-vous d'avoir bien défini une connexion SVN.

2. Affichez la version locale de vos fichiers SVN dans le panneau Fichiers en choisissant Affichage local dans la liste déroulante Affichage. Si vous travaillez dans le panneau Fichiers développé, l'affichage local est automatiquement disponible.

3. Cliquez avec le bouton droit de la souris (Windows) ou en maintenant la touche Contrôle enfoncée (Macintosh) sur n'importe quel fichier ou dossier du panneau Fichiers, puis choisissez Contrôle de version > Travailler hors ligne.

Cette commande permet de supprimer les verrous des fichiers, de manière à reprendre des activités non terminées. Utilisez cette commande pour supprimer d'anciens verrous si vous recevez des messages d'erreur vous informant que la copie de travail est verrouillée.

1. Assurez-vous d'avoir bien défini une connexion SVN.

2. Affichez la version locale de vos fichiers SVN dans le panneau Fichiers en choisissant Affichage local dans la liste déroulante Affichage. Si vous travaillez dans le panneau Fichiers développé, l'affichage local est automatiquement disponible.

3. Cliquez avec le bouton droit de la souris (Windows) ou en maintenant la touche Contrôle enfoncée (Macintosh) sur le fichier à nettoyer, puis choisissez Contrôle de version > Nettoyer.

Lorsque vous déplacez les versions locales de fichiers ou de dossiers dans un site contrôlé par Subversion, vous risquez de créer des problèmes à d'autres utilisateurs qui pourraient se synchroniser avec le référentiel SVN. Par exemple, si vous déplacez un fichier localement et ne le validez pas dans le référentiel pendant quelques heures, il se peut qu'un autre utilisateur tente d'en obtenir la version la plus récente depuis son ancien emplacement. Veillez donc à toujours valider les fichiers sur le serveur SVN juste après les avoir déplacés localement.

Les fichiers et les dossiers demeurent sur le serveur jusqu'à ce que vous les supprimiez manuellement. Ainsi, même si vous déplacez un fichier dans un dossier local différent et que vous le validez, son ancienne version reste à l'emplacement précédent sur le serveur. Pour éviter toute confusion, supprimez les anciennes copies des fichiers et dossiers que vous avez déplacés.

Lorsque vous déplacez un fichier localement et que vous le validez de nouveau sur le serveur SVN, l'historique des versions du fichier est perdu.