Tài liệu chính thức của Angular được dịch bằng AI
(angular-kr-docs.web.app)Xin chào! Gần đây khi tham gia vào dự án Angular, tôi đã gặp khó khăn vì thiếu tài liệu bằng tiếng Hàn.
Vì vậy, tôi đã sử dụng một dự án dịch AI mã nguồn mở để Hàn hóa tài liệu chính thức của Angular và thậm chí phát hành nó chỉ trong 5 giờ.
Hiện tại, phần lớn mới chỉ ở trạng thái bản dịch nháp đầu tiên bằng AI!
Tình trạng bản dịch
- Đã hoàn thành dịch khoảng 300 tệp md
- Đang dịch thêm các tệp không được dịch tự động như tệp HTML
- Có thể hiểu các khái niệm cốt lõi bằng tiếng Hàn cùng với ví dụ mã
- Có thể dễ dàng tìm nội dung cần thiết với cấu trúc giống hệt bản gốc tiếng Anh
Thực ra, tôi đã phân vân giữa việc dùng danh mục Show GN để giới thiệu tài liệu Angular đã dịch hay dùng danh mục News để giới thiệu công cụ dịch.
Có thể không có quá nhiều người dùng Angular, nhưng tôi chọn Show GN với hy vọng nó sẽ hữu ích cho những ai đang tìm tài liệu tiếng Hàn!
Công cụ đã sử dụng
Tôi tình cờ phát hiện một dự án nhỏ tên là "ai-markdown-translator", và kết quả tạo ra tốt hơn mong đợi.
Tôi khá thích nó nên hiện đang fork repository và chỉnh sửa mã để đóng góp cho dự án.
Ưu điểm
- Dự án mã nguồn mở được tối ưu cho việc dịch tài liệu Markdown
- Có thể dịch đệ quy các tệp có phần mở rộng cụ thể trong thư mục
- Dịch toàn bộ chỉ với lệnh
npx ai-markdown-translator -i . -e md -l "Korean" --log - Giữ được phần lớn cấu trúc cú pháp và định dạng Markdown khi dịch
- Phù hợp với tài liệu kỹ thuật tạo trang dựa trên nội dung MD
Hạn chế
- Việc dịch quá sát nghĩa các thuật ngữ chuyên môn, như dịch Signal thành 'tín hiệu', vẫn còn đáng tiếc
- Phát hiện vấn đề một số đường dẫn tham chiếu tệp bị thay đổi sai
- Vẫn có những phần cần cải thiện vì mới ở mức bản dịch nháp đầu tiên
Quy trình dịch và triển khai
- Clone repository tài liệu chính thức của Angular
- Sau khi chạy lệnh, khoảng 300 tệp đã được dịch xong sau 2 giờ
- Sửa các đường dẫn tham chiếu tệp bị sai
- Tham khảo cấu hình Firebase của dự án Angular hiện có để tiến hành triển khai
Vẫn còn nhiều phần cần trau chuốt và sẽ phải dần dần rà soát, chỉnh sửa, nhưng so với thời gian đã đầu tư thì kết quả có vẻ khá ổn.
Tôi khuyến nghị những ai muốn dịch tài liệu kỹ thuật được viết ở định dạng MD hãy thử dùng nó!!
Cảm ơn bạn đã đọc bài dài này! Chúc bạn một ngày tốt lành!! ❤️🔥
4 bình luận
Wow! Angular!
...! Bạn có dùng Angular không?
Dạo này hình như hầu như không còn người dùng ở Hàn Quốc nữa, nên thấy bạn để lại bình luận mình mừng lắm luôn! haha
Tôi không biết React, chỉ biết một chút Angular, nên thấy bài viết về Angular trong cộng đồng Hàn Quốc thì rất vui.
Tôi chỉ dùng React rồi chuyển sang Angular, hóa ra lại là chiều ngược lại nhỉ haha
Nếu có dịp, có lẽ tôi sẽ lại viết bài về Angular,,,haha