FR:TheMagPiGit

Accueil

Lecteurs

Rédacteurs

Bénévoles

Partenaires

Publicité

Traductions

• Guide de démarrage rapide - Un guide de démarrage rapide pour aider les nouveaux bénévoles à obtenir l'information dont ils ont besoin.
• Information pour les bénévoles - Un guide pour aider les bénévoles à se familiariser eux-mêmes avec le flux de travaux/outils de l'équipe.
• Information pour les rédacteurs - le processus pour soumettre un article.
• MMS MagPi - comment utiliser le MMS MagPi.
• GIT MagPi - comment utiliser les scripts GIT MagPi.
• Mise en page & polices - description de la mise en page standard et des polices associées.
• Création PDF - instructions pour la génération de PDF pour les publications électronique et papier.

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.

• Téléchargez le fichier mp-git-20130321.tar.gz depuis DropBox.
• Décompressez-le :

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

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,

mkdir magpi-git; cd magpi-git

Then type

mp-git-clone.sh 11

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,

mp-git-clone.sh 11 12 13 templates

will check out the issue 11, 12 and 13 repositories, as well as the templates repository.

mp-git-commit.sh

Type

mp-git-commit.sh 'A message goes here' [all]

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. 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)

mp-git-update.sh

Type

mp-git-update.sh [all]

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.

Utilisation d'un serveur mandataire

If you need to use a proxy:

HTTP_PROXY="http://username:pwd@theproxyserver.com:port/"
git config --global http.proxy $HTTP_PROXY

Tagging

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 printing. Then one could refer to the printed version just by a tag, rather than risk some additional changes to the repository being included.

The list of tags can be viewed by typing

git tag

from within a mp-git/*/ directory.

A new tag can be added by

git tag -a magpi-templates-00-00-01 -m 'Tagging before overwriting current templates with templates which contain document bleeds'

and all tags can be pushed back to the repository

git push --tags

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.