PDF to LateX (Có cắt ảnh chèn đúng vị trí)

Chuẩn bị trước khi bắt đầu

Bạn cần có sẵn 3 thứ sau:

1. Tài khoản Google — Tài khoản Gmail thông thường là đủ.

2. API key của Mistral AI (dịch vụ nhận dạng chữ trong PDF)

• Truy cập: console.mistral.ai
• Đăng ký tài khoản → vào mục "API Keys" → nhấn "Create new key"
• Sao chép key vừa tạo ra (dạng chuỗi ký tự dài) và lưu lại 3. API key của Google Gemini (dịch vụ AI chỉnh sửa và định dạng LaTeX)
• Truy cập: aistudio.google.com
• Đăng nhập bằng tài khoản Google → nhấn "Get API key" → "Create API key"
• Sao chép key và lưu lại

💡 Lưu ý: Cả hai dịch vụ đều có gói miễn phí đủ dùng cho nhu cầu cá nhân.

---

Bước 1 — Mở Google Apps Script

1. Mở trình duyệt, truy cập: script.google.com
2. Đăng nhập bằng tài khoản Google của bạn
3. Nhấn nút "New project" (Dự án mới) ở góc trên bên trái → Một cửa sổ soạn thảo code sẽ mở ra với file Code.gs trống
4. Nhấn vào tên dự án "Untitled project" ở góc trên → đổi tên thành PDF to LaTeX v8.1 → nhấn OK

---

Bước 2 — Dán code vào file Code.gs

1. Mở file code (gs)-pdf to latex.txt từ gói ZIP bằng Notepad hoặc bất kỳ ứng dụng đọc văn bản nào
2. Nhấn Ctrl+A để chọn tất cả → Ctrl+C để sao chép
3. Quay lại cửa sổ Google Apps Script
4. Nhấn vào vùng soạn thảo (nơi có chữ function myFunction() {}) → nhấn Ctrl+A để chọn hết → Delete để xóa
5. Nhấn Ctrl+V để dán code vừa sao chép vào

---

Bước 3 — Điền API key của bạn vào code

Sau khi dán code, bạn cần tìm và điền 2 API key vào đúng chỗ:

1. Nhấn Ctrl+F để mở ô tìm kiếm trong editor

2. Tìm dòng chứa chữ: API OCR PDF

3. Thay chữ API OCR PDF bằng Mistral API key của bạn (giữ nguyên dấu nháy đơn ' bên ngoài) Ví dụ trước khi sửa:

   API_KEY: 'API OCR PDF',
   

   Sau khi sửa:

   API_KEY: 'abc123xyz...',
   

4. Tiếp theo tìm dòng chứa chữ: GEMINI API THỰC TẾ

5. Thay bằng Gemini API key của bạn theo cách tương tự

⚠️ Quan trọng: Không xóa dấu nháy đơn ' bao quanh key. Không chia sẻ file này cho người khác khi đã điền API key.

---

Bước 4 — Thêm file giao diện HTML

1. Trong cửa sổ Apps Script, nhìn bên trái có mục "Files"
2. Nhấn dấu "+" bên cạnh chữ "Files"
3. Chọn "HTML" từ menu hiện ra
4. Đặt tên file là: index-latex (gõ chính xác như vậy, không thêm gì khác) → nhấn Enter → Một tab mới tên index-latex.html sẽ xuất hiện
5. Mở file index-latex (html)-PDF to latex.txt từ gói ZIP bằng Notepad
6. Nhấn Ctrl+A → Ctrl+C để sao chép toàn bộ nội dung
7. Quay lại Apps Script, nhấn vào tab index-latex.html
8. Xóa nội dung có sẵn (Ctrl+A → Delete) → Dán vào (Ctrl+V) Lúc này bên trái sẽ thấy 2 file:

📁 PDF to LaTeX v8.1
   ├── Code.gs
   └── index-latex.html

---

Bước 5 — Lưu toàn bộ

Nhấn Ctrl+S để lưu. Hoặc nhấn biểu tượng 💾 trên thanh công cụ.

---

Bước 6 — Cấp quyền cho ứng dụng

Ứng dụng cần quyền truy cập Google Drive để xử lý file. Cấp quyền như sau:

1. Ở thanh công cụ trên cùng, chọn hàm testConnectionLatex từ menu dropdown (thay vì myFunction)
2. Nhấn nút ▶ Run (hình tam giác)
3. Google sẽ hiện hộp thoại "Authorization required" → nhấn "Review permissions"
4. Chọn tài khoản Google của bạn
5. Nhấn "Advanced" → "Go to PDF to LaTeX v8.1 (unsafe)" (Chữ "unsafe" xuất hiện vì đây là ứng dụng chưa được Google xác minh — hoàn toàn bình thường với ứng dụng tự tạo)
6. Nhấn "Allow" (Cho phép) → Kiểm tra phần "Execution log" phía dưới — nếu thấy Mistral API test: SUCCESS và Gemini API key test: VALID là thành công.

---

Bước 7 — Xuất bản ứng dụng (Deploy)

Đây là bước tạo ra đường link để bạn dùng ứng dụng:

1. Nhấn nút "Deploy" (góc trên bên phải) → chọn "New deployment"
2. Nhấn biểu tượng ⚙️ bên cạnh chữ "Select type" → chọn "Web app"
3. Điền thông tin:
   • Description: Phiên bản 1
   • Execute as: chọn Me (tên email của bạn)
   • Who has access: chọn Anyone (để truy cập không cần đăng nhập)
4. Nhấn "Deploy"
5. Google sẽ cấp một Web app URL (đường link dài) — nhấn "Copy" để sao chép

🔗 Đây là đường link của ứng dụng. Lưu lại để dùng về sau.

---

Bước 8 — Mở và dùng ứng dụng

1. Mở trình duyệt, dán Web app URL vào thanh địa chỉ → nhấn Enter
2. Giao diện ứng dụng sẽ hiện ra với nền xanh teal
3. Nhấn nút "Test APIs" → chờ vài giây → kiểm tra kết quả:
   • ✅ OCR: SUCCESS
   • ✅ Gemini: VALID
   • ✅ Drive: SUCCESS Nếu cả 3 đều xanh ✅ → ứng dụng sẵn sàng sử dụng!

---

Cách chuyển đổi một file PDF

1. Kéo thả file PDF vào ô upload, hoặc nhấn vào ô đó để chọn file từ máy tính
2. Giữ nguyên các tùy chọn mặc định (đã tích sẵn)
3. Nhấn nút "Chuyển đổi sang LaTeX v8.1"
4. Chờ hệ thống xử lý — thanh tiến trình sẽ chạy qua 5 bước
5. Khi hoàn tất:
   • Mã LaTeX hiện ra trong khung bên dưới
   • Nhấn "Download ZIP" để tải về máy
   • File ZIP chứa: ten-file.tex + thư mục Images/ với các hình ảnh

---

Xử lý sự cố thường gặp

Vấn đề	Cách xử lý
OCR hiện ❌	Kiểm tra lại Mistral API key trong Code.gs — đảm bảo không có khoảng trắng thừa
Gemini hiện ❌	Kiểm tra lại Gemini API key — thử tạo key mới tại aistudio.google.com
Nút "Deploy" bị lỗi	Lưu file trước (Ctrl+S) rồi thử lại
Xử lý quá lâu / timeout	PDF quá nhiều trang — hãy tách PDF thành các file nhỏ hơn (dưới 20 trang)
Giao diện trắng khi mở link	Thử xóa cache trình duyệt (Ctrl+Shift+Delete) rồi tải lại

---

Cập nhật khi có thay đổi code

Nếu bạn sửa code và muốn cập nhật lên ứng dụng:

1. Nhấn "Deploy" → "Manage deployments"
2. Nhấn biểu tượng ✏️ bên cạnh deployment hiện tại
3. Ở mục "Version", chọn "New version"
4. Nhấn "Deploy" → Xong!

Đường link không thay đổi — bạn dùng link cũ vẫn được.