Thêm Một Ngôn Ngữ Mới (Adding a Language)

Chuẩn Bị (Preparations)

If the language you want to translate has not been started by someone else already and you wish to create a set of new files for the desired language, say 'fr' (French), then you must first use the environment you have created, as guided in Getting Started, in particular Cài Đặt các Phụ Thuộc (Installing Dependencies) and Xây Dựng bản Hướng Dẫn Sử Dụng (Building the Manual) sections.

Việc làm này sẽ cung cấp cho bạn một môi trường cơ bản cho việc:

Tạo một bộ ngôn ngữ phiên dịch mới từ nguồn tiếng Anh.
Thực hiện lệnh 'tạo' để biến các văn bản đã dịch thành các tập tin po thành các tập tin html để thử nghiệm cục bộ.
Cập nhật các thay đổi trong văn bản tiếng Anh đã được các cộng tác viên khác thêm vào.

Ví dụ dưới đây cho thấy quá trình tạo một bộ các tập tin mới cho tiếng Pháp, mã Ngôn ngữ fr, trên hệ điều hành Linux. Các hệ điều hành khác có thể biến đổi một đôi chút song về nguyên lý thì hoàn toàn giống nhau.

Vào trang https://developer.blender.org để tạo tài khoản cho chính bản thân và trở thành nhà phát triển/dịch giả cho tổ chức Blender.
Đăng nhập vào tài khoản và tạo một tác vụ với thể loại 'todo', liên lạc với một quản trị viên trong trường "Subscribers", yêu cầu được cung cấp committer right để có thể chuyển các thay đổi vào kho lưu trữ trung tâm của nhóm dịch thuật.
Mở một cửa sổ dòng lệnh, chẳng hạn như Gnome-Terminal emulator.
Chuyển thư mục từ thư mục làm việc hiện tại vào thư mục blender_docs, nơi có bản Makefile nằm ở đó.

Thử Nghiệm Biên Dịch để Tạo các Tập Tin HTML trong Tiếng Anh (Trying the Make Process to Create HTML Files in English)

Hãy đảm bảo rằng thư mục build được xóa đi, nếu nó tồn tại:
```
make clean
```
Chuyển đổi toàn bộ các tập tin rst thành tập tin phiên dịch pot:
```
make gettext
```
Tạo các tập tin html:
```
make html
```
Sau việc làm này, bạn có thể xem các tập tin HTML được kiến tạo cục bộ, rồi làm theo hướng dẫn chỉ ra, chẳng hạn như:
```
xdg-open <path to your English manual>/blender_docs/build/html/index.html
```

Tạo Trình Mục cho Ngôn Ngữ trong Trình Đơn HTML (Creating the Language Entry in the HTML Menu)

Tạo một trình mục cho ngôn ngữ trong trình đơn html bằng cách mở tập tin ./resources/theme/js/version_switch.js (giả định là bạn đang ở thư mục nhánh blender_docs).
Tìm bảng về các ngôn ngữ trong biến số var all_langs = {..};.
Tìm trình mục: "fr": "Français",, ("fr": "Français"). (Lưu ý các ký tự trong bộ chữ quốc tế Unicode)
Để tìm xem những thay đổi trong kho lưu trữ Địa Phương:
```
svn status
```

Điền mật mã của bạn:

svn commit --username <your username> -m "your comment"

Nâng cấp kho lưu trữ cục bộ của bạn lên phiên bản thay đổi gần đây nhất, bao gồm cả thay đổi bạn vừa thực hiện xong:
```
svn update .
```

Tạo tập tin cấu hình cục bộ (Setting the Local Configuration File)

Mở trình biên soạn văn bản để nhập các văn bản sau, thay đổi mã ngôn ngữ thành mã ngôn ngữ nào mà bạn sẽ phiên dịch sang:
```
1language = 'fr'
2locale_dirs = ['locale/']
3gettext_compact = True
```
Lưu tập tin này thành conf.py trong thư mục blender_docs, nơi tập tin Makefile nằm.
Yêu cầu svn bỏ qua tập tin này khi thực hiện các thao tác bằng cách thi hành lệnh này:
```
svn propset svn:ignore conf.py .
```

Sinh Tạo Bộ Tập Tin cho Ngôn Ngữ Dự Định (Generating the Set of Files for the Target Language)

Xuất kho bản dịch hiện tại bằng cách sử dụng lệnh:
```
svn checkout https://svn.blender.org/svnroot/bf-manual-translations/trunk/blender_docs/locale
```
Việc làm này sẽ tải về toàn bộ các ngôn ngữ có sẵn trong kho lưu trữ xuống thư mục locale của ổ đĩa của bạn. Bạn có thể vào thư mục locale để xem thư mục con ẩn .svn nằm bên trong đó cùng với các thư mục ngôn ngữ. Bạn cần phải cho thêm tập hợp tập tin của ngôn ngữ mà bạn đang có ý định phiên dịch sang.
Từ thư mục blender_docs để tạo bộ các tập tin cho ngôn ngữ fr:
```
make gettext
sphinx-intl update -p build/locale -l fr
```
Những tập tin này vẫn còn nằm trong Tiếng Anh mà thôi, với các dòng 'msgstr' vẫn còn trống.

Nhập kho bộ tập tin mới vào kho lưu trữ trung tâm:

cd locale
svn add fr
svn commit --username <your username> -m "Initial commit language set of files for French"

Bạn không cần toàn bộ các ngôn ngữ khác nằm ở đó, vì vậy hãy tạm thời xóa thư mục locale đi:
```
rm -fr locale
```
Chúng ta sẽ tải xuống bộ ngôn ngữ mới này như được hướng dẫn trong phần tiếp theo.

Ghi chú

Bạn nên tạo hai biến môi trường cho các thư mục này, trong tập tin '.bashrc' để thuận tiện hơn cho việc thay đổi hoặc viết tập lệnh batch/shell cho quá trình dịch và xem xét kết quả:
```
export BLENDER_MAN_EN=$HOME/<directory to make file directory above>/blender_docs
export BLENDER_MAN_FR=$BLENDER_MAN_EN/locale
```
Các tập tin mới được tạo sẽ chứa một số từ dùng làm chỗ đứng cho các thông tin như tên tác giả và ngày sửa đổi, v.v. Nếu bạn thấy công việc thay thế chúng là nhàm chán, lặp đi lặp lại, thì hãy sao chép tập lệnh change_placeholders.sh trong thư mục con ~/blender_docs/toos_maintenance thành một bản sao và đưa vào thư mục bin cục bộ, thay thế toàn bộ các giá trị đã được đề cập đến trong tập tin bằng các chi tiết cụ thể của mình. Sau đó, sau mỗi lần thay đổi tập tin xảy ra, bạn sẽ cho thi hành dòng lệnh sau đây để cập nhật tập tin với các thông tin cá nhân, ngày và giờ sửa đổi, cùng với việc tạo các tập tin HTML cho ngôn ngữ của bạn, và có thể xem chúng bằng trình duyệt mạng Internet của mình:
```
$HOME/bin/change_placeholders.sh $BLENDER_MAN_FR
make -d --trace -w -B -e SPHINXOPTS="-D language='fr'" 2>&1
```