Xuất bản thành PDF đẹp (và các định dạng khác)
"Xuất ra PDF" không phải một nút bấm — đó là một pipeline thật với công cụ ngoài, và Claude đóng vai người thợ đứng máy lái pipeline đó.
Sự thật đầu tiên: Claude không tự tạo PDF
Claude không có 'máy in PDF' bên trong. Thay vào đó, nó điều khiển các công cụ ngoài — Pandoc, Typst, WeasyPrint — bằng cách gọi lệnh qua bash. Claude đóng vai người thợ đứng máy: biết cú pháp lệnh, biết viết file cấu hình, biết đọc thông báo lỗi và sửa — nhưng cái máy in thật là phần mềm bạn phải cài lên máy trước.
Ba con đường phổ biến: Pandoc + Typst (đơn giản nhất, biên dịch nhanh, khuyên bắt đầu ở đây), Typst thuần (kiểm soát cao, cú pháp sạch hơn LaTeX), và HTML/CSS + WeasyPrint (nếu đã quen CSS). Cả Cowork lẫn Claude Code đều chạy được pipeline; người mới nên bắt đầu bằng Cowork.
Trao đổi (0)
Vòng lặp vàng: chạy → đọc lỗi → sửa → chạy lại
Lần build đầu tiên hiếm khi hoàn hảo — đây chính là chỗ Claude toả sáng:
- 1
Chạy lệnh build (Pandoc/Typst/WeasyPrint tuỳ con đường đã chọn).
- 2
Đọc thông báo — thành công, hay lỗi ở dòng nào.
- 3
Sửa đúng nguyên nhân thật (thiếu font? sửa cấu hình. Ảnh gãy? sửa đường dẫn) — không đoán mò.
- 4
Chạy lại, lặp tới khi ra file sạch — yêu cầu Claude báo tín hiệu khách quan (số trang, kích thước file) sau mỗi vòng, và tự mình mở file kiểm.
Trao đổi (0)
Lỗi âm thầm: build "thành công" nhưng chữ mất dấu
Đây là cạm bẫy số một khi build sách tiếng Việt. Nếu font bạn chọn không phủ đủ glyph tiếng Việt, chữ có dấu (ê, ữ, ậ, ợ, ễ...) sẽ mất dấu hoặc hiện thành ô vuông (tofu) — nhưng lệnh build vẫn báo 'thành công' và vẫn cho ra file PDF, không một thông báo lỗi nào.
Không có cảnh báo kỹ thuật nào cứu bạn khỏi lỗi này ngoài chính đôi mắt bạn: cách phòng là chọn font Unicode phủ đầy đủ tiếng Việt từ khâu thiết kế, rồi sau mỗi lần build, tự mở PDF phóng to soi một đoạn nhiều dấu tận mắt. 'Build xong' không có nghĩa là 'chữ đúng'.
Nguồn: Chương 12 — Xuất bản thành PDF đẹp
Trao đổi (0)
Việc cần làm ngay
- Kiểm tra công cụ đã sẵn sàng: nhờ Claude kiểm xem máy đã cài Pandoc và Typst chưa, nếu chưa thì chỉ cách cài. 2) Build bản nháp đầu tiên: xuất một sach.pdf từ bản thảo hiện có, dù còn xấu — mục tiêu là thấy nó chạy. 3) Mở file PDF ra tận mắt: đếm số trang, xem mục lục, tìm ảnh gãy, ghi lại 3 vấn đề lớn nhất. 4) Lưu lệnh build đã chạy được vào một file ghi chú hoặc nhờ Claude gói thành build.sh để lần sau không phải nhớ lại.
Trao đổi (0)
Hãy để Claude dán nguyên văn lệnh đã chạy và kết quả thật, đừng bằng lòng với câu 'đã xuất PDF xong'. Một trợ lý AI, nếu bị thúc, có thể tường thuật một thành công chưa xảy ra. Yêu cầu tín hiệu khách quan (số trang, kích thước file) và tự bạn mở file kiểm lại — một câu tường thuật không thay được một file mở lên tận mắt.
Trao đổi (0)
Đăng nhập ở góc trên để lưu tiến độ đọc.