Sao lưu Zotero lên GitHub (dành cho người mới, dùng GitHub Desktop trên Windows)

Tóm tắt nhanh

• Bạn cần: Tài khoản GitHub, GitHub Desktop, Zotero đã cài trên Windows.
• Ý tưởng: Dùng GitHub để lưu thư mục Zotero của bạn (cả dữ liệu và tệp đính kèm) như một bản sao lưu có lịch sử.
• Lưu ý quan trọng: Luôn đóng Zotero trước khi sao lưu hoặc khôi phục để tránh lỗi khóa tệp cơ sở dữ liệu.

---

1) Chuẩn bị

• Tạo tài khoản GitHub nếu chưa có: https://github.com/join
• Tải và cài GitHub Desktop: https://desktop.github.com/
• Đăng nhập GitHub trong GitHub Desktop.
• Xác định thư mục Zotero trên Windows (mặc định): %USERPROFILE%\Zotero
  • Ví dụ: C:\Users\ten_cua_ban\Zotero

2) Thiết lập .gitignore (chỉ thực hiện lần đầu)

Mục tiêu: Chỉ đưa lên Git các nội dung cần thiết: thư mục storage/, tệp cơ sở dữ liệu zotero.sqlite và các tệp ghi chú .md (nếu có).

Trong thư mục Zotero (mặc định %USERPROFILE%\Zotero), tạo file tên .gitignore với nội dung sau:

*
!.gitignore
!/storage
!/storage/**/*
!zotero.sqlite
!*.md

Giải thích nhanh:

• * bỏ qua mọi thứ theo mặc định.
• !/storage, !/storage/**/* vẫn theo dõi thư mục đính kèm (PDF, ảnh, v.v.).
• !zotero.sqlite theo dõi cơ sở dữ liệu Zotero.
• !*.md theo dõi các tệp Markdown trong thư mục gốc Zotero (nếu bạn muốn lưu ghi chú).

Lưu ý: Cách này sẽ đẩy cả tệp đính kèm lên GitHub nên dung lượng repo có thể lớn theo thời gian. Xem mục "Giới hạn & Mẹo" bên dưới.

3) Tạo repository từ thư mục Zotero bằng GitHub Desktop (lần đầu)

1. Mở GitHub Desktop → chọn File → Add Local Repository...
2. Choose... → trỏ đến thư mục Zotero của bạn, ví dụ: %USERPROFILE%\Zotero
3. Nhấn Add Repository.
4. Ở góc trên, đặt tên repo (ví dụ: zotero-backup).
5. Nhấn Publish repository → chọn Private (khuyến nghị) → Publish Repository.
6. Đợi đồng bộ xong lần đầu (có thể lâu nếu có nhiều tệp đính kèm).

4) Quy trình sao lưu định kỳ (hàng ngày/tuần)

Trước khi thực hiện: Đóng Zotero để đảm bảo zotero.sqlite không bị khóa.

1. Mở GitHub Desktop.
2. Ở thanh bên "Changes", kiểm tra các thay đổi.
3. Điền "Summary" (ví dụ: Cập nhật tài liệu tuần này).
4. Nhấn Commit to main.
5. Nhấn Push origin để đẩy bản sao lưu lên GitHub.

Mẹo: Bạn có thể thêm mô tả chi tiết vào ô "Description" nếu muốn.

5) Khôi phục trên máy mới (hoặc sau khi cài lại máy)

1. Cài Zotero trên máy mới.
2. Cài GitHub Desktop và đăng nhập.
3. Trong GitHub Desktop: File → Clone repository... → chọn repo zotero-backup của bạn.
4. Ở bước chọn nơi lưu, đặt đường dẫn là %USERPROFILE%\Zotero để Zotero nhận đúng dữ liệu.
5. Đợi tải xong → Mở Zotero.

Lưu ý: Nếu đã có sẵn thư mục %USERPROFILE%\Zotero trên máy mới, hãy sao lưu thư mục đó ra nơi khác trước khi ghi đè.

6) Giới hạn & Mẹo quan trọng

• Đóng Zotero trước khi Pull/Commit/Push để tránh lỗi khóa tệp zotero.sqlite.

• Giới hạn kích thước GitHub:

  • Tệp đơn lẻ > 100 MB có thể bị từ chối. Với repo lớn hoặc nhiều PDF nặng, cân nhắc dùng Git LFS.
  • Dung lượng repo khuyến nghị < 1 GB. Nếu kho lớn dần, dùng LFS hoặc chỉ sao lưu zotero.sqlite.

• Tùy chọn chỉ sao lưu cơ sở dữ liệu (không đính kèm): thay .gitignore thành:

  *
  !zotero.sqlite
  !*.md

  Cách này nhỏ gọn hơn, nhưng KHÔNG lưu PDF/ảnh trong storage/.

• Bảo mật: Đặt repo ở chế độ Private để dữ liệu nghiên cứu không bị công khai.

7) (Tùy chọn) Bật Git LFS cho tệp lớn

Nếu bạn muốn sao lưu cả storage/ với nhiều PDF lớn:

1. Cài Git LFS: https://git-lfs.com/ (GitHub Desktop thường hỗ trợ, nhưng bạn có thể cài thêm nếu cần).
2. Mở Command Prompt (hoặc Terminal) tại thư mục Zotero và chạy:
   • git lfs install
   • git lfs track "storage/**"
   • git lfs track "zotero.sqlite"
3. Commit lại các thay đổi (có thể Git yêu cầu commit file .gitattributes).
4. Push như bình thường trong GitHub Desktop.

Tài liệu tham khảo:

• Hướng dẫn GitHub Desktop – Thêm repo local: https://docs.github.com/en/desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop
• Commit thay đổi: https://docs.github.com/en/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop
• Push lên GitHub: https://docs.github.com/en/desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop
• Pull về máy: https://docs.github.com/en/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/syncing-your-branch-in-github-desktop#pulling-to-your-local-branch-from-the-remote
• Hướng dẫn về các tệp lớn trên GitHub: https://docs.github.com/en/repositories/working-with-files/managing-large-files/about-large-files-on-github
• Git LFS: https://docs.github.com/en/repositories/working-with-files/managing-large-files/about-git-large-file-storage

---

Câu hỏi thường gặp

• Commit/Pull/Push báo lỗi do file đang mở? Đóng Zotero rồi thử lại.
• Push chậm hoặc bị từ chối do tệp lớn? Bật Git LFS hoặc cân nhắc chỉ sao lưu zotero.sqlite.
• Khôi phục xong mà Zotero không thấy tài liệu? Kiểm tra lại bạn đã clone đúng về %USERPROFILE%\Zotero chưa.