admin: notes et ajustements pour modules (1ae1e42) - processeur-decriture.git

README.md

@@ -4,7 +4,7 @@ Ce dépôt contient les sources du processeur d'écriture des documents de réda
 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
+# Approche par modules
 
 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.
@@ -22,6 +22,8 @@ Voir le Pro Git book pour de l'information sur les modules : https://git-scm.co
 - `$ git add src/<nom-du-module>`
 - `$ git commit -m "update <nom-du-module> submodule"`
 
+**Remarque :** ne pas oublier d'indiquer, dans `.gitmodules`, la branche voulue pour l'update.
+
 ## Partager les modifications locales du module vers le module à distance
 
 Info : https://stackoverflow.com/a/5814351/16839131
@@ -44,3 +46,14 @@ d'abord `$ git add your_submodule && git commit -m "Updated submodule`.
 Puis : `$ git push --recurse-submodules=on-demand`
 
 Pour aller plus loin : foreach, etc.
+
+## Note importante
+
+Le dépôt distant du module n'est pas *bare*.
+Il s'y trouve donc une copie de travail et le *push* sera refusé par le dépôt distant.
+
+Solutions possibles :
+https://www.slingacademy.com/article/solving-git-error-refusing-to-update-checked-out-branch/
+
+La tactique du forçage ne fonctionne pas dans ce cas (raison incconnue).
+L'échange d'information entre le module et le dépôt distant s'effectue donc par l'entremise d'une branche distincte de main, puis sur le dépôt il s'agit de rebaser sur main.
\ No newline at end of file


...	...	@@ -1,3 +1,4 @@
1	1	[submodule "src/proposition"]
2	2	path = src/proposition
3	3	url = /home/david/u/edr/redac/proposition/
	4	+ branch = main

...	...	@@ -4,7 +4,7 @@ Ce dépôt contient les sources du processeur d'écriture des documents de réda
4	4	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.
5	5	Plusieurs modifications y sont toutefois appliquées pour répondre à des besoins particuliers.
6	6
7		-# Approche
	7	+# Approche par modules
8	8
9	9	Tant les tâches de rédaction que les tâches de développement sont suivies avec Git.
10	10	Le dépôt applique un principe de séparation entre la production des contenus textuels et le développement technique du processeur.
...	...	@@ -22,6 +22,8 @@ Voir le Pro Git book pour de l'information sur les modules : https://git-scm.co
22	22	- `$ git add src/<nom-du-module>`
23	23	- `$ git commit -m "update <nom-du-module> submodule"`
24	24
	25	+Remarque : ne pas oublier d'indiquer, dans `.gitmodules`, la branche voulue pour l'update.
	26	+
25	27	## Partager les modifications locales du module vers le module à distance
26	28
27	29	Info : https://stackoverflow.com/a/5814351/16839131
...	...	@@ -44,3 +46,14 @@ d'abord `$ git add your_submodule && git commit -m "Updated submodule`.
44	46	Puis : `$ git push --recurse-submodules=on-demand`
45	47
46	48	Pour aller plus loin : foreach, etc.
	49	+
	50	+## Note importante
	51	+
	52	+Le dépôt distant du module n'est pas bare.
	53	+Il s'y trouve donc une copie de travail et le push sera refusé par le dépôt distant.
	54	+
	55	+Solutions possibles :
	56	+https://www.slingacademy.com/article/solving-git-error-refusing-to-update-checked-out-branch/
	57	+
	58	+La tactique du forçage ne fonctionne pas dans ce cas (raison incconnue).
	59	+L'échange d'information entre le module et le dépôt distant s'effectue donc par l'entremise d'une branche distincte de main, puis sur le dépôt il s'agit de rebaser sur main.
47	60	\ No newline at end of file
48	61