リアルタイムのカーソルなしで共著する

パッチ、共有フォルダと Git、章ごとのファイルの分担。

リアルタイムのカーソルなしで共著する

共著者のカーソルが動くのを見ながら行うリアルタイム共同編集は、クラウドエディタが売りにしているやり方です。それなしで書かれた良い論文もたくさんあります。各自のコンピュータで作業するときは、Git を土台にした非同期の共同作業が確実なパターンです。各自が自分のマシンで編集し、変更は 1 文字ずつではなく、意図して統合します。調整の手間は少し増えますが、その代わりにオフラインで作業でき、履歴がすべて残り、誰かのサーバーにも依存しません。

Git を土台にする

標準的な構成は共有リポジトリで、たいていは GitHub に置き、全員がそこから pull し、そこへ push します。各著者は作業単位で進めます。最新の状態を pull し、書き、コミットし、push します。LaTeX はプレーンテキストなので、論文の別々の部分に対する並行した変更は Git が自動で統合し、準備は数分で済みます。論文を GitHub に置くで説明しています。共著者の誰かが Git のホスティングを使えない、または使いたがらない場合は、パッチがそのすきまを埋めます。git format-patch はコミットをメールで送れる小さなファイルに変換し、受け取った側が git am で適用すれば、著者情報と履歴がそのまま保たれます。古いやり方ですが、メールが使える場所ならどこでも通用します。

共著者が同期フォルダを使うと言って譲らない場合は、ハイブリッドでも運用できます。共有コピーは便利さのために Dropbox か Syncthing に置きますが、Git の履歴の管理と統合は 1 人が担当します。2 人分の作業中の Git チェックアウトを、同じ同期フォルダに向けてはいけません。.git ディレクトリ内で同期の競合が起きると、リポジトリが壊れるからです。

ファイル単位で文書を分ける

同じファイルを触る人が少ないほど、統合が必要になる場面は減ります。原稿を分割し、各章や各節を独自のファイルに置いて、薄い main.tex から \input{chapters/methods} で取り込みます。仕組みは文書をファイルに分割するにあります。そのうえで担当を決めます。共著者はそれぞれ自分のファイルで下書きを書き、1 人の統合担当がプリアンブル、統合、そして記法と文体の一貫性を見る最終的な通読を受け持ちます。これはソフトウェアチームが互いの作業を踏まないようにしているやり方と同じで、同じ理由でうまくいきます。

実際にうまくいかなくなること

避けたいのは、2 人が同じ時間帯に同じ段落を編集することです。Git はそれをコンフリクトとして示しますが、LaTeX のコンフリクトは読めるものの解消が面倒なので、最も安上がりな対策は人どうしのやり取りです。「今日は導入を書いています」と一言連絡するだけで、ほとんど防げます。書き方の習慣を 2 つ守れば、残りも減らせます。ソースの 1 行に 1 文を書けば、隣り合う文への並行した編集がまったく衝突しません。そして、各執筆セッションの直前に pull して、常に最新のテキストを編集するようにします。

ローカルスタジオ に戻る