Mẹo để chỉnh sửa cộng tác tài liệu LaTeX

Question

Thiết lập mặc định của tôi là đặt nguồn tex vào một kho lưu trữ subversion và chèn ghi chú với nhau dưới dạng nhận xét trong nguồn khi thực hiện thay đổi đối với nội dung của người khác. Tất cả đều cảm thấy khá phụ tối ưu, đặc biệt là khi có xung đột lật đổ nơi mà tất cả nó nói với bạn là "hai phiên bản của đoạn văn lớn này đang xung đột."

Tôi đã đưa ra một vài thủ thuật nhưng tôi chắc chắn có nhiều ý tưởng hay hơn (hoặc các phiên bản tốt hơn về ý tưởng của tôi) ngoài đó.

Đối với hợp tác trên mã, xem câu hỏi này: (. Một số trong những câu trả lời sẽ áp dụng đối với hợp tác trên các tài liệu LaTeX cũng)

How do you collaborate with other coders in real time?

Answer 1

Luôn luôn kết thúc mỗi câu bằng một dòng mới. Không bao giờ đoạn định dạng lại. Những quy tắc này không chỉ giảm thiểu xung đột giả mạo mà còn làm cho giấy chỉnh sửa cộng tác của bạn dễ dàng sửa đổi hơn.

Đối với bình luận tác giả tôi sử dụng ý kiến ​​bên lề:

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

Chúng tôi đặt những ở bên lề vì thường xuyên, chúng tôi đang chuẩn bị một bài báo để giới hạn chiều dài nghiêm ngặt, và chúng tôi muốn các ghi chú bên lề không thay đổi chiều dài của giấy. ghi chú bên lề sau đó được tắt theo

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

Tôi cũng đã phát minh ra công cụ nbibtex (Debian giờ có!) để bạn có thể sử dụng file .bib khác biệt so với các đồng tác giả của bạn mà không cần phải thỏa thuận về phím BibTeX tùy ý. nbibtex hoạt động như BibTeX ngoại trừ việc nó sử dụng các từ khóa từ tác giả, tiêu đề và các trường khác. Mỗi tập tin BibTeX của mỗi tác giả có thể khác nhau, nhưng nếu giấy ở đó, nbibtex sẽ tìm thấy nó.

Answer 2

Để giảm thiểu các vấn đề mâu thuẫn lật đổ vô ích , bạn có thể áp dụng quy ước của dòng mới vào cuối câu. (Điều này cũng giúp bạn sắp xếp lại hoặc nhận xét dễ dàng hơn hoặc nhận xét trên, câu.)

Đối với nhận xét với nhau trong nguồn văn bản, tôi thấy tốt hơn là làm cho những nhận xét đó xuất hiện trong tài liệu pdf nhưng có khả năng tắt chúng cho phiên bản cuối cùng. Tôi sử dụng macro "kibitz" cho điều đó. Để sử dụng nó, đặt sau ở phía trên cùng của tài liệu:

\newcount\Comments % 0 suppresses notes to selves in text 
\Comments=1 % TODO: set to 0 for final version 

\documentclass{article} % or whatever your documentclass 

% for comments 
\usepackage{color} 
\definecolor{darkgreen}{rgb}{0,0.5,0} 
\definecolor{purple}{rgb}{1,0,1} 
% \kibitz{color}{comment} inserts a colored comment in the text 
\newcommand{\kibitz}[2]{\ifnum\Comments=1\textcolor{#1}{#2}\fi} 
% add yourself here: 
\newcommand{\alice}[1]{\kibitz{red}  {[ALC: #1]}} 
\newcommand{\bob}[1] {\kibitz{purple} {[BOB: #1]}} 
\newcommand{\carol}[1]{\kibitz{cyan}  {[CAR: #1]}} 
\newcommand{\deb}[1] {\kibitz{darkgreen}{[DEB: #1]}} 
\newcommand{\evan}[1] {\kibitz{blue}  {[EVN: #1]}} 

Sau đó Alice, ví dụ, có thể chỉ cần dính vào một cái gì đó giống như \alice{Bob must've added the previous sentence which is obviously false.} và nó sẽ hiển thị trong màu đỏ trong pdf miễn Comments được thiết lập để 1 .