Astuces pour éditer en collaboration un document LaTeX

Question

Ma configuration par défaut consiste à placer la source tex dans un référentiel subversion et à insérer des notes les unes aux autres en tant que commentaires dans la source lorsque des modifications sont apportées au contenu d'autres personnes. Tout cela est plutôt sous-optimal, surtout quand il y a des conflits de subversion où tout ce qu'il vous dit est "ces deux versions de cet énorme paragraphe sont en conflit".

J'ai trouvé quelques astuces mais je suis sûr qu'il y a de bien meilleures idées (ou de meilleures versions de mes idées) là-bas.

Pour la collaboration sur le code, voir la question suivante: (. Certaines de ces réponses s'appliqueront à la collaboration sur des documents LaTeX ainsi)

How do you collaborate with other coders in real time?

Answer 1

Toujours terminez chaque phrase par un saut de ligne. Jamais reformater paragraphes. Ces règles non seulement minimisent les conflits non justifiés, mais facilitent également la révision de votre document en collaboration.

Pour le commentaire de l'auteur utiliser les commentaires marginaux:

\long\def\authornote#1{% 
     \leavevmode\unskip\raisebox{-3.5pt}{\rlap{$\scriptstyle\diamond$}}% 
     \marginpar{\raggedright\hbadness=10000 
     \def\baselinestretch{0.8}\tiny 
     \it #1\par}} 
\newcommand{\simon}[1]{\authornote{SLPJ: #1}} 
\newcommand{\norman}[1]{\authornote{NR: #1}} 
\newcommand{\john}[1]{\authornote{JD: #1}} 

Nous les mettons dans la marge, car souvent nous préparons un document à des limites de longueur strictes, et nous voulons que les notes marginales de ne pas changer la longueur le papier. Les notes marginales sont alors désactivées par

\long\def\authornote#1{\relax} 

J'ai aussi inventé l'outil nbibtex (maintenant dans Debian!) de sorte que vous pouvez utiliser différents fichiers .bib de vos co-auteurs, sans avoir à se mettre d'accord sur les touches de BibTeX arbitraires. nbibtex fonctionne comme BibTeX, sauf qu'il utilise des mots clés de l'auteur, le titre et d'autres domaines. Le fichier BibTeX de chaque auteur peut être différent, mais si le papier est présent, nbibtex le trouvera.

Answer 2

Pour atténuer le problème des conflits de subversion inutiles , vous pouvez adopter la convention de newlines à la fin des phrases. En ce qui concerne les commentaires entre eux dans la source de texte, je trouve qu'il est préférable de les faire apparaître dans le document pdf, mais j'ai des la possibilité de les désactiver pour la version finale. J'utilise une macro "kibitz" pour cela. Pour l'utiliser, placez le suivant en haut du document:

\newcount\Comments % 0 suppresses notes to selves in text 
\Comments=1 % TODO: set to 0 for final version 

\documentclass{article} % or whatever your documentclass 

% for comments 
\usepackage{color} 
\definecolor{darkgreen}{rgb}{0,0.5,0} 
\definecolor{purple}{rgb}{1,0,1} 
% \kibitz{color}{comment} inserts a colored comment in the text 
\newcommand{\kibitz}[2]{\ifnum\Comments=1\textcolor{#1}{#2}\fi} 
% add yourself here: 
\newcommand{\alice}[1]{\kibitz{red}  {[ALC: #1]}} 
\newcommand{\bob}[1] {\kibitz{purple} {[BOB: #1]}} 
\newcommand{\carol}[1]{\kibitz{cyan}  {[CAR: #1]}} 
\newcommand{\deb}[1] {\kibitz{darkgreen}{[DEB: #1]}} 
\newcommand{\evan}[1] {\kibitz{blue}  {[EVN: #1]}} 

Alors Alice, par exemple, peut juste coller quelque chose comme \alice{Bob must've added the previous sentence which is obviously false.} et il sera affiché en rouge dans le pdf tant Comments est réglé sur 1