协作编辑LaTeX文档的提示 [英] Tips for collaboratively editing a LaTeX document

问题描述

我的默认设置是将tex源放在一个Subversion仓库中，并在对其他人的内容进行更改时将彼此之间的注释作为注释插入源中.一切都感觉不太理想，尤其是当存在颠覆冲突时，它告诉您这两个大段的这两个版本都在冲突".

My default setup is to put the tex source in a subversion repository and insert notes to each other as comments in the source when making changes to other people's content. It all feels pretty sub-optimal, especially when there are subversion conflicts where all it tells you is "these two versions of this huge paragraph are in conflict."

我想出了一些技巧，但是我确信那里有更好的主意(或者我的主意的更好的版本).

I've come up with a few tricks but I'm sure there are much better ideas (or better versions of my ideas) out there.

要在代码上进行协作，请参见以下问题:

For collaborating on code, see this question:

如何与其他编码人员实时协作?

(其中一些答案也将适用于LaTeX文档的协作.)

(Some of those answers will apply to collaboration on LaTeX documents as well.)

推荐答案

始终用换行符结束每个句子. 从不重新格式化段落.这些规则不仅可以最大程度地减少虚假冲突，还可以使您共同编辑的论文更易于修改.

Always end each sentence with a newline. Never reformat paragraphs. These rules not only minimize spurious conflicts but also make your collaboratively edited paper easier to revise.

对于作者评论，我使用边际评论:

For author commentary I use marginal comments:

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

之所以将它们放在页边距中，是因为我们经常将纸张准备为严格的长度限制，并且我们希望页边注解不改变纸张的长度.然后通过以下方式关闭边注

We put these in the margin because frequently we're preparing a paper to strict length limits, and we want the marginal notes not to change the length of the paper. Marginal notes are then turned off by

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

我还发明了 nbibtex 工具(现已在Debian中使用！)这样您就可以使用合著者使用的不同.bib文件，而无需就任意BibTeX密钥达成共识. nbibtex与BibTeX相似，不同之处在于它使用来自作者，标题和其他字段的关键字.每个作者的BibTeX文件可以不同，但​​是如果有该文件，则nbibtex会找到它.

I also invented the nbibtex tool (now in Debian!) so that you can use different .bib files from your coauthors without having to agree on arbitrary BibTeX keys. nbibtex works like BibTeX except that it uses key words from author, title and other fields. Each author's BibTeX file can be different, but if the paper is there, nbibtex will find it.

这篇关于协作编辑LaTeX文档的提示的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！