Meta:Quy định quốc tế hóa

Meta-Wiki hướng tới mục tiêu một wiki đa ngôn ngữ, do đóhầu hết các trang đều có thể dịch được và được dịch. Để có thể dịch thông qua Tiện ích mở rộng Dịch, một trang phải được gắn thẻ ‎<translate>...‎</translate> (tức quốc tế hóa), sau đó trang sẽ được đánh dấu cần dịch bởi một bảo quản viên bản dịch. Trang này nhằm trình bày hướng dẫn quốc tế hóa một trang trên Meta-Wiki

For a step-by-step guide to marking a page for translation, see the tutorial.

Hướng dẫn chung

Nói chung, bạn nên tuân thủ hướng dẫn của tiện ích mở rộng Dịch về việc đánh dấu một trang cần dịch: khi có thể, vui lòng tránh tách các đơn vị dịch theo cách thủ công khi đóng thẻ ‎</translate>, thay vào đó bạn nên để các dòng trống thực hiện công việc.

Although you can edit translated content using the visual editor, you must use the source editor to add or change translation markup. To make it easier to add translation markup, use the buttons in the box under the editing interface.

Do not use section editing when editing translated pages since this adds extra whitespace to the page. Always select the option to edit the entire page.

Ví dụ về phân đoạn

Cú pháp tốt	Cú pháp xấu
Add ‎<translate> tags on new lines around headings and paragraphs. <translate> == Đầu đề mục == Đây là một đoạn. Đây là một đoạn khác. </translate> {{Bản mẫu}} <translate> == Đầu mục khác == </translate>	Heading markup (for example: ==) must be included in translation units. == <translate>Đầu đề mục</translate> == <translate>Đây là một đoạn.</translate> <translate>Đây là một đoạn khác.</translate> {{Bản mẫu}} == <translate>Đầu mục khác<translate> ==
Split list items into individual translation units without line breaks. Exclude list markup from the translation unit. * <translate>Đây là một danh sách dài</translate> ** <translate>Có hơn 160 từ trong danh sách,</translate> ** <translate>hoặc có hơn 8 mục.</translate> * <translate>Vì vậy, tốt hơn hết là chia nó thành nhiều đơn vị nhỏ hơn.</translate> * <translate>Nhưng chúng tôi phải loại trừ các dấu đầu dòng khỏi các thẻ dịch để giữ cho danh sách có thể truy cập được.</translate>	List markup (for example: * or #) must be excluded from translation units. <translate> * Đây là một danh sách dài: ** Có hơn 160 từ trong danh sách này, ** hoặc có hơn 8 mục. </translate> <translate> * Vì vậy, tốt hơn là chia nó thành nhiều đơn vị nhỏ hơn. * Nhưng chúng tôi phải loại trừ các dấu đầu dòng khỏi các thẻ dịch để giữ cho danh sách có thể truy cập được. </translate>

Yếu tố cụ thể

Liên kết

Links require special markup to link to the correct language variant of the target page. Use localized link syntax for any page that could be translated, even if it hasn't been marked for translation. Pages which do not need localized link syntax include talk pages and templates without textual content.

To link to a page on a multilingual wiki, prefix links with Special:MyLanguage/. To make translation easier, include only the link text in the translation unit, not the link target. If the link is part of a larger translation unit, like a paragraph, you can exclude the link target from the translation unit by wrapping it inside a translation variable (<tvar name=1> … </tvar>).

For a standalone link to a page on the same wiki, such as in a list or a table, you can use the localized link template to simplify the syntax. This works on Meta-Wiki, mediawiki.org, Outreach Wiki, and other wikis where this template is available.

Đối với các liên kết đến bài viết Wikipedia, bạn nên sử dụng tiêu bản {{lwp}} cho mục tiêu và bọc nó bên trong một tvar. Ví dụ: [[{{lwp|Rosa Parks}}</tvar>]] tạo ra en:Rosa Parks trong các trang tiếng Anh và fr:Rosa Parks trong các trang tiếng Pháp

Đối với các liên kết chéo và liên kết bên ngoài khác, nếu có bản dịch, bạn không nên đặt mục tiêu liên kết bên trong tvar. Tất nhiên, nếu trang web mục tiêu có hệ thống phát hiện ngôn ngữ (như Special:MyLanguage/ của MediaWiki), bạn có thể sử dụng hệ thống này và đặt liên kết đầy đủ bên trong tvar

Cú pháp tốt	Cú pháp xấu
To link to a page on a multilingual wiki, prefix the link target with Special:MyLanguage/, and add link text. Use a translation variable to ensure that only the link text is included in the translation unit. <translate> Learn about [[<tvar name=1>Special:MyLanguage/Wikimedia projects</tvar>|Wikimedia projects]] and how to request a [[<tvar name=2>Special:MyLanguage/New project process</tvar>|new project]]. </translate>	The translation variable should include only the link target, not the link text. <translate> Learn about [[<tvar name=1>Special:MyLanguage/Wikimedia projects</tvar>|Wikimedia projects]] and how to request a [[<tvar name=2>Special:MyLanguage/New project process|new project</tvar>]]. </translate>
For a standalone link to a page on the same wiki, such as in a list or a table, use Template:ll , and translate only custom link text. You can use |nsp=0 to simplify the link text by omitting the namespace. <translate> See also: </translate> * {{ll|Help:Contents|2=<translate>Help pages</translate>}} * {{ll|Meta:Discussion pages|nsp=0}}	A parameter name (2=) is required when adding ‎<translate> tags inside template syntax. <translate> See also: </translate> * {{ll|Help:Contents|<translate>Help pages</translate>}} * {{ll|Meta:Discussion pages|nsp=0}}
For external links, exclude the link target from the translation unit using a translation variable. <translate> This is a text with an [<tvar name=url>https://openstreetmap.org</tvar> external link]. </translate>	A translation variable is required to exclude the external link target from the translation unit. <translate> Đây là một văn bản với một [[liên kết nội bộ]] và một [https://openstreetmap.org liên kết ngoài]. </translate>

Xếp thể loại

Bạn nên loại trừ các khai báo danh mục khỏi các thẻ ‎<translate>. Thay vào đó, hãy thêm {{#translation:}} sau tên danh mục: [[Category:Target category{{#translation:}}]]. Bằng cách này, chỉ trang tiếng Anh chính được phân loại vào danh mục mục tiêu, các trang dịch được phân loại theo danh mục theo ngôn ngữ.

Cú pháp tốt	Cú pháp xấu
[[Category:Wikipedia{{#translation:}}]]	<translate>[[Category:Wikipedia]]</translate>

Hình ảnh

Hình thu nhỏ và hình cỡ lớn

Nếu hình ảnh có thể được địa phương hóa (ví dụ: nó chứa một số văn bản và tồn tại một phiên bản đã dịch), nó phải được bao gồm đầy đủ trong các thẻ ‎<translate>.

Mặt khác, bạn chỉ nên bọc giá trị alt= trong thẻ <translate nowrap> và chú thích trong thẻ <translate>.

Nếu left hoặc right được sử dụng làm tham số hình ảnh: hãy xóa nó nếu nó vô dụng (hình thu nhỏ mặc định là bên phải bằng tiếng Anh) hoặc thay thế bằng {{dirstart}}.

Cú pháp tốt	Cú pháp xấu
[[File:phong cảnh.jpg |thumb |{{dirstart}} |alt=<translate nowrap>mặt trời lặn</translate> |<translate>Hình ảnh về một phong cảnh đẹp</translate>]]	<translate> [[File:phong cảnh.jpg |thumb |left |alt=mặt trời lặn |Hình ảnh về một phong cảnh đẹp]] </translate>
<translate> [[File:Ảnh chụp màn hình Wikipedia tiếng Anh.png|thumb|alt=Homepage of English Wikipedia with featured article and news topics|Trang chính Wikipedia]] </translate>	[[File:Ảnh chụp màn hình Wikipedia tiếng Anh.png|thumb|right|alt=<translate nowrap>Homepage of English Wikipedia with featured article and news topics</translate>|<translate>Trang chính Wikipedia</translate>]]

Biểu tượng

Các biểu tượng nội tuyến có thể được gói đơn giản trong thẻ <tvar name="icon">.

Cú pháp tốt	Cú pháp xấu
<translate> [[File:lời chào đẹp.png|alt=Xin chào mọi người!]], <tvar name="icon">[[File:mặt cười.png|alt=🙂]] Bạn khỏe không? </translate>	<translate> [[File:lời chào đẹp.png|alt=Xin chào mọi người!]], [[File:mặt cười.png|alt=🙂]] Bạn khỏe không? </translate>

Biến bản dịch

See also: mw:Help:Extension:Translate/Page translation administration § Variables

Biến trong bản dịch (cú pháp <tvar name="name"></tvar>) nên được sử dụng để ẩn đoạn văn bản khỏi biên dịch viên nhằm ngăn họ dịch nó.

Các ví dụ sau nên được bọc bên trong tvar:

• liên kết mục tiêu tự động địa phương hóa hoặc không địa phương hóa,
• tên người dùng,
• các số có khả năng thay đổi (chúng nên được bao bọc bên trong {{formatnum:}} rồi bên trong tvar),
• thuộc tính thẻ (ví dụ: <span class="css_class" style="background-color:blue"</tvar>>hello</span>),
• tên bản mẫu và tham số (ví dụ: {{<tvar name=1>center|5px</tvar>|hello}}),
• Bạn có thể đặt các phần của mã wiki hoặc HTML phức tạp bên trong $tag, nhưng vui lòng đảm bảo rằng mã wiki thu được được cân bằng.

Các ví dụ sau không nên được bọc trong tvar:

• tên người và địa điểm (ngay cả khi chúng hiếm khi được dịch, chúng có thể chuyển ngữ),
• Thẻ XML không có thuộc tính, chẳng hạn như <code> (giao diện dịch sẽ xử lý chúng),
• liên kết mục tiêu có thể địa phương hóa (tức liên kết đến trang web đa ngôn ngữ).

Tên biến bản dịch

Để giúp biên dịch, vui lòng giữ tên tvar càng ngắn và dễ đọc càng tốt. Nếu biên dịch viên không cần biết nội dung của họ, thì sử dụng tên được đánh số là một ý tưởng hay vì hầu hết biên dịch đều nhập chữ số nhanh chóng và phổ biến ở nhiều ngôn ngữ (vì thế mà hầu hết người mới bắt đầu không vô tình dịch chúng).

Tuy nhiên, nếu tvar nằm trong một câu thì nó phải có một tên rõ ràng để cho phép người dịch hiểu nội dung của nó và do đó dễ dàng viết nó vào đúng chỗ trong bản dịch của họ (điều này khá phổ biến đối với địa chỉ email, URL, tên thẻ trong mã wiki, v.v).

Cú pháp tốt	Cú pháp xấu
[[<tvar name="1">Special:MyLanguage/Help:Links|See help page]]	[[Special:MyLanguage/Help:Links|See help page]]
The meeting will take place on <tvar name="date">{{dateT||9|24}}</tvar> on <tvar name="software">{{int string|Zoom}}</tvar>.	The meeting will take place on <tvar name=1>{{dateT||9|24}}</tvar> on <tvar name=2>{{int string|Zoom}}</tvar>.

Avoid using spaces, underscores or letters with diacritics in tvar names as well.

Cú pháp tốt	Cú pháp xấu
<tvar name="max-count">84</tvar> cafés	<tvar name="max_count of café">84</tvar> cafés

Bản mẫu

Bạn có thể chuẩn bị một bản mẫu để dịch giống như bất kỳ trang nào, nhưng bạn phải đảm bảo hộp kiểm “Enable translation-aware transclusion for this page” được chọn khi bạn đánh dấu trang để dịch.

Nếu bạn chèn thẻ ‎<translate> bên trong giá trị tham số của lệnh gọi bản mẫu, hãy đảm bảo tham số được đặt tên (nếu không hãy thêm tên số, chẳng hạn như 1=).

Nếu bản mẫu của bạn dự kiến ​​sẽ được đưa vào các trang không thể dịch được (ví dụ: trang thành viên) và thậm chí phải được dịch trong các trang này, thì bạn có thể sử dụng bản trước năm 2021 bằng nút chuyển, thay thế uselang={{PAGELANGUAGE}} bằng uselang={{int:lang}} trong mã hiển thị bên dưới.

Mẹo trước 2021

Trước phiên bản MediaWiki 1.36.0-wmf.32 (23 tháng 2 năm 2021), bạn nên đảm bảo các trang tiếng Anh bao gồm trang phụ /en của một bản mẫu thay vì trực tiếp bản mẫu.

Một cách khác là thay thế mỗi lần xuất hiện của {{bản mẫu đã dịch của tôi|param}} bằng {{TNT|bản mẫu đã dịch của tôi|param}}, ngoại trừ trong các bản mẫu hoặc trang được nhúng nên chứa {{ {{TNTN|bản mẫu đã dịch của tôi}} |param}} thay thế.

Một cách khác là chỉnh sửa bản mẫu để biến nó tự gọi là {{TNT}}. Để làm được điều này, bạn nên đặt mã bản mẫu đầy đủ bên trong một switch đã đánh giá một thẻ ‎<translate> trống, với trường hợp mặc định được gọi là {{TNT}}.

{{#switch:<translate></translate>
|=<full template code>
|#default={{#invoke:Template translation|renderTranslatedTemplate|template={{subst:FULLPAGENAME}}|uselang={{PAGELANGUAGE}}|noshift=1}}
}}

Xem thêm

• Trang trợ giúp trên MediaWiki
• Ví dụ về bản dịch
• Writing clearly

References