没有实时光标也能合著
补丁、共享文件夹加 Git,以及各自负责独立的章节文件。
没有实时光标也能合著
实时协同编辑,也就是看着合著者的光标移动,是云端编辑器兜售的模式。许多好论文并不靠它写成。当作者们在本地工作时,基于 Git 的异步协作是可靠的做法:每个人在自己的机器上编辑,改动是经过有意合并的,而不是逐字符地同步。它需要稍多一点的协调,回报则是可以离线工作、拥有完整的历史,并且不依赖任何人的服务器。
以 Git 为骨干
标准的做法是建一个共享仓库,通常放在 GitHub 上,所有人都从中拉取、向其推送。每位作者按工作段进行:拉取最新状态、写作、提交、推送。由于 LaTeX 是纯文本,Git 能自动合并对论文不同部分的并行改动,整个设置只需几分钟。把论文放到 GitHub 上一课讲了怎么做。如果有合作者不能或不愿使用 Git 托管服务,补丁就能填补这个空缺:git format-patch 把提交变成可以用邮件发送的小文件,收件人用 git am 应用它们,作者信息和历史都完整保留。这是一种古老的工作流,但只要能发邮件的地方,它就依然管用。
如果有合著者坚持使用同步文件夹,混合方案也行得通:为了方便,把共享的副本放在 Dropbox 或 Syncthing 中,但由一个人来维护 Git 历史并负责合并。不要让两个人正在使用的 Git 工作副本指向同一个同步文件夹,因为 .git 目录里的同步冲突会损坏仓库。
按文件划分文档
当大家很少改动同一个文件时,合并冲突就会变得罕见。把稿件拆开,让每一章或每一节各占一个文件,再由一个精简的 main.tex 用 \input{chapters/methods} 引入。具体做法见把文档拆分成多个文件。然后划分归属:每位合著者在自己的文件里起草,由一位整合者负责导言区、合并,以及最后通读一遍以检查记号和语气是否一致。这与软件团队避免互相踩脚的做法如出一辙,起作用的原因也相同。
实际会出什么问题
需要避免的失败模式,是两个人在同一时间段内编辑同一个段落。Git 会把它标记为冲突,而 LaTeX 的冲突虽然看得懂,解决起来却很繁琐,所以成本最低的办法是靠沟通:发一条简短的消息说“我今天在改引言”,就能避免几乎所有这类冲突。有两个写作习惯可以减少剩下的冲突。源码里保持每行一句,这样对相邻句子的并行修改就根本不会碰撞;并且在每次开始写作之前立刻拉取,这样你编辑的始终是最新的文本。