Difference between revisions of "FR:TheMagPiGit"

From eLinux.org
Jump to: navigation, search
(Tags)
 
(9 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
== Configuration de l'accès ==
 
== Configuration de l'accès ==
  
* The first step is to create a [https://github.com/ github] account. Then for those on the MagPi layout team, email the editor for permission to join the github organisation.
+
* La première étape consiste à créer un compte [https://github.com/ github]. Ensuite, pour ceux de l'équipe de mise en page du MagPi, envoyez un courriel à l'éditeur pour obtenir la permission de rejoindre l'organisation github.
 
 
* Since the Raspberry Pi does not have a great deal of processor power, it is better to use the command line tools to access github.  For OSX and Windows there are GUI tools available for download on the github site.
 
  
 +
* Comme le Raspberry Pi ne dispose pas d'une grande puissance processeur, il est préférable d'utiliser les outils en ligne de commande pour accéder à github. Des outils avec interface graphique pour OSX et Windows sont disponibles en téléchargement sur le site de github.
  
 
== Outils pour LINUX et OSX ==
 
== Outils pour LINUX et OSX ==
  
Several people would rather not read the [http://git-scm.com/book/en/ git book]. Therefore, some scripts were written to simplify the usage slightly. Git is not a replacement for good communication. Remember to update the local git repository before starting work on something and commit changes back to the repository frequently.
+
Peu de personnes souhaitent lire le [http://git-scm.com/book/en/ livre sur git]. Par conséquent, des scripts ont été écrits pour en simplifier un peu l'utilisation. Git ne remplace pas une bonne communication. Rappelez-vous d'actualiser le dépôt git local avant de commencer à travailler sur quelque chose et d'envoyer fréquemment les modifications vers le dépôt.
  
* Download [https://www.dropbox.com/s/xnra5lnw61wrm8r/mp-git-20130321.tar.gz mp-git-20130321.tar.gz] from the DropBox.
+
* Téléchargez le fichier [https://www.dropbox.com/s/xnra5lnw61wrm8r/mp-git-20130321.tar.gz mp-git-20130321.tar.gz] depuis DropBox.
* Unpack it,
+
* Décompressez-le :
 
<pre>
 
<pre>
 
tar xvfz mp-git-20130321.tar.gz
 
tar xvfz mp-git-20130321.tar.gz
 
</pre>
 
</pre>
* Install it,
+
* Installez-le,
 
<pre>
 
<pre>
 
cd mp-git
 
cd mp-git
 
source install.sh
 
source install.sh
 
</pre>
 
</pre>
* Then use the commands as needed. The commands are,
+
* Puis utilisez les commandes selon les besoins. En voici la liste :
  
 
==== mp-git-setup.sh ====
 
==== mp-git-setup.sh ====
  
Type
+
Tapez
 
<pre>
 
<pre>
 
mp-git-setup.sh  
 
mp-git-setup.sh  
 
</pre>
 
</pre>
to install and configure git. The script has no action if the installation and configuration is already okay.
+
pour installer et configurer git. Le script n'a aucune action si l'installation et la configuration sont déjà faites.
  
 
==== mp-git-clone.sh ====
 
==== mp-git-clone.sh ====
  
The script expects that the repositories will be in a parent directory called magpi-git. (This can be overridden by setting the environmental variable MP_GIT_DIR to the full path of the parent directory.) If the magpi-git directory does not already exist,
+
Le script s'attend à ce que les dépôts se trouvent dans un répertoire parent nommé magpi-git. (cela peut être modifié en spécifiant le chemin complet du répertoire parent avec la variable d'environnement MP_GIT_DIR.) Si ce répertoire magpi-git n'existe pas encore :
 
<pre>
 
<pre>
 
mkdir magpi-git; cd magpi-git
 
mkdir magpi-git; cd magpi-git
 
</pre>
 
</pre>
Then type
+
Tapez ensuite
 
<pre>
 
<pre>
 
mp-git-clone.sh 11
 
mp-git-clone.sh 11
 
</pre>
 
</pre>
to clone the issue 11 repository. The script will not clone the repository again if a local copy already exists in the present working directory. More than one repository can be requested at once. For example,
+
pour cloner le dépôt du numéro 11. Le script ne clonera pas d'autres fois le dépôt si une copie locale existe déjà dans le répertoire de travail courant. Il est possible de demander plusieurs dépôts en une seule fois. Par exemple :
 
<pre>
 
<pre>
 
mp-git-clone.sh 11 12 13 templates
 
mp-git-clone.sh 11 12 13 templates
 
</pre>
 
</pre>
will check out the issue 11, 12 and 13 repositories, as well as the templates repository.
+
récupérera les dépôts des numéros 11, 12 et 13, ainsi que ceux contenant les modèles.
  
 
==== mp-git-commit.sh ====
 
==== mp-git-commit.sh ====
  
Type
+
Tapez
 
<pre>
 
<pre>
mp-git-commit.sh 'A message goes here' [all]
+
mp-git-commit.sh 'Un message se trouve là' [all]
 
</pre>
 
</pre>
where the string 'A message goes here' should be replaced with a sensible and informative message and the text 'all' is optional. If all is used, all repositories within the mp-git/ parent directory are checked.
+
où la chaîne 'Un message se trouve là' devrait être remplacée par un message plus adapté et informatif et où le texte 'all' est facultatif. Si all est utilisé, tous les répertoires du répertoire parent mp-git/ seront vérifiés.
The script adds any new few files, commits to the local repository, fetches and remote changes and then merges the local changes into the remote repository. (Git does not allow empty directories to be added)
+
Le script ajoute tout nouveau fichier, fait un commit vers le dépôt local, récupère les modifications distantes et fusionne ensuite les modifications locales dans le dépôt distant. (Git ne permet pas d'ajouter des répertoires vides)
  
 
==== mp-git-update.sh ====
 
==== mp-git-update.sh ====
  
Type
+
Tapez
 
<pre>
 
<pre>
 
mp-git-update.sh [all]
 
mp-git-update.sh [all]
 
</pre>
 
</pre>
to update the local copy with any changes from the github repository, where 'all' is optional. If all is used, all repositories within the mp-git/ parent directory are checked.
+
pour mettre à jour la copie locale depuis le dépôt github, 'all' est facultatif. Si all est utilisé, tous les dépôts du répertoire parent mp-git/ seront vérifiés.
  
 
==== Utilisation d'un serveur mandataire ====
 
==== Utilisation d'un serveur mandataire ====
If you need to use a proxy:
+
Si vous devez utiliser un serveur mandataire :
  HTTP_PROXY="http://username:pwd@theproxyserver.com:port/"
+
  HTTP_PROXY="http://nomdutilisateur:mdp@leserveurmandataire.com:port/"
 
  git config --global http.proxy $HTTP_PROXY
 
  git config --global http.proxy $HTTP_PROXY
  
== Tagging ==
+
== Tags ==
  
While git tagging is not currently scripted, the git commands can be used to tag and push the tag back to the repository. There purpose of tagging is to keep track of a version of many files at one point in time. A good application would be to tag the repository once at the time of electronic publication and then once when printingThen one could refer to the printed version just by a tag, rather than risk some additional changes to the repository being included.
+
Les tags de git n'étant pas gérés par les scripts pour l'instant, les commandes git peuvent être utilisées pour créer des tags et les envoyer sur le dépôt. La finalité des tags est de garder la trace d'une version constituée de certains fichiers à un moment donné. Une bonne application serait de créer un tag dans le dépôt lors de chaque publication électronique et ensuite à chaque impressionEnsuite, il serait possible de faire référence à la version imprimée juste avec le tag, au lieu de risquer de faire d'autres modifications dans le dépôt.
  
The list of tags can be viewed by typing
+
La liste des tags peut être affichée en tapant
 
<pre>
 
<pre>
 
git tag
 
git tag
 
</pre>
 
</pre>
from within a mp-git/*/ directory.
+
en étant placé à l'intérieur d'un répertoire mp-git/*/.
  
A new tag can be added by
+
Un nouveau tag peut être ajouté avec
 
<pre>
 
<pre>
git tag -a magpi-templates-00-00-01 -m 'Tagging before overwriting current templates with templates which contain document bleeds'
+
git tag -a magpi-templates-00-00-01 -m 'Tag avant d'écraser les modèles actuels par ceux qui contiennent le fond perdu du document'
 
</pre>
 
</pre>
and all tags can be pushed back to the repository
+
et tous les tags peuvent être envoyés vers le dépôt
 
<pre>
 
<pre>
 
git push --tags
 
git push --tags
 
</pre>
 
</pre>
  
Tags are not pushed to the remote repository when mp-git-commit.sh is run, since the --tags flag is not included in the git push command inside that script.
+
Les tags ne sont pas envoyés vers le dépôt distant lorsque mp-git-commit.sh est exécuté car le paramètre --tags n'est pas présent dans la commande git push contenue dans ce script.

Latest revision as of 11:19, 11 May 2013

TheMagPi.png

Accueil Lecteurs Rédacteurs Bénévoles Partenaires Publicité Traductions



Configuration de l'accès

  • La première étape consiste à créer un compte github. Ensuite, pour ceux de l'équipe de mise en page du MagPi, envoyez un courriel à l'éditeur pour obtenir la permission de rejoindre l'organisation github.
  • Comme le Raspberry Pi ne dispose pas d'une grande puissance processeur, il est préférable d'utiliser les outils en ligne de commande pour accéder à github. Des outils avec interface graphique pour OSX et Windows sont disponibles en téléchargement sur le site de github.

Outils pour LINUX et OSX

Peu de personnes souhaitent lire le livre sur git. Par conséquent, des scripts ont été écrits pour en simplifier un peu l'utilisation. Git ne remplace pas une bonne communication. Rappelez-vous d'actualiser le dépôt git local avant de commencer à travailler sur quelque chose et d'envoyer fréquemment les modifications vers le dépôt.

tar xvfz mp-git-20130321.tar.gz
  • Installez-le,
cd mp-git
source install.sh
  • Puis utilisez les commandes selon les besoins. En voici la liste :

mp-git-setup.sh

Tapez

mp-git-setup.sh 

pour installer et configurer git. Le script n'a aucune action si l'installation et la configuration sont déjà faites.

mp-git-clone.sh

Le script s'attend à ce que les dépôts se trouvent dans un répertoire parent nommé magpi-git. (cela peut être modifié en spécifiant le chemin complet du répertoire parent avec la variable d'environnement MP_GIT_DIR.) Si ce répertoire magpi-git n'existe pas encore :

mkdir magpi-git; cd magpi-git

Tapez ensuite

mp-git-clone.sh 11

pour cloner le dépôt du numéro 11. Le script ne clonera pas d'autres fois le dépôt si une copie locale existe déjà dans le répertoire de travail courant. Il est possible de demander plusieurs dépôts en une seule fois. Par exemple :

mp-git-clone.sh 11 12 13 templates

récupérera les dépôts des numéros 11, 12 et 13, ainsi que ceux contenant les modèles.

mp-git-commit.sh

Tapez

mp-git-commit.sh 'Un message se trouve là' [all]

où la chaîne 'Un message se trouve là' devrait être remplacée par un message plus adapté et informatif et où le texte 'all' est facultatif. Si all est utilisé, tous les répertoires du répertoire parent mp-git/ seront vérifiés. Le script ajoute tout nouveau fichier, fait un commit vers le dépôt local, récupère les modifications distantes et fusionne ensuite les modifications locales dans le dépôt distant. (Git ne permet pas d'ajouter des répertoires vides)

mp-git-update.sh

Tapez

mp-git-update.sh [all]

pour mettre à jour la copie locale depuis le dépôt github, où 'all' est facultatif. Si all est utilisé, tous les dépôts du répertoire parent mp-git/ seront vérifiés.

Utilisation d'un serveur mandataire

Si vous devez utiliser un serveur mandataire :

HTTP_PROXY="http://nomdutilisateur:mdp@leserveurmandataire.com:port/"
git config --global http.proxy $HTTP_PROXY

Tags

Les tags de git n'étant pas gérés par les scripts pour l'instant, les commandes git peuvent être utilisées pour créer des tags et les envoyer sur le dépôt. La finalité des tags est de garder la trace d'une version constituée de certains fichiers à un moment donné. Une bonne application serait de créer un tag dans le dépôt lors de chaque publication électronique et ensuite à chaque impression. Ensuite, il serait possible de faire référence à la version imprimée juste avec le tag, au lieu de risquer de faire d'autres modifications dans le dépôt.

La liste des tags peut être affichée en tapant

git tag

en étant placé à l'intérieur d'un répertoire mp-git/*/.

Un nouveau tag peut être ajouté avec

git tag -a magpi-templates-00-00-01 -m 'Tag avant d'écraser les modèles actuels par ceux qui contiennent le fond perdu du document'

et tous les tags peuvent être envoyés vers le dépôt

git push --tags

Les tags ne sont pas envoyés vers le dépôt distant lorsque mp-git-commit.sh est exécuté car le paramètre --tags n'est pas présent dans la commande git push contenue dans ce script.