Difference between revisions of "FR:TheMagPiGit"

From eLinux.org
Jump to: navigation, search
(mp-git-clone.sh)
(Tags)
 
(3 intermediate revisions by the same user not shown)
Line 35: Line 35:
 
==== mp-git-clone.sh ====
 
==== 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.) 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 ====
Line 71: Line 71:
 
  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.