Đưa bài báo lên GitHub
Khởi tạo, bỏ qua tệp aux, kho riêng tư, và những thói quen giúp việc gộp bản sửa của đồng tác giả không rối.
Đưa bài báo lên GitHub
Bản thảo LaTeX là văn bản thuần, nên rất hợp với Git. Mỗi bản nháp trở thành một commit mà bạn có thể quay lại, mỗi thay đổi hiện ra dưới dạng diff theo từng dòng, và GitHub cho bạn một bản sao lưu bên ngoài máy cùng cách để đồng tác giả kéo trạng thái hiện tại về. Không điều nào trong số này đòi hỏi Git nâng cao. Một bài báo có lẽ chỉ cần khoảng năm lệnh, dùng đều đặn.
Thiết lập ban đầu
git init# add a .gitignore for *.aux *.log *.out *.toc *.synctex.gzgit add main.tex refs.bib figures/git commit -m "Initial manuscript"gh repo create my-paper --private --source=. --pushChạy một lần trong thư mục dự án. Bước .gitignore quan trọng hơn vẻ ngoài của nó. Mỗi lần biên dịch đều tạo lại các tệp .aux, .log, .out, .toc và .synctex.gz, và việc commit chúng sẽ chôn vùi những thay đổi thật của bạn dưới đống rác do máy sinh ra, đồng thời gây ra các xung đột gộp vô nghĩa giữa các đồng tác giả. Chỉ theo dõi những gì do bạn viết: mã nguồn .tex, cơ sở dữ liệu .bib, các hình, và mọi tệp class hay style mà hội nghị hoặc tạp chí cung cấp. Tệp PDF cũng là sản phẩm của quá trình dựng. Hầu hết các nhóm bỏ nó ra ngoài và dựng lại trên máy, dù đính kèm một bản vào bản phát hành có gắn tag là cách hợp lý để cố định phiên bản đã nộp. Hãy để kho ở chế độ riêng tư cho đến khi công trình được công bố. Một bản thảo chưa xuất bản không phải thứ để người ta lập chỉ mục.
Thói quen giúp đồng tác giả đỡ khổ
Hãy làm mỗi commit là một thay đổi hợp lý, chẳng hạn “sửa phần mở đầu mục 3” hoặc “thêm bảng ablation”. Khi đó lịch sử đọc như câu chuyện của bài báo, và một chỉnh sửa tệ có thể được hoàn lại mà không kéo theo thiệt hại khác. Hãy pull trước khi bắt đầu buổi viết và push khi dừng. Xung đột gộp tăng theo thời gian các nhánh tách rời nhau. Đừng bao giờ force-push một nhánh dùng chung sau khi đồng tác giả đã pull nó: làm vậy viết lại lịch sử ngay dưới chân họ. Hãy giữ các tệp nhị phân lớn (bộ dữ liệu, video) ngoài kho của bài báo. Hãy liên kết đến một kho lưu trữ hoặc dùng một kho dữ liệu riêng. Git lưu mọi phiên bản của mọi tệp nhị phân mãi mãi.
Một thói quen riêng của LaTeX: viết mỗi câu trên một dòng mã nguồn giúp diff dễ đọc hơn hẳn, vì sửa một từ chỉ hiện thành thay đổi một dòng thay vì cả đoạn văn bị dàn lại.
Oleafly nằm ở đâu
Mỗi dự án Oleafly là một thư mục bình thường trên đĩa, nên các lệnh này dùng được nguyên xi. Oleafly giữ các bản dựng thành công đủ điều kiện có mã nguồn thay đổi trong Saved Checkpoints, tách biệt với Git. Hãy tạo commit có chủ đích trong Source Control, rồi push hoặc pull cùng cộng sự của bạn. Xem lịch sử Git. Về các cách cộng tác xây dựng trên nền này, gồm trao đổi bản vá và phân công quyền sở hữu từng chương, xem Đồng tác giả khi không có con trỏ trực tiếp.