Thêm Một Ngôn Ngữ Mới -- Adding a Language

Chuẩn Bị -- Preparations

Nếu ngôn ngữ bạn muốn dịch chưa được bắt đầu bởi người khác và bạn muốn tạo một tập hợp các tập tin mới cho ngôn ngữ mong muốn, chẳng hạn 'fr' (tiếng Pháp), thì trước tiên bạn phải sử dụng môi trường bạn đã tạo, như được hướng dẫn trong bản Bắt đầu -- Getting Started, với cụ thể là các phần về Lắp Đặt -- Install và Biên Dịch -- Build.

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ộ phiên dịch mới từ nguồn tiếng Anh.

  • Thực hiện lệnh make (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.

  1. 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.

  2. Đă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 Người đăng ký -- Subscribers, xin có quyền nhập kho (committer right) để chuyển các thay đổi sang kho lưu trữ trung tâm của nhóm dịch thuật.

  3. Mở một cửa sổ dòng lệnh, chẳng hạn như trình giả lập Đầu Cuối Gnome (Gnome-Terminal).

  4. 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 ở đó.

Trying the Make Process to Create HTML Files in English

  1. Hãy đảm bảo rằng cá thể trước đây của thư mục build được xóa đi, nếu nó tồn tại:

    make clean

  2. Chuyển đổi tất cả các tập tin rst thành tập tin phiên dịch pot:

    make gettext

  3. Tạo các tập tin html:

    make html

  4. 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

  1. 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).

  2. Tìm bảng về các ngôn ngữ trong biến số var all_langs = {..};.

  3. Tìm trình mục: "fr": "Fran&ccedil;ais",, ("fr": "Français"). (Lưu ý các ký tự trong bộ chữ quốc tế Unicode).

  4. Để tìm xem những thay đổi trong kho lưu trữ địa phương:

    svn status

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

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

  6. 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

  1. Mở trình soạn thảo 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:

    1
2
3
    language = 'fr'
locale_dirs = ['locale/']
gettext_compact = True

  2. 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.

  3. 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

  1. 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 tất cả các bộ 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 sẽ cần cho thêm tập hợp tập tin của riêng mình cho ngôn ngữ bạn đang định phiên dịch sang.

  2. 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 (dành cho văn bản phiên dịch) để trống.

  3. 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"

  4. Bạn không cần tất cả 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 (tập lệnh sắp đặt môi trường dòng lệnh) để thuận tiện hơn cho việc thay đổi hoặc viết tập lệnh batch/shell (thi hành đồng loạt/trình giao diện hệ thống) 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_placeholder.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ế tất cả 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 (thêm/xóa chi tiết), 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 thâ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