From 3ca2e2c0ec37f510c87a47ebb56eae728cd2ff27 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 2 Mar 2019 22:10:43 +0000 Subject: formation-latex-ul (2mar19) git-svn-id: svn://tug.org/texlive/trunk@50205 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/formation-latex-ul/CONTRIBUTING.md | 47 ++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/formation-latex-ul/CONTRIBUTING.md (limited to 'Master/texmf-dist/doc/latex/formation-latex-ul/CONTRIBUTING.md') diff --git a/Master/texmf-dist/doc/latex/formation-latex-ul/CONTRIBUTING.md b/Master/texmf-dist/doc/latex/formation-latex-ul/CONTRIBUTING.md new file mode 100644 index 00000000000..65baca10ac5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/formation-latex-ul/CONTRIBUTING.md @@ -0,0 +1,47 @@ + + +# Collaborer au projet *Rédaction avec LaTeX* + +Le projet [Rédaction avec LaTeX](https://vigou3.gitlab.io/formation-latex-ul) est hébergé dans un [dépôt public GitLab](https://gitlab.com/vigou3/formation-latex-ul). + +La branche `master` du dépôt est réservée en écriture au gestionnaire du projet. + +Pour collaborer au projet, vous devez publier vos modifications dans une nouvelle branche et effectuer une demande de tirage (*pull request*) vers la branche `master`. La procédure à suivre à partir d'une interface en invite de commande (Git Bash sous Windows ou Terminal sous macOS) est la suivante. + +1. Si vous travaillez sur le code source pour la première fois, déplacez-vous avec la commande `cd` dans le répertoire dans lequel vous voulez enregistrer le code source du projet (le répertoire `formation-latex-ul` sera créé automatiquement), clonez le dépôt et déplacez-vous ensuite dans le dossier du code source. + +``` +git clone https://gitlab.com/vigou3/formation-latex-ul.git +cd formation-latex-ul +``` + +**OU** + +1. Si vous avez déjà cloné le dépôt dans le passé et que vous voulez reprendre le travail sur le code source, déplacez-vous avec la commande `cd` dans le répertoire du code source, puis mettez à jour votre copie locale du dépôt depuis la branche `master`. + +``` +git checkout master +git pull +``` + +2. Créez une branche (locale) pour vos modifications. + +``` +git checkout -b +``` + +3. Effectuez maintenant vos modifications. Il y a un fichier par chapitre et son nom, avec une extension `.tex`, a un lien évident avec le titre du chapitre. N'effectuez des modifications que dans un seul fichier à la fois! Lorsque les modifications sont terminées, publiez le fichier modifié dans votre dépôt local avec un commentaire utile, mais bref, sur la nature des modifications. + +``` +git status +git add +git commit -m "" +``` + +4. Créez un compte dans GitLab si vous n'en avez pas déjà un. Publiez ensuite la branche avec les modifications dans le dépôt GitLab. + +``` +git push -u origin +``` + +5. Finalement, [connectez-vous](https://gitlab.com/users/sign_in) à l'interface graphique de GitLab et effectuez une demande de fusion (*Merge Request*) vers la branche `master` en sélectionnant l'option correspondante dans la barre latérale. -- cgit v1.2.3