Tipps für kollaborativ Bearbeiten eines LaTeX-Dokument

Question

Mein Standard-Setup ist die tex Quelle in einer Subversion-Repository setzen und Notizen einzufügen zueinander als Kommentare in der Quelle, wenn Änderungen an den Inhalte anderer Personen zu machen. Es fühlt sich alles ziemlich suboptimal, vor allem wenn es Subversion Konflikte sind, wo alle es sagt Ihnen, ist „diese beiden Versionen dieses großen Absatz in Konflikt.“

Ich habe mit ein paar Tricks kommen, aber ich bin sicher, es gibt viel bessere Ideen (oder besser Versionen meiner Ideen) da draußen.

auf Code zusammenarbeiten, finden Sie diese Frage:

Wie ist die Zusammenarbeit mit anderen Coder in Echtzeit?

(Einige dieser Antworten auf die Zusammenarbeit auf LaTeX-Dokumenten als auch gelten.)

Answer 1

immer jeden Satz mit einem Newline beenden. Nie umformatieren Absätze. Diese Regeln nicht nur störende Konflikte minimieren, sondern auch Ihre kollaborativ bearbeitet Papier leichter zu revidieren.

Für Autor Kommentar verwende ich Randbemerkungen:

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

Wir setzen diese in der Marge, weil häufig sind wir ein Papier strenge Längenbegrenzungen Vorbereitung, und wir wollen die Randbemerkungen nicht die Länge des Papiers zu ändern. Glossen ausgeschaltet dann durch

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

Ich erfand auch die nbibtex Tool (jetzt in Debian!), So dass können Sie verschiedene bib-Dateien von Ihren Koautoren verwenden, ohne auf beliebigem BibTeX Schlüssel zu vereinbaren ist. nbibtex funktioniert wie BibTeX, außer dass es nutzt Schlüsselwörter von Autor, Titel und anderen Bereichen. Jeder BibTeX Datei des Autors kann unterschiedlich sein, aber wenn das Papier ist, nbibtex wird es finden.

Answer 2

Um das Problem der nicht hilfreich Subversion Konflikte zu mildern, können Sie die Konvention von Zeilenumbrüchen am Ende der Sätze übernehmen. (Dies macht es auch einfacher, neu anordnen oder aus kommentieren oder einen Kommentar auf , Sätze).

Wie für Kommentare zueinander in der Textquelle, finde ich es besser ist, die im PDF-Dokument erscheinen zu lassen, sondern haben die Möglichkeit, sie für die endgültige Version auszuschalten. Ich benutze einen Makro „kibitz“ dafür. Um es zu nutzen, legen Sie die folgenden am oberen Rand des Dokuments:

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

Dann Alice zum Beispiel kann nur so etwas wie \alice{Bob must've added the previous sentence which is obviously false.} halten und es wird in rot im pdf zeigen, wie lange Comments auf 1 gesetzt ist.