# Hướng dẫn dịch của Moodle

Biên dịch Moodle thì không quá khó, nhưng một số điều sau đây bạn nên biết trước khi bắt đầu.

## Cấu trúc của gói ngôn ngữ Moodle

Tất cả các gói ngôn ngữ của Moodle đều được đặt ở trong thư mục lang, với mỗi ngôn ngữ trong một thư mục duy nhất được đặt tên tương tự tên rút gọn của ngôn ngữ đó (en, fr, nl, es ...).

Tất cả các file chính đều trong danh mục này , với các phần mở rộng là .php ( ví dụ moodle.php, resource.php vân vân). Tất cả những file này đều chứa cụm từ rút gọn, thường được gọi là "các chuỗi".

Cũng có một số danh mục chứa các trang web với phần mở rộng .html :

- help: chứa các file trợ giúp phù hợp với ngữ cảnh mà khi bạn kích vào các biểu tượng trợ giúp thì nó sẽ hiển thị ra đối với người dùng
- docs: Chứa các trang tài liệu cơ bản ( ví dụ trang này là một ví dụ )

## Tạo một gói ngôn ngữ mới hoàn toàn

Nếu ngôn ngữ của bạn chưa được hỗ trợ bởi Moodle, hoặc nếu bạn muốn tạo một tạo một số tuỳ chọn cho giao diện; site của bạn, bạn có thể bắt đầu một bản dịch mới.;

Tất cả những việc bạn cần làm là tạo ra một danh mục mới trong thư mục lang bởi việc sử dụng quy tắc 2 chữ cái cho ngôn ngữ của bạn. Bạn có thể tìm thấy tập hợp các quy tắc chuẩn trong lib/languages.php. Nếu bạn đang làm một sự biến đổi cục bộ của ngôn ngữ khác sử dụng quy tắc của ngôn ngữ đó với một gạch dưới và một phần phần mở rộng từ gồm 2 chữ cái (ví dụ pt đối với Portuguese và pt_br đối với biến tố Brasilian của gói ngôn ngữ Portuguese ). Nếu bạn đang tạo một phiên bản Unicode thêm vào _utf8ở cuối ( ví dụ sr_utf8).

Tiếp theo, copy moodle.php từ ngôn ngữ khác vào trong thư mục mới của bạn. Tốt nhất bạn nên copy nó từ danh mục "en" nhưng nó không phải là chính khi mà bạn đang viết lại nó theo bất kỳ cách nào .

Bây giờ bạn bắt đầu chèn một chuỗi mới bởi soạn thảo ngôn ngữ của bạn.. xem chi tiết điều này dưới đây.

Đối với một gói ngôn ngữ mới, điều đầu tiên bạn cần soạn thảo là chuỗi đặt tên là "thischarset" trong moodle.php. Nó phải chứa một tập các ký tự web hợp lệ cho ngôn ngữ của bạn. Sau đó bạn thay đổi chuối đó, cất file moodle, sau đó nạp lại trang. Tiếp đến bạn có thể tiếp tục với phần còn lại của các chuỗi.

## Soạn thảo một gói ngôn ngữ đã tồn tại

### Tạo một số tuỳ chọn nhỏ

Nếu bạn muốn thay đổi một số thứ trong giao diện để cho nó phù hợp với site của bạn hơn, không nên bắt đầu soạn thảo một trong những gói ngôn ngữ chuẩn. Nếu bạn làm điều đó thì những thay đổi của bạn sẽ ghi đè khi bạn nâng cấp nó thành một Moodle mới.

thay cho việc này, sử dụng các hướng dẫn ở trên để tạo một gói ngôn ngữ mới toanh, và đặt ngôn ngữ gốc (trong moodle.php) thành ngôn ngữ mà nó giống của bạn. Ví dụ , một tên tốt nhất đối với phiên bản tiếng anh cục bộ sẽ là "en_local", và ngôn ngữ gốc khi đó sẽ là "en" hoặc "en_us".

Chú ý rằng để mọi người trên site của bạn nhìn thấy gói mới này bạn cần phải lựa chọn nó như là ngôn ngữ của site và hạn chế các ngôn ngữ có sẵn trên Quản trị >> Cấu hình >>Các thông số cấu hình.

### Dịch các file ngôn ngữ giao diện của Moodle( các file "chuỗi" )

1. Nhập vào hệ thống Moodle của bạn như là một quản trị viên.
2. Đi tới Quản trị >> Cấu hình >> Ngôn ngữ, nó là trang quản trị ngôn ngữ.
3. Trên trang này bạn có thể chọn ngôn ngữ của bạn từ danh sách các ngôn ngữ, sau đó chọn " So sánh và soạn thảo ngôn ngữ".
4. Bạn nên xem các biểu mẫu mà bạn có thể soạn thảo cho mỗi file. Nếu bạn không làm nó, thì bạn có thể có một số đảm bảo rằng các file có khả năng được ghi - bạn có thể thay đổi các sự cho phép file.
5. Các biểu mẫu bao gồm 3 cột, đầu tiên là tên của mỗi chuỗi , thứ hai là chuỗi theo tiếng anh, và cuối cùng là bản dịch sang ngôn ngữ hiện hàn.
6. Soạn thảo các chuỗi thiếu trong mỗi file ( được làm nổi bật theo màu sắc), Ghi nhớ rằng kích hoạt nút "Cất tất cả những thay đổi" ở cuối của mỗi biểu mẫu.
7. Nó đồng ý để lại các chuỗi trống - Moodle sẽ sử dụng ngôn ngữ gốc để thay thế những chuỗi đó. Bạn có thể định nghĩa ngôn ngữ gốc trong moodle.php, mặt khác tiếng anh luôn luôn được sử dụng theo mặc định.
8. Một cách nhanh để xem tất cả các chuỗi thiếu là sử dụng nút "Kiểm tra các chuỗi thiếu".

### Dịch các file trợ giúp và các file tài liệu

Chưa có trình biên dịch được xây dựng trong Moodle để biên dịch các file trợ giúp , nhưng nó không quá khó. Quan trọng là sử dụng gói ngôn ngữ en như là một ngôn ngữ tham khảo. Copy một file trợ giúp từ gói ngôn ngữ en và paste nó vào vị trí tương tự trong gói ngôn ngữ của bạn. Sau đó sử dụng một trình soạn thảo văn bản thuần tuý để biên dịch file, đảm bảo rằng không thay đổi bất kỳ đoạn mã nào trong file file (thường nó không có mã, chỉ là các thẻ HTML). ( Đừng sử dụng một bộ xử lý văn bản để ghi những file trợ giúp đó bởi vì những chương trình đó sẽ thêm nhiều đoạn không có giá trị vào những file đó).

Nhấn chuột vào "Kiểm tra các chuỗi thiếu" trong màn hình quản trị ngôn ngữ của bạn nó sẽ chỉ ra cho bạn biết những file nào đang thiếu. Nếu bạn có thiếu một số file thì Moodle sẽ sử dụng ngôn ngữ gốc để thay thế , vì thế không cần thiết để lại những bản copies các file trợ giúp không được dịch trong gói ngôn ngữ của bạn.

## Gửi gói ngôn ngữ của bạn tới dự án Moodle

Chia sẻ bản dịch của bạn với Moodle để giúp đỡ những người nói tiếng của bạn có thể hiểu được. Ngôn ngữ giao diện của bạn sẽ có sẵn trong các phiên bản tương lai của Moodle.

Lưu trữ đơn giản toàn bộ thư mục ngôn ngữ mới của bạn như là một file zip và email nó tới translation@moodle.org.

Chúng tôi sẽ đưa cho bạn những chi tiết khác.

## Duy trì một gói ngôn ngữ chuẩn

Nếu bạn tận tâm duy trì một ngôn ngữ trong Moodle, tốt nhất sử dụng Moodle CVSvới mục đích bạn có một phiên bản được cập nhật thường xuyên của Moodle, và có thể dễ dàng "kiểm tra" trực tiếp những thay đổi của bạn trong dự án Moodle. Liên lạc lại với translation@moodle.org Nếu bạn cần các trợ giúp.

Bạn cũng phải tham gia vào Diễn đàn các ngôn ngữ để có thêm tin tức và thảo luận về các vấn đề nó rất hữu ích đối với các bản dịch.

Cuối cùng, để duy trì những thay đổi trong dự án của bạn từng ngày, tốt nhất bạn nên tham gia vào danh sách địa chỉ thư CVS . Điều này giúp duy trì bản dịch của bạn đến khi kết thúc văn bản tiếng anh.

Tài liệu của Moodle

Phiên bản: $Id$