svn - Consejos para editar colaborativamente un documento LaTeX

collaboration writing

Question

Mi configuración predeterminada es poner el origen de tex en un repositorio de subversión e insertar notas entre sí como comentarios en la fuente al hacer cambios en el contenido de otras personas. Todo parece bastante poco óptimo, especialmente cuando hay conflictos de subversión en los que todo lo que dice es "estas dos versiones de este gran párrafo están en conflicto".

He descubierto algunos trucos, pero estoy seguro de que hay ideas mucho mejores (o mejores versiones de mis ideas) que existen.

Para colaborar en el código, vea esta pregunta:

¿Cómo colaboras con otros programadores en tiempo real?

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

Answer 1

Para mitigar el problema de los conflictos de subversión inútiles, puede adoptar la convención de nuevas líneas al final de las oraciones. (Esto también hace que sea más fácil reorganizar o comentar, o comentar, oraciones).

En cuanto a los comentarios entre sí en la fuente de texto, creo que es mejor hacer que aparezcan en el documento pdf, pero tienen la capacidad de desactivarlos para la versión final. Yo uso una macro " kibitz " para eso. Para usarlo, ponga lo 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]}}

Luego, Alicia, por ejemplo, puede poner algo así como /alice{Bob must''ve added the previous sentence which is obviously false.} Y se mostrará en rojo en el pdf, siempre y cuando los Comments se establezcan en 1.

Answer 2

Siempre termine cada oración con una nueva línea. Nunca vuelva a formatear los párrafos. Estas reglas no solo minimizan los conflictos espurios sino que también hacen que su documento editado colaborativamente sea más fácil de revisar.

Para el comentario del autor uso 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 estamos preparando un documento con límites de longitud estrictos, y queremos que las notas marginales no cambien la longitud del papel. Las notas marginales son desactivadas por

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

También inventé la herramienta nbibtex (ahora en Debian!) Para que pueda usar diferentes archivos .bib de sus coautores sin tener que ponerse de acuerdo sobre las claves arbitrarias BibTeX. nbibtex funciona como BibTeX, excepto que utiliza palabras clave de autor, título y otros campos. El archivo BibTeX de cada autor puede ser diferente, pero si el documento está allí, nbibtex lo encontrará.