KDE Localization/vi/checking: Difference between revisions

From KDE Community Wiki
(3 first ways of checking)
 
(Update 3 first checks)
Line 8: Line 8:


=== Kiểm tra đối số đủ hay không ===
=== Kiểm tra đối số đủ hay không ===
Một <small>kịch bản</small> (<small>script</small>) Pology đơn giản đã được đặt tại {{Path | <KDE_SVN>/trunk/l10n-support/scripts/pology/args-accels.rules}}. <small>Kịch bản</small> này kiểm tra xem xâu đích có 3 đối số đầu tiên (%1, %2, %3) hay không, khi mà xâu nguồn có đối số tương ứng. Ví dụ nếu xâu nguồn chứa "%2" mà xâu đích không có "%2" thì Pology chạy kịch bản này sẽ báo lỗi.
Một <small>tệp quy tắc</small> (<small>rule file</small>) Pology đơn giản đã được đặt tại {{Path | <KDE_SVN>/trunk/l10n-support/scripts/pology/args-accels.rules}}. <small>Tệp quy tắc</small> này định ra các <small>quy tắc</small> rằng xâu đích phải có 3 đối số đầu tiên (%1, %2, %3) nếu xâu nguồn có đối số tương ứng. Ví dụ nếu xâu nguồn chứa "%2" mà xâu đích không có "%2" thì Pology khi chạy kiểm tra các <small>quy tắc</small> này sẽ báo lỗi.


Xem cách dùng kịch bản Pology ở [[KDE Localization/vi/components#Pology]]
Xem cách kiểm tra bằng Pology ở [[KDE Localization/vi/components#Pology]]


<div class="alert alert-warning" style="overflow:auto;">
<div class="alert alert-warning" style="overflow:auto;">
Chú ý:<br>
Chú ý:<br>
Kịch bản trên mới ở dạng đơn giản, chưa kiểm tra khi xâu đích có một đối số mà xâu nguồn '''không''' có.<br>
<small>Tệp quy tắc</small> trên mới ở dạng đơn giản, chưa xét đến trường hợp xâu đích có một đối số mà xâu nguồn '''không''' có.<br>
Thêm nữa, có thể có thông điệp có nhiều hơn 3 đối số, khi đó kịch bản này sẽ không kiểm tra được đối số thứ tư.
Thêm nữa, có thể có thông điệp có nhiều hơn 3 đối số, Pology khi kiểm tra các quy tắc này sẽ không xử lí đối số thứ tư.
</div>
</div>


=== Kiểm tra <small>nút tăng tốc</small> (<small>accelerator</small>) ===
=== Kiểm tra <small>nút tăng tốc</small> (<small>accelerator</small>) ===
Kịch bản Pology trên cũng chứa một phần kiểm tra xem xâu đích có dấu tăng tốc (&) hay không, khi mà xâu nguồn có, báo lỗi khi xâu đích không có.
<small>Tệp quy tắc</small> Pology trên cũng định ra một <small>quy tắc</small> rằng xâu đích phải có dấu tăng tốc (&) nếu xâu nguồn có, Pology sẽ báo lỗi khi kiểm tra <small>quy tắc</small> này mà xâu đích không có dấu tăng tốc nào.


<div class="alert alert-warning" style="overflow:auto;">
<div class="alert alert-warning" style="overflow:auto;">
Chú ý:<br>
Chú ý:<br>
Tương tự như với việc kiểm tra đối số, kịch bản này chưa kiểm tra khi xâu đích có dấu tăng tốc mà xâu nguồn '''không''' có.<br>
Tương tự như với việc kiểm tra đối số, <small>quy tắc</small> này chưa xét đến trường hợp xâu đích có dấu tăng tốc mà xâu nguồn '''không''' có, hoặc khi cả hai xâu đều có nhưng số lượng dấu tăng tốc ở hai xâu là khác nhau (tuy nhiên có thể coi đây là trường hợp khó xảy ra).<br>
Một vấn đề quan trọng nữa cần kiểm tra với nút tăng tốc là liệu có nút tăng tốc nào xuất hiện nhiều hơn 1 lần trong cùng một trình đơn không. Nếu bạn kiểm tra khả năng trùng lặp này một cách thủ công, bạn phải rất cẩn thận. Hoặc hãy [[KDE Localization/vi/checking#Ki.E1.BB.83m_tra_theo_ng.E1.BB.AF_c.E1.BA.A3nh|kiểm tra theo ngữ cảnh]] để có thể chắc chắn hơn.
Một vấn đề quan trọng nữa cần kiểm tra với <small>nút tăng tốc</small> là liệu có <small>nút tăng tốc</small> nào xuất hiện nhiều hơn 1 lần trong cùng một trình đơn không. Nếu bạn kiểm tra khả năng trùng lặp này bằng cách tìm và so sánh thủ công trong bản dịch, bạn phải rất cẩn thận. Hoặc hãy [[KDE Localization/vi/checking#Ki.E1.BB.83m_tra_theo_ng.E1.BB.AF_c.E1.BA.A3nh|kiểm tra theo ngữ cảnh]] để có thể chắc chắn hơn.
</div>
</div>


=== Kiểm tra cú pháp XML ===
=== Kiểm tra cú pháp XML ===
Chạy Pology check-kde4
Pology hỗ trợ kiểm tra cú pháp XML với <small>sàng</small> (<small>sieve</small>) <code>check-kde4</code>.


=== Kiểm tra theo ngữ cảnh ===
=== Kiểm tra theo ngữ cảnh ===
Có các cách sau:
*

Revision as of 19:25, 16 September 2020

Trang này mô tả các bước để người dịch kiểm tra một bản dịch trước khi chuyển cho người điều phối. Tài liệu hướng dẫn bản địa hoá của KDE có đề cập đến các bước này ở https://l10n.kde.org/docs/translation-howto/check-gui.html.

Kiểm tra cú pháp tệp PO

Trên Linux với gói gettext đã được cài đặt, chạy lệnh sau trong một chương trình dòng lệnh:

msgfmt --statistics --check-header <đường_dẫn_đến_bản_dịch>

Kiểm tra đối số đủ hay không

Một tệp quy tắc (rule file) Pology đơn giản đã được đặt tại <KDE_SVN>/trunk/l10n-support/scripts/pology/args-accels.rules. Tệp quy tắc này định ra các quy tắc rằng xâu đích phải có 3 đối số đầu tiên (%1, %2, %3) nếu xâu nguồn có đối số tương ứng. Ví dụ nếu xâu nguồn chứa "%2" mà xâu đích không có "%2" thì Pology khi chạy kiểm tra các quy tắc này sẽ báo lỗi.

Xem cách kiểm tra bằng Pology ở KDE Localization/vi/components#Pology

Chú ý:
Tệp quy tắc trên mới ở dạng đơn giản, chưa xét đến trường hợp xâu đích có một đối số mà xâu nguồn không có.
Thêm nữa, có thể có thông điệp có nhiều hơn 3 đối số, Pology khi kiểm tra các quy tắc này sẽ không xử lí đối số thứ tư.

Kiểm tra nút tăng tốc (accelerator)

Tệp quy tắc Pology trên cũng định ra một quy tắc rằng xâu đích phải có dấu tăng tốc (&) nếu xâu nguồn có, Pology sẽ báo lỗi khi kiểm tra quy tắc này mà xâu đích không có dấu tăng tốc nào.

Chú ý:
Tương tự như với việc kiểm tra đối số, quy tắc này chưa xét đến trường hợp xâu đích có dấu tăng tốc mà xâu nguồn không có, hoặc khi cả hai xâu đều có nhưng số lượng dấu tăng tốc ở hai xâu là khác nhau (tuy nhiên có thể coi đây là trường hợp khó xảy ra).
Một vấn đề quan trọng nữa cần kiểm tra với nút tăng tốc là liệu có nút tăng tốc nào xuất hiện nhiều hơn 1 lần trong cùng một trình đơn không. Nếu bạn kiểm tra khả năng trùng lặp này bằng cách tìm và so sánh thủ công trong bản dịch, bạn phải rất cẩn thận. Hoặc hãy kiểm tra theo ngữ cảnh để có thể chắc chắn hơn.

Kiểm tra cú pháp XML

Pology hỗ trợ kiểm tra cú pháp XML với sàng (sieve) check-kde4.

Kiểm tra theo ngữ cảnh

Có các cách sau: