Utiliser SVN - Revision history

Bech: Lien page anglaise

2014-10-08T08:43:12Z

Lien page anglaise

Bech: Correction accès svn

2014-07-04T21:46:08Z

Correction accès svn

Bech: modification terme commit

2012-03-20T10:39:00Z

modification terme commit

Bech: Création page

2012-03-06T19:18:03Z

Création page

New page

Le code de développement d'Apertium est conservé dans SVN. Ce qui suit est une cheatsheet(?) de base pour utiliser SVN. Le dépôt SVN est arrangé en quatre sous-répertoires:
* <code>trunk</code> — il contient l'arbre de développement principal,
* <code>tags</code> — il contient les versions archivées des releases,
* <code>branches</code> — il contient les branches sur lesquelles des gens travaillent pour chacun des modules dans <code>trunk</code>,
* <code>incubator</code> — il contient les modules en cours de développement (surtout des paires de langues) qui n'ont pas encore été mises dans <code>trunk</code>

Si vous êtes nouveau sur Apertium et SVN, vous voulez probablement juste regarder le sous-répertoire <code>trunk</code>. Pour examiner son arborescence, vous pouvez aller sur : [https://apertium.svn.sourceforge.net/svnroot/apertium/trunk données brutes] ou [https://apertium.svn.sourceforge.net/viewvc/apertium/ ViewSVN]

== SVN, c'est quoi ? ==

SVN est un système de contrôle de version. Les utilisateurs de Linux et Mac devraient l'avoir déjà installé (sinon, il sera disponible à travers votre gestionnaire de paquets), les utilisateurs de Windows devraient utiliser [https://tortoisesvn.net/downloads tortoisesvn] (voir [[Utiliser SVN avec TortoiseSVN]]).

== Tout le monde ==

Si vous avez une bande passante ou un espace disque limité, veuillez voir [[Installation minimale depuis SVN]].

Pour récupérer toute l'arborescence :

<pre>
$ svn co https://apertium.svn.sourceforge.net/svnroot/apertium
</pre>

<div style="background-color: #bee0e0; border: dotted 4px black">
'''Note: L'arborescence totale dépasse les 4 Goctets, Si vous disposez d'une connexion lente ou avez des limitations de transfert, probablement il vaudra mieux récupérer seulement les modules dont vous avez besoin — pour une installation de base, les modules "lttoolbox" et "apertium" suffisent.'''
</div>

Pour récupérer un module :

<pre>
$ svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/<nom_module>
</pre>

Donc, par exemple, pour récupérer la paire basque-espagnol, tapez

<pre>
$ svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium-eu-es
</pre>

Pour faire une mise à jour :

<pre>
$ svn update
</pre>

== Développeurs ==

Pour "commiter" vos modifications (les envoyer au serveur) :

<pre>
$ svn commit
</pre>

''Note: N'oubliez pas d'écrire un beau message de log !''

Pour rajouter un fichier ou un répertoire '''à un module existant''' :

<pre>
$ svn add <nom du fichier ou répertoire>
</pre>

Pour supprimer un fichier ou un répertoire du serveur :

<pre>
$ svn delete <nom du fichier ou répertoire>
</pre>

''Note : Cela supprime également le fichier localement !''

Pour importer un '''nouveau module''' dans SVN :

<pre>
$ svn mkdir https://apertium.svn.sourceforge.net/svnroot/apertium/<nom_module>
</pre>

Puis <code>cd</code> dans le répertoire que vous voulez importer.

<pre>
$ svn import . https://apertium.svn.sourceforge.net/svnroot/apertium/<nom_module>
</pre>

== Raccourcis ==

Si vous utilisez SVN régulièrement, ça pourrait valoir la peine d'apprendre quelques raccourcis, pour gagner du temps.

À la place de '''svn commit''' vous pouvez utiliser :

<pre>
$ svn ci
</pre>

À la place de '''svn delete''', vous pouvez utiliser

<pre>
$ svn rm
</pre>

Si vous ne voulez pas attendre que votre éditeur de texte s'ouvre lorsque vous "commitez", vous pouvez spécifier le message de commit en ligne de commande :

<pre>
$ svn ci -m "Mon message de commité"
</pre>

Il vaut mieux noter que si vous ne comprenez pas totalement le shell, il vaudra probablement mieux rester avec l'éditeur de texte.

== Commiter seulement une partie de vos changements ==

Si vous avez changé de nombreux fichiers, et ne voulez pas commiter tout d'un coup, vous pouvez donner une liste de noms de fichiers à '''svn commit''', et seulement ces fichiers seront commité :

<pre>
$ svn ci fichier1 fichier2
</pre>

Quelquefois, il vaut mieux commiter de cette manière; pour mettre les modifications en lien entre elles dans le même commit, et garder séparément les modifications sans rapport. Ça permet plus facilement de défaire vos changements plus tard, si on s'aperçoit qu'il y a un problème.

== Défaire les modifications locales ==

Si vous avez fait des modifications que vous ne voulez pas conserver - et que vous n'avez pas commité ces modifications - vous pouvez utiliser :

<pre>
svn revert <nom des fichiers ou répertoire>
</pre>

Cela remettra les fichiers à la dernière version que vous avez récupéré sur le serveur.

== Défaire tout ou partie d'un commit ==

D'abord travaillez sur la révision que vous voulez remettre(?) (probablement la révision que vous venez de commiter moins 1), <code>cd</code> répertoire apertium .

<pre>
mv <nom_module> <nom_module>.new
svn co -r <révision> https://apertium.svn.sourceforge.net/svnroot/apertium/<nom_module>
</pre>

Maintenant copiez tous les fichiers que vous voulez remettre à l'ancienne révision (<code><nom_module></code>) dans la nouvelle révision (<code><nom_module>.new</code>), puis faire :

<pre>
rm -rf <nom_module>
mv <nom_module>.new <nom_module>
cd <nom_module>
svn commit
</pre>

== Garder la trace des nouvelles modifications ==

Vous pouvez garder la trace des nouveaux commit réalisés au moyen de
* '''email''' — en vous inscrivant sur https://lists.sourceforge.net/lists/listinfo/apertium-devel (vous pourrez rajouter quelques filtres, sinon votre boite aux lettres sera rapidement inondée)
* '''microblog''' — en suivant http://identi.ca/apertium
* '''IRC''' — en joignant [[IRC|#apertium]] sur freenode.net (ici les messages viennent de http://cia.vc/stats/project/apertium)
* '''RSS feed''' — en ajoutant https://sourceforge.net/export/rss2_keepsake.php?group_id=143781 à votre lecteur RSS favori.

== Maintenance ==

=== Erreurs "502 Bad Gateway" ===

Lors de l'exécution de certaines opérations (comme SVN COPY ou branchement/marquage, en utilisant SVN COPY), vous pouvez obtenir une erreur <code>502 Bad Gateway</code> si vous avez utilisé HTTP plutôt que HTTPS pour vérifier votre copie de travail. Repositionnez votre copie de travail sur HTTPS et réessayez. (Voir [https://sourceforge.net/apps/trac/sourceforge/ticket/8811 ce ticket] sur Sourceforge pour plus d'information. Voir [http://www.science.uva.nl/research/airSubversion502BadGateway cet article] pour une explication plus détaillée sur la raison du problème.)

<pre>
$ svn switch --relocate http://apertium.svn.sourceforge.net/ https://apertium.svn.sourceforge.net/
</pre>

=== "Host not found" lors de l'utilisation d'un proxy Squid ===

Si vous obtenez
<pre>svn: OPTIONS of 'http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/lttoolbox':
Could not resolve hostname `apertium.svn.sourceforge.net': Host not found (http://apertium.svn.sourceforge.net)
</pre>
et que vous utilisez un proxy Squid, ajoutez
<pre>
[global]
http-proxy-host=proxyhost
http-proxy-port=3128
</pre>
au fichier ~/.subversion/servers

[[Category:Documentation]]
[[Category:Documentation en français]]

@@ Line 1: / Line 1: @@
+[[Using SVN|In English]]
 Le code de développement d'Apertium est conservé dans SVN. Ce qui suit est une cheatsheet(?) de base pour utiliser SVN. Le dépôt SVN est arrangé en quatre sous-répertoires:
 * <code>trunk</code> &mdash; il contient l'arbre de développement principal,

@@ Line 45: / Line 45: @@
 == Développeurs ==
-Pour "commiter" vos modifications (les envoyer au serveur) :
+Pour enregistrer vos modifications (les envoyer au serveur) :
 <pre>
@@ Line 95: / Line 95: @@
 </pre>
-Si vous ne voulez pas attendre que votre éditeur de texte s'ouvre lorsque vous "commitez", vous pouvez spécifier le message de commit en ligne de commande :
+Si vous ne voulez pas attendre que votre éditeur de texte s'ouvre lorsque vous enregistrez, vous pouvez spécifier le message d'enregistrement en ligne de commande :
 <pre>
-$ svn ci -m "Mon message de commité"
+$ svn ci -m "Mon message d'enregistrement"
 </pre>
 Il vaut mieux noter que si vous ne comprenez pas totalement le shell, il vaudra probablement mieux rester avec l'éditeur de texte.
-== Commiter seulement une partie de vos changements ==
+== Enregistrer seulement une partie de vos changements ==
-Si vous avez changé de nombreux fichiers, et ne voulez pas commiter tout d'un coup, vous pouvez donner une liste de noms de fichiers à '''svn commit''', et seulement ces fichiers seront commité :
+Si vous avez changé de nombreux fichiers, et ne voulez pas enregistrer tout d'un coup, vous pouvez donner une liste de noms de fichiers à '''svn commit''', et seulement ces fichiers seront enregistrés :
 <pre>
@@ Line 111: / Line 111: @@
 </pre>
-Quelquefois, il vaut mieux commiter de cette manière; pour mettre les modifications en lien entre elles dans le même commit, et garder séparément les modifications sans rapport. Ça permet plus facilement de défaire vos changements plus tard, si on s'aperçoit qu'il y a un problème.
+Quelquefois, il vaut mieux enregistrer de cette manière; pour mettre les modifications en lien entre elles dans le même enregistrement, et garder séparément les modifications sans rapport. Ça permet plus facilement de défaire vos changements plus tard, si on s'aperçoit qu'il y a un problème.
 == Défaire les modifications locales ==
-Si vous avez fait des modifications que vous ne voulez pas conserver - et que vous n'avez pas commité ces modifications - vous pouvez utiliser :
+Si vous avez fait des modifications que vous ne voulez pas conserver - et que vous n'avez pas enregistré ces modifications - vous pouvez utiliser :
 <pre>
@@ Line 123: / Line 123: @@
 Cela remettra les fichiers à la dernière version que vous avez récupéré sur le serveur.
-== Défaire tout ou partie d'un commit ==
+== Défaire tout ou partie d'un enregistrement ==
-D'abord travaillez sur la révision que vous voulez remettre(?) (probablement la révision que vous venez de commiter moins 1), <code>cd</code> répertoire apertium .
+D'abord travaillez sur la révision que vous voulez restaurer (probablement la révision que vous venez d'enregistrer moins 1), <code>cd</code> répertoire apertium .
 <pre>
@@ Line 143: / Line 143: @@
 == Garder la trace des nouvelles modifications ==
-Vous pouvez garder la trace des nouveaux commit réalisés au moyen de
+Vous pouvez garder la trace des nouveaux enregistrements réalisés au moyen de
 * '''email''' &mdash; en vous inscrivant sur https://lists.sourceforge.net/lists/listinfo/apertium-devel (vous pourrez rajouter quelques filtres, sinon votre boite aux lettres sera rapidement inondée)
 * '''microblog''' &mdash; en suivant http://identi.ca/apertium

@@ Line 5: / Line 5: @@
 * <code>incubator</code> &mdash; il contient les modules en cours de développement (surtout des paires de langues) qui n'ont pas encore été mises dans <code>trunk</code>
-Si vous êtes nouveau sur Apertium et SVN, vous voulez probablement juste regarder le sous-répertoire <code>trunk</code>. Pour examiner son arborescence, vous pouvez aller sur : [https://apertium.svn.sourceforge.net/svnroot/apertium/trunk données brutes] ou [https://apertium.svn.sourceforge.net/viewvc/apertium/ ViewSVN]
+Si vous êtes nouveau sur Apertium et SVN, vous voulez probablement juste regarder le sous-répertoire <code>trunk</code>. Pour examiner son arborescence, vous pouvez aller sur : [https://svn.code.sf.net/p/apertium/svn/trunk données brutes] ou [https://apertium.svn.sourceforge.net/viewvc/apertium/ ViewSVN]
 == SVN, c'est quoi ? ==
@@ Line 28: / Line 28: @@
 <pre>
-$ svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/<nom_module>
+$ svn co https://svn.code.sf.net/p/apertium/svn/trunk/<nom_module>
 </pre>
@@ Line 34: / Line 34: @@
 <pre>
-$ svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium-eu-es
+$ svn co https://svn.code.sf.net/p/apertium/svn/trunk/apertium-eu-es
 </pre>
@@ Line 70: / Line 70: @@
 <pre>
-$ svn mkdir https://apertium.svn.sourceforge.net/svnroot/apertium/<nom_module>
+$ svn mkdir https://svn.code.sf.net/p/apertium/svn/<nom_module>
 </pre>
@@ Line 76: / Line 76: @@
 <pre>
-$ svn import . https://apertium.svn.sourceforge.net/svnroot/apertium/<nom_module>
+$ svn import . https://svn.code.sf.net/p/apertium/svn/<nom_module>
 </pre>
@@ Line 129: / Line 129: @@
 <pre>
 mv <nom_module> <nom_module>.new
-svn co -r <révision> https://apertium.svn.sourceforge.net/svnroot/apertium/<nom_module>
+svn co -r <révision> https://svn.code.sf.net/p/apertium/svn/<nom_module>
 </pre>