Dicas para colaborativamente editando um documento LaTeX

Question

Minha configuração padrão é colocar a fonte tex em um repositório Subversion e inserir notas uns aos outros como comentários na fonte ao fazer alterações no conteúdo de outras pessoas. Tudo se sente muito aquém do ideal, especialmente quando há conflitos de subversão, onde tudo o que diz é "estas duas versões deste enorme parágrafo estão em conflito."

Eu vim com alguns truques, mas tenho certeza há muito melhores ideias (ou versões melhores de minhas idéias) lá fora.

Para colaborar em código, consulte esta pergunta:

Como você colaborar com outros programadores em tempo real?

(Algumas dessas respostas serão aplicadas a colaboração em documentos LaTeX também.)

Answer 1

Sempre terminar cada frase com uma nova linha. Nunca parágrafos reformatação. Estas regras não só minimizar conflitos espúrias, mas também fazer o seu papel editado colaborativamente mais fácil de rever.

Para comentários autor que eu use os comentários marginais:

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

Nós colocar estes na margem porque muitas vezes estamos a preparar um documento para limites de comprimento estritas, e queremos que as notas marginais não alterar o comprimento do papel. notas marginais são então desligados por

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

Eu também inventou o href="http://www.cs.tufts.edu/~nr/nbibtex/" rel="noreferrer"> ferramenta nbibtex (agora em Debian!) Para que você pode usar diferentes arquivos .bib de seus co-autores, sem ter que concordar com chaves BibTeX arbitrárias. nbibtex funciona como BibTeX exceto que ele usa palavras-chave do autor, título e outros campos. arquivo BibTeX Cada autor pode ser diferente, mas se o papel está lá, nbibtex vai encontrá-lo.

Answer 2

Para atenuar o problema dos conflitos de subversão inúteis, você pode adotar a convenção de novas linhas no final de frases. (Isso também torna mais fácil para reorganizar ou comentar, ou um comentário em , frases.)

Como para comentários para o outro na fonte de texto, eu acho que é melhor fazer as aparecem no documento pdf, mas têm a capacidade de desligá-los para a versão final. Eu uso uma macro "kibitz" para isso. Para usá-lo, coloque o seguinte no topo do 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]}}

Em seguida, Alice, por exemplo, pode se ater apenas algo como \alice{Bob must've added the previous sentence which is obviously false.} e ele vai aparecer em vermelho no pdf desde Comments é definido como 1.