SVNBOOK Chap1 Subversion in Action Subversion Repository URLs

De Framalang Wiki.

Cette page fait partie du projet Version control with subversion.


Pseudo Code Rôle Statut
Penguin Traduction Terminé
SVF 1ère Relecture Fait
Relecture
Validation



Sommaire

Titre

Subversion Repository URLs
Les URLs des dépôts Subversion

Paragraphe 1

Throughout this book, Subversion uses URLs to identify versioned files and directories in Subversion repositories. For the most part, these URLs use the standard syntax, allowing for server names and port numbers to be specified as part of the URL:
Tout au long de ce livre, Subversion va utiliser des URLs pour identifier des fichiers et des répertoires versionnés au sein de dépôts Subversion. Pour la plupart, ces URLs utilisent la syntaxe standard, permettant de spécifier les noms des serveurs et les numéros de port à l'intérieur même de l'URL.
$ svn checkout http://svn.example.com:9834/repos
…

$ svn checkout http://svn.exemple.com:9834/depot
…

Paragraphe 2

But there are some nuances in Subversion's handling of URLs that are notable. For example, URLs containing the file:// access method (used for local repositories) must, in accordance with convention, have either a server name of localhost or no server name at all:
Mais il existe quelques nuances dans la gestion des URLs par Subversion qui doivent être notées. Par exemple, les URLs ayant pour méthode d'accès file:// (utilisée pour les dépôts locaux) doivent, en accord avec les conventions, posséder soit un nom de serveur localhost, soit pas de nom de serveur du tout :
$ svn checkout file:///var/svn/repos
…
$ svn checkout file://localhost/var/svn/repos
…

$ svn checkout file:///var/svn/depot
…
$ svn checkout file://localhost/var/svn/depot
…

Paragraphe 3

Also, users of the file:// scheme on Windows platforms will need to use an unofficially “standard” syntax for accessing repositories that are on the same machine, but on a different drive than the client's current working drive. Either of the two following URL path syntaxes will work where X is the drive on which the repository resides:

D'autre part, les utilisateurs du procédé file:// sur les plateformes Windows devront se servir d'une syntaxe qui est un "standard" officieux pour accéder à leurs dépôts se trouvant sur la même machine mais sur un disque différent que le disque de travail habituel du client. Les deux syntaxes de chemin d'URL suivantes fonctionnent, X étant le disque sur lequel le dépôt se trouve : 

C:\> svn checkout file:///X:/var/svn/repos
…
C:\> svn checkout "file:///X|/var/svn/repos"
…

C:\> svn checkout file:///X:/var/svn/depot
…
C:\> svn checkout "file:///X|/var/svn/depot"
…

Paragraphe 4

In the second syntax, you need to quote the URL so that the vertical bar character is not interpreted as a pipe. Also, note that a URL uses forward slashes even though the native (non-URL) form of a path on Windows uses backslashes.

Dans la seconde syntaxe, vous aurez besoin d'entourer l'URL de guillemets pour éviter que le caractère de barre verticale ne soit interprété comme un symbole de redirection (un "pipe"). De plus, remarquez qu'une URL utilise des barres obliques (ou "slash") alors que la forme native (non-URL) d'un chemin sous Windows utilise des barres obliques inversées (ou "antislash").

Paragraphe 5

Subversion's file:// URLs cannot be used in a regular web browser the way typical file:// URLs can. When you attempt to view a file:// URL in a regular web browser, it reads and displays the contents of the file at that location by examining the filesystem directly. However, Subversion's resources exist in a virtual filesystem (see the section called “Repository Layer”), and your browser will not understand how to interact with that filesystem.

Les URLs Subversion file:// ne peuvent pas être utilisées dans un navigateur web classique de la même façon qu'une URL file:// habituelle. Lorsque vous essayez de visualiser une URL file:// dans un navigateur web classique, il lit et affiche le contenu du fichier situé à cet emplacement en interrogeant directement le système de fichiers. Cependant, les ressources de Subversion existent dans un système de fichier virtuel (cf. la section "Couche dépôt"), et votre navigateur ne va pas comprendre comment interagir avec ce système de fichiers.

--Sub Versif 26 février 2009 à 17:02 (CET) : Titre de la section du chapitre 8 à modifier/valider une fois ce paragraphe traduit.

Paragraphe 6

Finally, it should be noted that the Subversion client will automatically encode URLs as necessary, just like a web browser does. For example, if a URL contains a space or upper-ASCII character as in the following: 

$ svn checkout "http://host/path with space/project/españa"

…then Subversion will escape the unsafe characters and behave as if you had typed: 

$ svn checkout http://host/path%20with%20space/project/espa%C3%B1a
If the URL contains spaces, be sure to place it within quote marks, so that your shell treats the whole thing as a single argument to the svn program.

Enfin, il faut noter que le client Subversion va automatiquement encoder les URLs en cas de besoin, exactement comme le fait un navigateur web. Par exemple, si une URL contient un espace ou un caractère ASCII spécial, comme dans ce qui suit : 

$ svn checkout "http://hote/chemin avec espace/projet/españa"

…alors Subversion va banaliser les caractères spéciaux et se comporter comme si vous aviez tapé : 

$ svn checkout http://hote/chemin%20avec%20espace/projet/espa%C3%B1a
Si l'URL contient des espaces, prenez bien soin de la placer entre guillemets, pour que votre shell traite le tout comme un seul argument pour le programme svn.

Paragraphe 7

Repository URLs
Subversion repositories can be accessed through many different methods—on local disk, or through various network protocols, depending on how your administrator has set things up for you. A repository location, however, is always a URL. Table 1.1, “Repository Access URLs” describes how different URL schemes map to the available access methods. 
Table 1.1. Repository Access URLs
Schema	                                      Access Method
file:///	             direct repository access (on local disk)
http://	            access via WebDAV protocol to Subversion-aware Apache server
https://	           same as http://, but with SSL encryption.
svn://	                    access via custom protocol to an svnserve server
svn+ssh://	       same as svn://, but through an SSH tunnel.
For more information on how Subversion parses URLs, see the section called “Subversion Repository URLs”. For more information on the different types of network servers available for Subversion, see Chapter 6, Server Configuration.
URL du dépôt
On peut accéder aux dépôts Subversion de beaucoup de manières différentes, sur un disque local ou à travers différents protocoles réseau, en fonction de la façon dont votre administrateur a mis les choses en place pour vous. L'emplacement d'un dépôt, toutefois, est toujours une URL. Le tableau 1.1, "URLs d'accès au dépôt", décrit les différents procédés d'accès et les méthodes d'accès correspondantes. 
Tableau 1.1 URLs d'accès au dépôt
Procédé                                      Méthode d'accès
file:///	             accès direct au dépôt (sur un disque local)
http://	    accès via le protocole WebDAV à un serveur Apache configuré pour Subversion
https://	           identique à http://, mais avec chiffrement SSL
svn://	                    accès via un protocole personnalisé à un serveur svnserve
svn+ssh://	       identique à svn://, mais à travers un tunnel SSH
Pour plus d'informations sur la façon dont Subversion analyse les URLs, se reporter à la section "Les URLs du dépôt Subversion". Pour plus d'informations sur les différents types de serveurs réseaux disponibles pour Subversion, se reporter au Chapitre 6, Configuration serveur.
Récupérée de « http://www.framalang.org/wiki/SVNBOOK_Chap1_Subversion_in_Action_Subversion_Repository_URLs »