不靠即時游標的共同寫作

修補檔、共用資料夾加 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 的衝突雖然看得懂,解決起來卻很繁瑣,所以最便宜的解法是靠人與人之間的溝通:一句簡短的訊息「我今天在改引言」,就能防止幾乎所有衝突。兩個寫作習慣能減少其餘的衝突。原始碼每一行只放一個句子,這樣對相鄰句子的平行編輯就完全不會碰撞;每次開始寫作之前,都先立刻拉取最新內容,確保你編輯的永遠是最新的文字。

返回 本機工作室