2009-02-12 10 views
9

Meine Standardkonfiguration besteht darin, die Tex-Quelle in ein Subversion-Repository einzufügen und Notizen als Kommentare in die Quelle einzufügen, wenn Änderungen an Inhalten anderer Personen vorgenommen werden. Es fühlt sich allesamt suboptimal an, besonders wenn es Subversionskonflikte gibt, bei denen alles sagt, dass "diese beiden Versionen dieses riesigen Absatzes in Konflikt stehen."Tipps zum gemeinsamen Bearbeiten eines LaTeX-Dokuments

Ich habe ein paar Tricks entwickelt, aber ich bin mir sicher, dass es viel bessere Ideen (oder bessere Versionen meiner Ideen) gibt.

Für auf Code zusammenarbeiten, sehen diese Frage: (. Einige dieser Antworten als auch für die Zusammenarbeit auf LaTeX-Dokumente gelten)

How do you collaborate with other coders in real time?

+0

Wichtigere Frage: Wie erhalten Sie Ihre Mitautoren, um Subversion zu verwenden? :) – ShreevatsaR

Antwort

11

Immer beenden Sie jeden Satz mit einem Zeilenumbruch. Nie Absätze neu formatieren. Diese Regeln minimieren nicht nur falsche Konflikte, sondern erleichtern auch die Überarbeitung von gemeinsam bearbeitetem Papier.

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 diese an den Rand setzen, weil häufig sind wir ein Papier strengen Längenbegrenzungen Vorbereitung, und wir wollen die Randbemerkungen nicht die Länge ändern das Papier. Randnotizen eingeschaltet sind dann durch

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

ich auch erfinden das nbibtex Werkzeug aus (jetzt in Debian!), So dass Sie verschiedene bib-Dateien von Ihren Koautoren, ohne zu vereinbaren beliebigem BibTeX Schlüssel verwenden können. nbibtex funktioniert wie BibTeX, außer dass es Schlüsselwörter aus Autor, Titel und anderen Feldern verwendet. Die BibTeX-Datei jedes Autors kann unterschiedlich sein, aber wenn das Papier da ist, wird nbibtex es finden.

+0

Smart! Danke Norman! Randkommentare sind eine gute Idee, obwohl sie manchmal zu voll werden können. Einen Schalter zu haben, um zwischen deinem und meinem Weg zu wechseln, könnte das Beste aus beiden Welten sein. Außerdem klingt nbibtex großartig. Ich freue mich darauf, das zu versuchen. Danke noch einmal! – dreeves

7

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

Was Kommentare zueinander in der Textquelle, finde ich es besser ist, die im PDF-Dokument erscheinen zu lassen, sondern haben die Fähigkeit, sie für die endgültige Version auszuschalten. Ich benutze dazu ein Makro "kibitz". 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 so lange Comments aufkreuzen wird auf 1 gesetzt .