Help:Extension:Translate/Page translation example/vi

Chào mừng các bạn! Sau khi đọc xong hướng dẫn này bạn sẽ biết làm thế nào để tạo và quản lý các trang dịch sử dụng Mở rộng dịch. Chủ đích của chúng tôi là viết bài hướng dẫn này càng ngắn, càng súc tích càng tốt, khi giới thiệu các khái niệm và tác vụ cơ bản. Sau khi đọc xong hướng dẫn này các bạn có thể sử dụng tài liệu chuyên sâu về tính năng dịch trang. We aim to keep this tutorial as short as possible, while introducing all the basic concepts and tasks. After completing this tutorial you can use the in-depth documentation about page translation feature.

Bước 1: Trước khi bắt đầu
Hướng dẫn này giả định mở rộng Dịch đã được cài và cấu hình. Có thể bạn đã có một trang ở trong đầu cầu được dịch, hoặc bạn có thể sử dụng trang ví dụ được cho dưới dây để thử các bước trong hướng dẫn này "trong chính wiki của bạn" Maybe you already have a page in mind that needs translation, or you can use the example page provided below to try out the steps in this tutorial in your own wiki.

Đây là trang miêu tả đô thị tưởng tượng của Fréttinga.

Here is the wikicode associated to it :

Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. == Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.


 * 1. Vào trang Fréttinga trong wiki của bạn và click vào nút create (Tạo).
 * 2. Dán nội dung ở trên vào và lưu lại.

Bước 2: Chuẩn bị
Bây giờ chúng ta có một trang có văn bản. Nếu trang này vẫn đang trong quá trình có nhiều thay đổi, tốt hơn hết là chờ cho đến khi việc biên tập chậm xuống đến mức độ bình thường trước khi thêm trang này vào hệ thống dịch. Điều này để tránh quá nhiều việc cho người dịch khi họ cần duy trì theo dõi với tất cả các thay đổi.

If the page is still going to be subject to lots of changes, it may be better to wait until the edits slow down to a normal level before adding the page into the translation system. This is to avoid too much work for translators as they need to keep up with all the changes.

The page is ready for translation ? So let's see how to request translation :


 * 3. Biên tập Fréttinga
 * 4. Đóng gói tất cả nội dung bên trong các thẻ &lt;translate>...&lt;/translate> như chỉ ở bên dưới đây
 * 5. Lưu trang lại

 Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. == Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. 

You don't need to add tags to all elements, or add markers like ; the extension does it for you.

Bước 3: Cho phép dịch
Sau khi lưu trang này, bạn sẽ thấy một liên kết ở phía trên đầu của trang ý nói "Đánh dấu trang này để dịch" (hoặc "Trang này chứa các thay đổi không được đánh dấu cho việc dịch." nếu bạn không phải là một quản trị viên dịch thuật̠). Click vào liên kết đó. Trang này sẽ tự động chia làm 4 đơn vị dịch. Đơn vị đầu tiên là tiêu đè của trang, thứ hai là đoạn văn đầu tiên, thứ ba là phần đầu của đoạn văn thứ hai, thứ tư là nội dung của đoạn văn thứ hai. Đó là những mục cơ bản của các trang có thể dịch đượcː mỗi đơn vị là độc lập; nó có thể và phải được dịch toàn bộ; những thay đổi trong nội dung trang được đánh đấu vào mức của đơn vị. Các đơn vị có thể sắp xếp lại hoặc xóa bỏ. If you are a translation administrator, then click on the "Mark this page for translation" link. The page has been automatically split into four translation units. The first unit is the title of the page, the second is the first paragraph, the third is the header of the second paragraph, and the fourth is the text of the second paragraph. These are the basics items of translatable pages: each unit is independent; it can and must be translated as a whole; changes to the page content are tracked into the unit level. Units can be rearranged or deleted.

Ngoài ra còn có một giao diện trang dịch mẫu; cái này sẽ được đề cập trong các bước sau. Bạn có thể đặt tên cho các đơn vị dịch thuật, nhưng trong ví dụ này, chúng tôi chọn giá trị mặc định.

(reminder: you have to be a Translation administrator for this)
 * 6. Click vào liên kết "Đánh dấu trang này để dịch"
 * 7. Chắc chắn rằng phần thân của trang được chia chính xác thành ba đơn vị
 * 8. Click vào nút "Đánh dấu trang này để dịch"
 * 9. Quay trở lại trang đầu
 * 9. Return to the page

Bây giờ bạn sẽ thấy một liên kết mới ở trên cùng, "Dịch trang này", cho phép người dịch dịch trang đó. Bạn có thể xem qua tại hướng dẫn dịch trong đó sử dụng trang này như một ví dụ và kiểm ta vài bản dịch luôn. Sau đó quay trở lại đây để thực hiện bước tiếp theo.

Understanding how changes are impacting translations and translations units
Theo dõi các thay đổi là một tính năng rất quan trọng, vì vậy chúng ta hãy làm một số thay đổi và xem nó hoạt động như thế nào. Khi bạn mở trang để chỉnh sửa, bạn sẽ thấy rằng nó đã được sửa đổi với các dấu hiệu như. Chúng được bổ sung bởi chương trình mở rộng (extension) và giúp nó xác định được đơn vị nào cần tìm. Điều này cho phép bạn sắp xếp và chỉnh sửa những đơn vị này. Khi chỉnh sửa trang, các dấu hiệu cần được ở một mình và vị trí của chúng trong quan hệ với đơn vị mà chúng thuộc về không nên thay đổi. Khi di chuyển một đơn vị, di chuyển điểm đánh dấu đơn vị, quá. Khi xóa một đơn vị, cũng nên di chuyển đánh dấu đơn vị luôn. Khi thêm đoạn văn bản mới, các đánh dấu mới sẽ được bổ sung bởi các phần mềm. Đừng cố gắng thực hiện điều này thủ công, nó có thể gây nhầm lẫn cho phần mềm. These are added by the extension and help it identify which unit is which. This allows you to rearrange and edit those units. When editing the page, the markers should be left alone and their position in relation to the unit they belong to should not be changed. When moving a unit, move the unit marker, too.

When deleting a unit, delete the marker too. When adding new paragraphs, new markers will be added by the software. Do not try to do this manually, it may confuse the software. Markers you have deleted will also be automatically deleted by the bot in the existing translations.

If you do minor changes to an existing translation unit (adding a few words or a link to a paragraph), keep the marker. If you change a whole paragraph (delete and rebuilt it), delete the marker. This way, translators will have different tasks, between reviewing a fuzzy translation or create a new translation.

let's modify something !
Here is what you will do :

(reminder: you have to be a Translation administrator for this)
 * 10. Thực hiện vài bổ sung như nhấn mạnh ở trên
 * 11. Click vào liên kết "Đánh dấu để dịch" ở trên cùng
 * 12. Quan sát các thay đổi
 * 13. Click vào nút "Đánh dấu để dịch"
 * 14. Quay trở lại trang gốc
 * 14. Return to the original page

Nếu bạn dịch theo các bước hướng dẫn như trên, bạn có thể xem phần dịch đó được liên kết tại trên cùng của trang luôn. Bạn sẽ cũng thấy ràng phần dịch không được cập nhật 100̥. Nếu bạn nhìn vào phiên bản đã dịch, bạn sẽ thấy đoạn văn mới bằng tiếng Anh, và các đoạn văn đã thay đổi sẽ thay bằng văn bản tiếng Anh. Nếu bạn đi tới phần xem bản dịch, bạn sẽ thấy rằng đơn vị này đã được đánh dấu là đang gặp vấn đề tải lên.

Các bản dịch lỗi thời được thay thế bằng văn bản tiếng Anh; người dùng được nói rằng việc dịch chưa hoàn thành.

Việc xem mẫu dịch giúp bạn để xem những phần nào của trang là không đổi trong tất cả các phiên bản ngôn ngữ ("trang dịch mẫu", tức là các phần nằm bên ngoài thẻ dịch) và cũng cho bạn thấy nếu các đơn vị đã được di chuyển đi nơi khác hoặc bị xóa.

Có thể có một chút chậm trễ trước khi tất cả các phiên bản dịch được cập nhật, vì có thể có nhiều trang đang cập nhật.

Bây giờ bạn đã biết những điều cơ bản, nhưng hướng dẫn này sẽ tiếp tục với nhiều điều mà bạn có thể gặp phải.

Adding an image, a category and a list with translation markers
You have a basic translatable page now, but it is very dull. Let's add an image and some other stuff to make it look more like a normal wiki page and see how those elements interact with translation.

We also removed a paragraph, including its unit marker, and replaced it with a list, so you can see what happens.


 * 15. Thêm một hình ảnh, một thư mục và một danh sách vào trang đó như sẽ chỉ dưới đây
 * 16. Lưu trang đó lại
 * 17. Click vào liên kết "đánh dấu để dịch" ở trên cùng của trang
 * 18. Kiểm tra rằng các thay đổi có giống ý định của bạn hay không
 * 19. Click vào nút nhấn "Đánh dấu phiên bản này để dịch"
 * 20. Quay trở lại trang gốc

Document a translation
Here you can see that we left most of the image markup outside of a translation unit and have it in the translation page template instead. (reminder: the translation page template doesn't change between the different translated pages) This is usually okay, but sometimes translators may want to change the image, especially if it contains linguistic content (text). In those cases it's usually easiest to include the whole markup in a unit (as we did for the category).

When the translation of a unit involves or interacts with markup it's a good idea to write a small tip to the translators about it. You can do this with the following steps.


 * 21. Click vào liên kết "Dịch trang này" ở trên cùng
 * 22. Chọn ngôn ngữ "qqq - Trang tài liệu"
 * 23. Click vào tên thông điệp có chứa nội dung "Một góc nhìn tiêu biểu về Fréttinga"
 * 24. Viết "Miêu tả về một hình ảnh" và nhấn "Lưu"

Now, the documentation "Description of an image" is shown next to the to-be-translated-title of the image.

About links
Similarly, for links there are many ways to do it. We used " Special:MyLanguage/Seagull ", which automatically redirects to the translated version of the page depending on the users' interface language (if that translation exists). This isn't an ultimate solution, because users will always be redirected to the interface language they are using, not to the language they are currently reading. Special:MyLanguage also interferes with Special:WhatLinksHere and makes it not work. The good thing about Special:MyLanguage is that you always get some version of the page, even if the requested translation doesn't exist.

About categories
In this example, the whole category assignment is a translation unit. This lets translators change it to or whatever naming convention you want to use for categories. If it were outside the translation template, you would have all the pages Foo, Foo/de, Foo/ru, Foo/ta and so on in the same category. Sometimes this is okay, but usually it distracts the users. Make sure your translators know what the local convention is.

About titles
To have titles considered as separated elements than text, don't forget to add a blank line (if there isn't one already) between the title and the paragraph following it.

The following example will only create one translation unit:

== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

The next one will create two translation units, including one for the title.

== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

Adding a blank line allows translators to know when they can take a break. Plus it prevents issues with wikitext.

Operating on the whole page and its translations
It is also possible to move translatable pages including all their translations to a new name. Because many pages may need to be moved, this operation is not instant. You can delete either the whole page including all translations, or just one translated version of a page. You can access these functions from the same place they are on all other pages.

Managing all wiki's pages translations with Special pages
Special:PageTranslation lists all the pages in the system. Besides giving you an overview of all translatable pages, it is also possible to discourage pages from translation. This hides the page from most lists. It does not prevent further translations.

Now, you know !
You have now created a translatable page and tried all of the common actions that can be performed on translatable pages.

Going deeper ?
For more information, or if you want to understand the feature more deeply, please continue reading on the in-depth documentation of page translation feature. It also contains discussion about different ways of handling links, categories and templates, or pros and cons of using larger or smaller translation units.