Coécrire sans curseur en direct

Patchs, dossiers partagés avec Git, et un fichier de chapitre par personne.

Coécrire sans curseur en direct

L’édition collaborative en temps réel, où l’on regarde le curseur d’un coauteur se déplacer, est le modèle que vendent les éditeurs dans le cloud. De nombreux bons articles s’écrivent sans elle. Quand les auteurs travaillent en local, la collaboration asynchrone fondée sur Git est le schéma fiable : chacun édite sur sa propre machine, et les changements sont fusionnés de façon délibérée plutôt que caractère par caractère. Elle demande un peu plus de coordination et la rembourse par le travail hors ligne, un historique complet et l’absence de dépendance au serveur de quelqu’un.

Git comme colonne vertébrale

La configuration standard est un dépôt partagé, généralement sur GitHub, dont tout le monde récupère les changements et vers lequel tout le monde pousse les siens. Chaque auteur travaille par sessions : récupérer l’état le plus récent, écrire, valider, pousser. Comme LaTeX est du texte brut, Git fusionne automatiquement les modifications parallèles apportées à des parties différentes de l’article, et la mise en place prend quelques minutes. Mettre l’article sur GitHub l’explique. Quand un collaborateur ne peut pas ou ne veut pas utiliser un hébergeur Git, les patchs comblent le vide : git format-patch transforme des commits en petits fichiers que vous pouvez envoyer par e-mail, et le destinataire les applique avec git am, ce qui conserve intacts l’auteur et l’historique. C’est un vieux flux de travail, et il fonctionne encore partout où le courrier électronique fonctionne.

Un mode hybride marche aussi quand un coauteur tient à un dossier synchronisé : gardez la copie partagée dans Dropbox ou Syncthing par commodité, mais laissez une seule personne tenir l’historique Git et effectuer les fusions. Ne faites pas pointer les copies de travail Git actives de deux personnes vers le même dossier synchronisé, car les conflits de synchronisation à l’intérieur du répertoire .git corrompent les dépôts.

Découper le document par fichier

Les fusions deviennent rares quand les gens touchent rarement au même fichier. Découpez le manuscrit de sorte que chaque chapitre ou section vive dans son propre fichier, appelé depuis un main.tex léger avec \input{chapters/methods}. La mécanique est décrite dans Découper un document en fichiers. Attribuez ensuite la responsabilité de chaque fichier : chaque coauteur rédige dans les siens, et un intégrateur s’occupe du préambule, de la fusion et de la relecture finale pour la cohérence des notations et du ton. Cela reproduit la façon dont les équipes de développement logiciel évitent de se marcher sur les pieds, et cela fonctionne pour les mêmes raisons.

Ce qui tourne vraiment mal

Le cas à éviter est celui où deux personnes modifient le même paragraphe dans la même période. Git le signalera comme un conflit, et les conflits LaTeX sont lisibles mais fastidieux à résoudre, donc la solution la moins chère est sociale : un message rapide disant « Je suis dans l’introduction aujourd’hui » en évite presque tous. Deux habitudes d’écriture réduisent le reste. Gardez une phrase par ligne de code source, pour que des modifications parallèles de phrases voisines n’entrent pas du tout en collision, et récupérez les changements juste avant chaque session d’écriture, pour toujours éditer le texte le plus récent.

Retour à L'atelier local