실시간 커서 없이 공저하기
패치, 공유 폴더와 Git, 그리고 장별 파일을 나눠 맡기.
실시간 커서 없이 공저하기
공저자의 커서가 움직이는 것을 지켜보는 실시간 공동 편집은 클라우드 편집기가 내세우는 방식입니다. 하지만 좋은 논문 중에는 그런 기능 없이 쓰인 것도 많습니다. 저자들이 로컬로 작업할 때는 Git 기반의 비동기 협업이 믿을 만한 방식입니다. 각자 자기 컴퓨터에서 편집하고, 변경 사항은 글자 단위가 아니라 의도적으로 병합합니다. 조율이 조금 더 필요하지만, 오프라인 작업, 전체 이력, 누구의 서버에도 의존하지 않는다는 점으로 보상받습니다.
Git이 중심축
표준적인 구성은 보통 GitHub에 있는 공유 저장소이며, 모두가 여기에서 pull하고 여기로 push합니다. 각 저자는 작업 세션 단위로 일합니다. 최신 상태를 pull하고, 글을 쓰고, commit하고, push합니다. LaTeX는 일반 텍스트이므로 Git은 논문의 서로 다른 부분에 대한 병렬 변경을 자동으로 병합하며, 설정은 몇 분이면 끝납니다. 이 내용은 GitHub에 논문 올리기에서 다룹니다. 공저자 한 명이 Git 호스트를 쓸 수 없거나 쓰지 않으려 할 때는 패치가 그 틈을 메웁니다. git format-patch는 commit을 이메일로 보낼 수 있는 작은 파일로 바꾸고, 받는 사람은 git am으로 적용해 작성자 정보와 이력을 그대로 보존합니다. 오래된 작업 방식이지만 이메일이 되는 곳이라면 어디서나 여전히 통합니다.
공저자가 동기화 폴더를 고집할 때는 혼합 방식도 가능합니다. 편의상 공유본은 Dropbox나 Syncthing에 두되, Git 이력 관리와 병합은 한 사람이 맡게 하세요. 두 사람이 사용 중인 Git 체크아웃을 같은 동기화 폴더에 두지 마세요. .git 디렉터리 안에서 동기화 충돌이 일어나면 저장소가 손상되기 때문입니다.
문서를 파일 단위로 나누기
사람들이 같은 파일을 거의 건드리지 않으면 충돌할 일도 드물어집니다. 원고를 나눠서 각 장이나 절이 자기 파일에 있게 하고, 얇은 main.tex에서 \input{chapters/methods}로 불러오세요. 구체적인 방법은 문서를 여러 파일로 나누기에 있습니다. 그다음 담당을 정합니다. 공저자는 각자 맡은 파일에서 초안을 쓰고, 통합 담당 한 사람이 프리앰블, 병합, 그리고 표기와 어조의 일관성을 확인하는 최종 검토를 맡습니다. 이는 소프트웨어 팀이 서로 방해하지 않도록 일하는 방식과 같고, 같은 이유로 효과가 있습니다.
실제로 무엇이 잘못되는가
피해야 할 실패 유형은 두 사람이 같은 시간대에 같은 문단을 편집하는 것입니다. Git은 이를 충돌로 표시하는데, LaTeX 충돌은 읽을 수는 있어도 해결하기가 번거롭습니다. 그래서 가장 싼 해법은 사람 사이의 소통입니다. “오늘은 제가 서론을 작업하고 있습니다”라고 짧게 알리면 거의 모든 충돌을 막을 수 있습니다. 두 가지 글쓰기 습관이 나머지를 줄여 줍니다. 소스 한 줄에 한 문장만 쓰면 이웃한 문장을 동시에 고쳐도 아예 부딪히지 않고, 글쓰기 세션을 시작하기 직전에 pull하면 항상 최신 텍스트를 편집하게 됩니다.