Khi dịch tài liệu kỹ thuật (Markdown), cần xử lý các khối mã và Front Matter như thế nào?
“Nếu các khối mã, mã nội tuyến và phần cấu hình đầu (Front Matter) trong tài liệu kỹ thuật bị dịch, tài liệu sẽ bị vô hiệu hóa.”
Phân tích nguyên nhân gốc rễ
Cơ chế 'vùng cách ly' cho khối mã
Hệ thống sẽ tự động nhận diện nội dung được bao bởi ``` (khối mã) và ` (mã nội tuyến). Các vùng này được đánh dấu là 'vùng không dịch', AI sẽ bỏ qua phần nội dung này nhằm đảm bảo logic của mã Python, JS, v.v. không bị ảnh hưởng.
Bảo vệ metadata Front Matter
Đối với cấu hình YAML Front Matter thường gặp ở các blog tĩnh như Jekyll/Hugo (ví dụ: `date:`, `slug:`), chúng ta chỉ dịch các trường cụ thể như `title` và `description`, đồng thời giữ nguyên các tham số cấu hình cần thiết cho quá trình xây dựng.
Tự động sắp xếp lại bảng Markdown
Bảng Markdown thường bị lệch hàng do thay đổi độ dài ký tự sau khi dịch. DL.Translator sẽ tính toán lại vị trí ký tự đường ống `|` trong quá trình hậu xử lý, đảm bảo mã nguồn bảng đầu ra căn chỉnh đẹp mắt.
Tổng kết giải pháp cuối cùng
Được thiết kế riêng cho cộng đồng mã nguồn mở và các nhà phát triển, bảo đảm README.md và tài liệu kỹ thuật duy trì tính chuyên nghiệp, dễ đọc khi chuyển đổi giữa các ngôn ngữ.