- Khi nào nên dùng mỗi cách?
- Cách 1: Import tiểu thuyết bằng file ZIP (khuyến nghị cho số lượng lớn)
- Cấu trúc ZIP chuẩn
- Các bước thực hiện
- Hệ thống sẽ tự động
- Cách 2: Dán nhiều chương trực tiếp trong Editor
- Định dạng bắt buộc
- Các bước thực hiện
- Đặc điểm kỹ thuật
- Cơ chế chống lỗi và trùng chương
- Nên chọn cách nào?
- Kết luận
Bài viết này tổng hợp đầy đủ hai workflow để bạn chọn cách phù hợp nhất cho từng tình huống.
Khi nào nên dùng mỗi cách?
- ZIP Batch Import: Khi đã có sẵn nhiều file chương (.txt / .docx) trên máy tính.
- Dán trực tiếp trong Editor: Khi copy nội dung từ Word, Google Docs hoặc website khác.
Cách 1: Import tiểu thuyết bằng file ZIP (khuyến nghị cho số lượng lớn)
Đây là phương pháp tối ưu khi bạn có hàng chục đến hàng nghìn chương. Bạn chỉ cần chuẩn bị một file ZIP, mỗi file bên trong tương ứng một chương.
Cấu trúc ZIP chuẩn
1.txt
2.txt
3.5.txt
4 - Chapter title.txt
10.1 - Extra.docx
- Mỗi file = 1 chương
- Tên file bắt buộc chứa số chương
- Có thể thêm tiêu đề sau dấu
- - Hỗ trợ số thập phân (ví dụ: 3.5, 10.25)
- Hỗ trợ .txt và .docx
Các bước thực hiện
- Vào trang chỉnh sửa Manga/Novel trong Admin.
- Tìm box Batch Import Novel Chapters.
- Chọn file ZIP.
- Nhấn Start Novel Batch Import.
- Chờ thanh tiến trình hoàn tất.
Hệ thống sẽ tự động
- Giải nén ZIP an toàn (chống traversal, symlink, file độc hại)
- Đọc nội dung text thuần
- Parse số chương từ tên file
- Phát hiện chương trùng
- Tạo chương hàng loạt
- Hiển thị log chi tiết từng chương
Cách này nhanh nhất và ổn định nhất cho import quy mô lớn.
Cách 2: Dán nhiều chương trực tiếp trong Editor
Nếu bạn không có file riêng lẻ mà chỉ có nội dung thô, bạn có thể dán toàn bộ vào editor chương. Init Manga sẽ tự động nhận diện cấu trúc nhiều chương và tách ra để tạo lần lượt.
Định dạng bắt buộc
=== Chapter 1 ===
Nội dung chương 1...
=== Chapter 2 ===
Nội dung chương 2...
=== Chapter 3: Tiêu đề tùy chọn ===
Nội dung chương 3...
- Mỗi chương bắt đầu bằng
=== Chapter X === - Có thể thêm tiêu đề sau dấu
: - Nội dung nằm giữa hai tiêu đề
Các bước thực hiện
- Mở box Add / Edit Chapter.
- Dán toàn bộ nội dung nhiều chương vào editor.
- Nhấn Save Chapter.
- Hệ thống tự động import lần lượt.
Đặc điểm kỹ thuật
- Không tạo endpoint mới
- Tái sử dụng API lưu 1 chương hiện có
- Xử lý tuần tự (queue) để tránh quá tải server
- Chương trùng sẽ tự động bị bỏ qua
- Không ảnh hưởng logic cũ
Cơ chế chống lỗi và trùng chương
Dù dùng ZIP hay Editor:
- Nếu số chương đã tồn tại → tự động skip
- Không ghi đè dữ liệu cũ
- Không làm dừng toàn bộ quá trình
- Có thể import lại nhiều lần an toàn
Nên chọn cách nào?
| Tình huống | Phương pháp phù hợp |
|---|---|
| Có nhiều file chương sẵn | ZIP Batch Import |
| Copy từ Word / Docs / Web | Dán trực tiếp Editor |
| Hàng trăm hoặc nghìn chương | ZIP (nhanh hơn) |
| Chỉnh sửa nhanh vài chục chương | Editor |
Kết luận
Init Manga giúp việc import tiểu thuyết số lượng lớn trở nên đơn giản và an toàn với cả hai phương pháp: upload ZIP khi cần tốc độ tối đa, hoặc dán nội dung trực tiếp khi cần linh hoạt.
Dù chọn cách nào, hệ thống vẫn đảm bảo tương thích hoàn toàn với cơ chế chương hiện tại, giúp bạn tiết kiệm thời gian mà không đánh đổi độ ổn định.
Bình luận