diff options
Diffstat (limited to 'files/vi/mdn/contribute/localize/dich_trang/index.html')
| -rw-r--r-- | files/vi/mdn/contribute/localize/dich_trang/index.html | 167 |
1 files changed, 167 insertions, 0 deletions
diff --git a/files/vi/mdn/contribute/localize/dich_trang/index.html b/files/vi/mdn/contribute/localize/dich_trang/index.html new file mode 100644 index 0000000000..1e6bb6f8ba --- /dev/null +++ b/files/vi/mdn/contribute/localize/dich_trang/index.html @@ -0,0 +1,167 @@ +--- +title: Dịch trang MDN +slug: MDN/Contribute/Localize/dich_trang +tags: + - Dịch trang + - Guide + - Hướng dẫn + - MDN Meta + - l10n + - thông tin MDN +translation_of: MDN/Contribute/Localize/Translating_pages +--- +<div>{{MDNSidebar}}</div> + +<p>Bài viết này là một hướng dẫn cơ bản để biên dịch nội dung trên MDN, điều này bao gồm cả cách dịch và những thủ thuật để xử lý những loại nội dung khác nhau.</p> + +<h2 id="Bắt_đầu_một_trang_dịch_mới">Bắt đầu một trang dịch mới</h2> + +<p>Khi bạn gặp một trang mà bạn muốn dịch nó sang ngôn ngữ của bạn, hãy làm theo các bước sau:</p> + +<ol> + <li>Click vào biểu tượng Ngôn ngữ ({{FontAwesomeIcon("icon-globe")}}) để mở danh mục <strong>Languages</strong>, rồi click <strong>Thêm một bản dịch (Add a Translation)</strong>. Trang chọn ngôn ngữ sẽ xuất hiện.</li> + <li>Click vào ngôn ngữ bạn muốn dịch sang. Giao diện<strong> </strong>Dịch bài viết sẽ xuất hiện với ngôn ngữ gốc được hiển thị ở phía bên trái của màn hình hiển thị.</li> + <li>Phía dưới phần <strong>Mô tả bản dịch (</strong><strong>Translate Description)</strong>, bạn có thể dịch tiêu đề và <em>slug </em>(không bắt buộc) sang ngôn ngữ của bạn. <em>Slug </em>là phần cuối cùng của đường dẫn của trang (ví dụ, "Dich_trang" là Slug của đường dẫn của bài viết này). Một vài ngôn ngữ không dịch phần slug, hãy giữ nó giống với ngôn ngữ tiếng Anh (Với tiếng Việt, nên để tiếng Việt không dấu và thay dấu cách "<space>" bằng ký tự "_"). So sánh với những bài viết khác trên cùng ngôn ngữ của bạn để xác định được cách dịch thống nhất. Bạn có thể bấm vào dấu trừ bên cạnh <strong>Mô tả bản dịch</strong> để ẩn thông tin này đi khi bạn đã sửa xong, để có nhiều không gian hơn cho phần <strong>Nội dung bản dịch (Translate Content)</strong>.</li> + <li>Dưới <strong>Nội dung bản dịch</strong> là nơi bạn sẽ dịch phần nội dung của trang.</li> + <li>Điền ít nhất một <strong>thẻ (tag)</strong> cho trang.</li> + <li>Bấm <strong>Xuất bản</strong> khi bạn đã hoàn tất.</li> +</ol> + +<div class="note"><strong>Lưu ý:</strong> Những phần tử của trong giao diện Dịch bài viết ban đầu được hiển thị bằng Tiếng Anh. Trong những truy cập tiếp theo để dịch một bài viết, giao diện được hiển thị bằng ngôn ngữ phù hợp nếu bản dịch MDN đã có cho ngôn ngữ đó. Giao diện MDN có thể được thay đổi cho từng ngôn ngữ với <a href="https://pontoon.mozilla.org/projects/mdn/" title="https://pontoon.mozilla.org/projects/mdn/">Pontoon</a>. Xem <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Localization/Localizing_with_Pontoon" title="/en-US/docs/Mozilla/Localization/Localizing_with_Pontoon">Thay đổi cho từng ngôn ngữ với Pontoon</a> để biết thêm chi tiết về cách sử dụng công cụ này.</div> + +<h2 id="Sửa_một_trang_đã_dịch">Sửa một trang đã dịch</h2> + +<ul> + <li>Trên trang đã dịch, bấm nút <strong>Edit</strong> (đôi khi được ghi bằng ngôn ngữ đã chọn). Giao diện Dịch bài viết sẽ mở ra.</li> +</ul> + +<p>Nếu phiên bản Tiếng Anh được thay đổi kể từ khi bản dịch được thay đổi lần cuối, giao diện Dịch bài viết sẽ hiển thị những thay đổi ở bản dịch gốc bản Tiếng Anh. Điều này giúp bạn nắm được những điểm cần được cập nhật trong bản dịch.</p> + +<h2 id="Gắn_thẻ_cho_bản_dịch">Gắn thẻ cho bản dịch</h2> + +<p>Mỗi trang cần ít nhất một<em> </em>thẻ (tag). Kể cả khi đó là một bản dịch. Nhìn chung, nên sử dụng các thẻ giống với bản gốc.</p> + +<p>Một số thẻ được sử dụng cho bộ lọc tìm kiếm, hoặc như các quy ước giữa những người đóng góp. Khi đó, không nên dịch chúng. Để biết được các thẻ này, đọc <a href="/vi/docs/MDN/Contribute/Howto/Tag">các tiêu chuẩn gắn thẻ (tagging standards)</a>. Bạn có thể tạo các thẻ đã dịch để nhóm nội dung nếu thẻ đó không nằm trong các thẻ tiêu chuẩn.</p> + +<h2 id="Gợi_ý_cho_người_dịch_mới">Gợi ý cho người dịch mới</h2> + +<p>Nếu bạn là người dịch mới tham gia MDN, dưới đây là một số gợi ý:</p> + +<ul> + <li>Những bài viết trong <a href="/en-US/docs/Glossary">Glossary</a> rất dễ dịch cho những người mới, vì chúng ngắn và đơn giản.</li> + <li>Những bài được <a href="/en-US/docs/tag/l10n%3Apriority">gắn thẻ "l10n:priority"</a> nên được ưu tiên dịch. Và, nhìn chung, các bài hướng dẫn và khái niệm có độ ưu tiên cao hơn những trang tra cứu, vì người đọc chủ yếu cần các bản dịch khi học những khái niệm mới.</li> + <li>Nếu bạn thấy các chữ nằm giữa hai dấu ngoặc nhọn, ví dụ như <code>\{{some-text("more text")}}</code>, hãy để nó nguyên gốc - không dịch, không thay đổi. Đó là <a href="/en-US/docs/MDN/Contribute/Structures/Macros">macro</a>, thứ có thể tạo ra một cấu trúc trên trang, hoặc thực hiện điều có ích nào đó. Bạn có thể sẽ thấy chữ chưa được dịch được tạo ra bởi macro; đừng lo lắng về điều đó cho đến khi bạn có nhiều kinh nghiệm hơn trên MDN. (Thay đổi những chữ này yêu cầu <a href="/en-US/docs/MDN/Contribute/Tools/Template_editing">các quyền đặc biệt</a> vì các macro có thể làm được rất nhiều thứ.) Nếu bạn tò mò, xem <a href="/en-US/docs/MDN/Contribute/Structures/Macros/Commonly-used_macros">Những macros thường gặp</a> để biết những điều các macro có thể làm.</li> + <li>Kiểm tra trang <a href="/en-US/docs/MDN/Contribute/Localize/Localization_projects">Trang các dự án dịch</a> để tìm hiểu thêm về việc dịch cho vùng của bạn.</li> +</ul> + +<h2 id="Thống_nhất_tiêu_đề">Thống nhất tiêu đề</h2> + +<p>Các tiêu đề được lặp lại rất nhiều lần và yêu cầu sự thống nhất cao giữa các trang dịch (để người dùng không bị bối rối). Bên dưới là các tiêu đề tiếng Việt đã thống nhất cùng với bản gốc tiếng Anh:</p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Tiêu đề gốc tiếng Anh</th> + <th scope="col">Tiêu đề tiếng Việt</th> + </tr> + </thead> + <tbody> + <tr> + <td>Syntax</td> + <td>Cú pháp</td> + </tr> + <tr> + <td>Description</td> + <td>Mô tả</td> + </tr> + <tr> + <td>Examples</td> + <td>Ví dụ</td> + </tr> + <tr> + <td>Polyfill</td> + <td>Polyfill</td> + </tr> + <tr> + <td>Specifications</td> + <td>Đặc tả</td> + </tr> + <tr> + <td>Browser compatibilities</td> + <td>Trình duyệt hỗ trợ</td> + </tr> + <tr> + <td>See also</td> + <td>Xem thêm</td> + </tr> + <tr> + <td>Parameters</td> + <td>Tham số</td> + </tr> + <tr> + <td>Return value</td> + <td>Giá trị trả về</td> + </tr> + </tbody> +</table> + +<div class="note"> +<p>Vui lòng sửa bài này để thêm các tiêu đề thống nhất trong bảng trên.</p> +</div> + +<h2 id="Các_mẫu_dịch_hay_dùng">Các mẫu dịch hay dùng</h2> + +<p>Bên dưới là các chuỗi văn bản xuất hiện thường xuyên trong nhiều trang dịch. Các chuỗi này thường gặp trong các trang tra cứu đặc tả và cú pháp mà có nhiều nội dung tương đồng với nhau. Các mẫu dịch này để tham khảo và giúp tăng tốc việc dịch, người dịch không bắt buộc phải viết lại giống hoàn toàn:</p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Bản gốc tiếng Anh</th> + <th scope="col">Chuỗi văn bản tiếng Việt</th> + </tr> + </thead> + <tbody> + <tr> + <td> + <p><code>[ECMA feature]</code> was added to the ECMA-262 standard in the 5th edition; as such it may not be present in all implementations of the standard. You can work around this by inserting the following code at the beginning of your scripts, allowing use of <code>[ECMA feature]</code> in implementations which do not natively support it. This algorithm is exactly the one specified in ECMA-262, 5th edition, assuming <code>[Object 1]</code>, <code>[Object 2]</code>, and <code>[Object 3]</code> have their original values.</p> + </td> + <td><em>[Trong phần Polyfill]</em><br> + <code>[ECMA feature]</code> chỉ được thêm vào đặc tả ECMA-262 với phiên bản lần thứ 5; cho nên nó có thể không tồn tại trong một số hiện thực (implementation) của đặc tả. Bạn có thể work around bằng cách thêm vào đoạn code bên dưới vào đầu script của bạn, cho phép sử dụng hàm <code>[ECMA feature]</code> tại những nơi mà nó không được hỗ trợ sẵn. Giải thuật trong polyfill này tương đương với <code>[ECMA feature]</code> được mô tả trong đặc tả ECMA-262, 5th edition với điều kiện <code>[Object 1]</code>, <code>[Object 2]</code>, và <code>[Object 3]</code> không bị thay đổi.</td> + </tr> + <tr> + <td>iterable object</td> + <td>đối tượng khả duyệt</td> + </tr> + <tr> + <td>Prerequisites</td> + <td>Điều kiện tiên quyết</td> + </tr> + <tr> + <td>associative array</td> + <td>mảng liên kết</td> + </tr> + <tr> + <td>string literal</td> + <td>string literal<br> + <sub>(có nguồn dịch là <em>hằng chuỗi, chuỗi trực kiện</em>, tuy nhiên sẽ gây khó hiểu, nên thống nhất không dịch)</sub></td> + </tr> + <tr> + <td>object literal</td> + <td>object literal <sub>(không dịch)</sub></td> + </tr> + <tr> + <td>array literal</td> + <td>array literal <sub>(không dịch)</sub></td> + </tr> + </tbody> +</table> + +<div class="note"> +<p>Vui lòng sửa bài này để thêm các đoạn dịch mẫu trong bảng trên.</p> +</div> + +<h2 id="Xem_thêm">Xem thêm</h2> + +<ul> + <li><a href="https://gitter.im/mdn-vi-l10n/">Nhóm bản địa hóa MDN trên Gitter</a>: hãy tham gia để cùng trao đổi cách dịch các thuật ngữ.</li> +</ul> |