README.md (950033c) - processeur-decriture.git

README.md

# Introduction

Ce dépôt contient les sources du processeur d'écriture des documents de rédaction scientifique de David Valentine.
L'architecture globale est basée sur celle de [https://git.loupbrun.ca/louis/lobrassard-net/](loupbrun), qui a l'immense gentillesse de partager son installation sous la licence CC-BY.
Plusieurs modifications y sont toutefois appliquées pour répondre à des besoins particuliers.

# Approche

Tant les tâches de rédaction que les tâches de développement sont suivies avec Git.
Le dépôt applique un principe de séparation entre la production des contenus textuels et le développement technique du processeur.
Les tâches de développement sont validées (commited) directement dans ce dépôt, tandis que l'historique de la rédaction évolue dans un système de modules prévu à cet effet.

Voir le Pro Git book pour de l'information sur les modules : https://git-scm.com/book/en/v2/Git-Tools-Submodules

## Ajouter un sous-module

- `$ git submodule add <chemin-vers-le-module> src/<nom-du-module>`

## Mettre à jour un sous-module localement (modifié à distance)

- `$ git submodule update --remote src/<nom-du-module>` ou fetch and merge manuel dans le module
- `$ git add src/<nom-du-module>`
- `$ git commit -m "update <nom-du-module> submodule"`

## Partager les modifications locales du module vers le module à distance

Info : https://stackoverflow.com/a/5814351/16839131

```bash
$ cd your_submodule
$ git checkout main
<hack,edit>
$ git commit ...
```

Pour merger avec les validations distantes :
après avoir checked out sur une branche du module (déjà fait supposément selon l'étape précédente), il faut `$ cd ../../ && git submodule update --remote --rebase` (ou merge).

Enfin, on peut `git push` directement dans le module pour partager le merge.

Sinon, on peut push en même temps que le dépôt principal :
d'abord `$ git add your_submodule && git commit -m "Updated submodule`.

Puis : `$ git push --recurse-submodules=on-demand`

Pour aller plus loin : foreach, etc.

processeur-decriture.git

README ajout info supplémentaire pour git submodules