Sugerencias para editar conjuntamente un documento LaTeX

Question

Mi configuración por defecto es poner la fuente tex en un repositorio de subversión e insertar notas el uno al otro como comentarios en la fuente al realizar cambios en el contenido de otras personas. Todo se siente muy inferior al óptimo, sobre todo cuando hay conflictos de subversión, donde todo lo que se le dice que es "estas dos versiones de este enorme párrafo están en conflicto."

Yo he llegado con algunos trucos, pero estoy seguro de que hay mucho mejores ideas (o mejores versiones de mis ideas) por ahí.

Para colaborar en código, consulte esta pregunta:

¿Cómo colabora con otros codificadores en tiempo real?

(Algunas de esas respuestas se aplicará a la colaboración en documentos LaTeX también.)

Answer 1

Siempre FIN cada frase con un salto de línea. No volver a formatear párrafos. Estas reglas no sólo minimizan los conflictos espurios, sino también hacer que su papel en colaboración editado más fácil de revisar.

Para el autor comentario utilizan los comentarios marginales:

\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}}

Ponemos estos en el margen porque con frecuencia nos estamos preparando un documento a estrictos límites de longitud, y queremos que las notas marginales de no cambiar la longitud del papel. Las notas marginales son luego desactivado por

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

También inventé el href="http://www.cs.tufts.edu/~nr/nbibtex/" rel="noreferrer"> nbibtex herramienta (ahora en Debian!) Para que se pueden utilizar diferentes archivos .bib de sus coautores, sin tener que ponerse de acuerdo sobre claves BibTeX arbitrarias. nbibtex funciona como BibTeX excepto que utiliza palabras clave de autor, título y otros campos. archivo de BibTeX de cada autor puede ser diferente, pero si el papel está ahí, nbibtex la encontrará.

Answer 2

Para mitigar el problema de la subversión conflictos inútiles, puede adoptar la convención de saltos de línea al final de las oraciones. (Esto también hace que sea más fácil para reorganizar o comente, o comentario en , frases.)

En cuanto a los comentarios entre sí en la fuente de texto, me parece que es mejor hacer que los que aparecen en el documento PDF, sino que tenga la capacidad de apagarlos para la versión final. Yo uso una macro "kibitz" para eso. Para usarlo, poner el siguiente en la parte superior del documento:

\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]}}

A continuación, Alice, por ejemplo, solo puede pegar algo así como \alice{Bob must've added the previous sentence which is obviously false.} y se mostrará en rojo en el pdf, siempre Comments se establece en 1.