Trải nghiệm khi dùng PDFMathTranslate (pdf2zh)
Bạn cài bằng pip hoặc uv, rồi gõ pdf2zh kèm tên file PDF. Chương trình tải mô hình nhận diện bố cục ở lần đầu, sau đó dịch và tạo hai file trong thư mục hiện tại: một bản chỉ có ngôn ngữ đích và một bản song ngữ để đối chiếu từng đoạn. Công thức, hình vẽ, bảng và mục lục giữ nguyên chỗ cũ thay vì bị phá như khi dán văn bản vào trình dịch.
Nếu không thích gõ lệnh, chạy pdf2zh -i để mở giao diện web ở máy bạn, hoặc dùng bản Windows đóng gói sẵn: tải file zip ở trang Releases, giải nén và bấm đúp pdf2zh.exe. Người dùng phần mềm Zotero có thể dùng plugin Zotero PDF2zh để dịch ngay trong thư viện tài liệu. Ngoài ra README có liệt kê vài dịch vụ thử miễn phí trên mạng, không cần cài đặt, nhưng tài nguyên có hạn.
Mặc định chương trình dùng Google làm dịch vụ dịch, tức là nội dung PDF được gửi tới dịch vụ bên ngoài. Bạn có thể chọn dịch vụ khác bằng tuỳ chọn -s, trong đó nhiều dịch vụ cần khoá API riêng.
Tính năng nổi bật
Giữ công thức và bố cục
Bảo toàn công thức, biểu đồ, mục lục và chú thích khi dịch.
Hai bản kết quả
Xuất bản dịch thuần và bản song ngữ để đọc đối chiếu.
Nhiều cách dùng
Dòng lệnh, giao diện web cục bộ (pdf2zh -i), Docker, bản Windows đóng gói sẵn và plugin Zotero.
Nhiều dịch vụ dịch
Chọn dịch vụ bằng -s, ví dụ deepl, hoặc nối với mô hình AI qua khoá API; danh sách đầy đủ có trong tài liệu.
Dịch một phần tài liệu
Dùng -p để chỉ dịch các trang cần thiết, tiết kiệm thời gian và chi phí.
Chế độ nhanh và OCR thử nghiệm
Có chế độ --ultrafast cho PDF có chữ sẵn và hỗ trợ OCR thử nghiệm cho trang scan dạng ảnh (cài thêm gói tuỳ chọn).
Tận dụng PDFMathTranslate (pdf2zh) vào việc gì?
Sinh viên, nghiên cứu sinh
Đọc bài báo khoa học tiếng Anh
Dịch bài báo nhiều công thức sang tiếng mẹ đẻ để nắm ý nhanh, rồi đối chiếu với bản gốc khi cần chính xác.
Kỹ sư, nhân viên kỹ thuật
Dịch tài liệu kỹ thuật, hướng dẫn thiết bị
Dịch catalog, datasheet, sách hướng dẫn mà vẫn giữ sơ đồ và bảng thông số đúng chỗ.
Giảng viên, sinh viên
Dịch giáo trình để học nhóm
Tạo bản song ngữ cho từng chương giúp học thuật ngữ chuyên ngành.
Người dùng Zotero
Tích hợp vào quy trình đọc paper
Cài plugin để dịch ngay từ thư viện tài liệu mà không phải mở thêm công cụ khác.
Cần chuẩn bị gì?
- Python 3.11 đến 3.12 nếu cài bằng pip hoặc uv.
- Lần đầu cần Internet để tải mô hình nhận diện bố cục; một số khu vực có thể gặp khó, README có hướng dẫn dùng biến
HF_ENDPOINTlàm cách khắc phục. - Windows bản đóng gói có thể cần cài thêm gói Visual C++ Redistributable (vc_redist.x64.exe) nếu không mở được file.
- Khoá API nếu dùng dịch vụ dịch hoặc mô hình AI có tính phí.
Hướng dẫn cài đặt chi tiết
Cài trên Windows (bản đóng gói)
Vào trang Releases của kho mã và tải file
pdf2zh-<phiên bản>-win64.zip(README nêu cách làm này).Giải nén rồi bấm đúp
pdf2zh.exeđể chạy. Nếu không mở được, càivc_redist.x64.execủa Microsoft rồi thử lại.Lưu ý README cho biết phiên bản 2.0 đã chuyển sang kho PDFMathTranslate-next, nên bản mới nhất có thể nằm ở đó.
Cài trên Python (uv hoặc pip)
Cách khuyến nghị trong README: cài Python 3.11 hoặc 3.12, sau đó cài công cụ bằng uv.
pip install uv uv tool install --python 3.12 pdf2zhHoặc cài thẳng bằng pip trong môi trường ảo.
pip install pdf2zhChạy dịch một file; kết quả nằm trong thư mục hiện tại.
pdf2zh document.pdf
Cài trên Giao diện web / Docker
Giao diện web ngay trên máy: cài bằng pip rồi chạy lệnh dưới, nếu trình duyệt không tự mở thì vào địa chỉ http://localhost:7860/.
pdf2zh -iHoặc dùng Docker: kéo ảnh và chạy, rồi mở http://localhost:7860/ trong trình duyệt.
docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zhKhông vào được Docker Hub thì README gợi ý dùng ảnh trên GitHub Container Registry (
ghcr.io/byaidu/pdfmathtranslate).
Dùng thử lần đầu
Chọn một bài báo PDF ngắn (vài trang) và đặt vào thư mục làm việc.
Chạy dịch. Tuỳ chọn
-lilà ngôn ngữ gốc,-lolà ngôn ngữ đích; hãy kiểm tra mã ngôn ngữ tiếng Việt có được hỗ trợ trong danh sách ngôn ngữ của tài liệu rồi thay vào.pdf2zh document.pdf -li en -lo MA_NGON_NGU_DICHMở hai file kết quả (
...-mono.pdfvà...-dual.pdf) để so sánh bản dịch thuần với bản song ngữ.Thử dịch một phần tài liệu để tiết kiệm thời gian, ví dụ chỉ trang 1.
pdf2zh document.pdf -p 1Muốn đổi dịch vụ dịch, thêm
-skèm tên dịch vụ (ví dụ deepl, cần khoá API riêng thiết lập theo tài liệu).pdf2zh document.pdf -s deepl
Mẹo dùng hay
- Thử trên vài trang trước rồi mới dịch cả file dài, vì tài liệu nhiều công thức dễ gặp lỗi bố cục.
- Dùng
--ultrafastcho PDF đã có sẵn chữ để dịch nhanh, nhưng với bảng và công thức phức tạp thì nên dùng chế độ thường. - Nếu cần dịch bằng mô hình riêng hoặc theo văn phong riêng, xem tuỳ chọn
--prompttrong tài liệu.
Lưu ý và hạn chế
- Mặc định dùng Google để dịch, nghĩa là nội dung được gửi ra ngoài; đừng dùng với tài liệu mật nếu chưa đổi sang dịch vụ phù hợp.
- Chỉ dịch tài liệu bạn có quyền dùng; việc dịch rồi phân phối lại sách hoặc bài báo có bản quyền có thể vi phạm điều khoản.
- Giấy phép AGPL-3.0 có yêu cầu riêng nếu bạn đưa phần mềm lên thành dịch vụ cho người khác; kiểm tra điều khoản trước khi thương mại hoá.
Câu hỏi thường gặp
Có dịch sang tiếng Việt được không?
Công cụ hỗ trợ nhiều ngôn ngữ và nhiều dịch vụ dịch; hãy kiểm tra danh sách ngôn ngữ trong tài liệu để chắc chắn tiếng Việt có trong dịch vụ bạn chọn. Chất lượng tuỳ dịch vụ.
Có miễn phí không?
Phần mềm miễn phí, mã nguồn mở. Dịch vụ dịch mặc định miễn phí, còn các dịch vụ hay mô hình AI khác có thể tính phí theo khoá API của bạn.
Có an toàn cho tài liệu riêng tư không?
Phần mềm chạy trên máy bạn, nhưng nội dung vẫn được gửi tới dịch vụ dịch bạn chọn (mặc định là Google), nên tài liệu nhạy cảm cần cân nhắc.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/PDFMathTranslate/PDFMathTranslate.gitRepo tương tự nên xem
Stirling PDF
Stirling-Tools / Stirling-PDF
Bộ hơn 50 công cụ PDF: gộp, tách, ký, che thông tin, nén, OCR, chạy trên máy hoặc tự cài.
Marker
datalab-to / marker
Chuyển PDF, ảnh, Word, PowerPoint thành Markdown, JSON hoặc HTML giữ nguyên bảng biểu và công thức
OCRmyPDF
ocrmypdf / OCRmyPDF
Biến PDF scan thành PDF có lớp chữ, tìm kiếm và sao chép được, chỉ với một lệnh