Hướng dẫn đóng góp bản dịch Debian Administrator's Handbook

Sun 24 April 2016 by Giáp Trần with tags huong-dan dong-gop dich

The Debian Administrator's Handbook được viết bởi hai nhà phát triển Raphaël Hertzog và Roland Mas. Là một quyển sách cầm tay hay gối đầu giường tuyệt vời cho tất cả người dùng các bản phân phối dựa trên Debian.

Cuốn sách này dạy các yếu tố cần thiết cho bất cứ ai muốn trở thành một quản trị viên Debian GNU/Linux hiệu quả và độc lập.

Tiến hành dịch như thế nào?

Kéo mã nguồn của sách về

        git clone https://github.com/Debian-VN/debian-handbook ~/debian-handbook
        cd ~/debian-handbook

Chúng ta thấy nội dung như sau:

.
├── ja-JP
├── vi-VN
│   ├── 00a_preface.po
│   ├── 00b_foreword.po
.   .   ...
.   .   ...

Và chỉ cần quan tâm các tập tin ở trong thư mục vi-VN thôi.

Mình sẽ dịch 1 đoạn trong phần 00a_preface của quyển sách này

# Giap Tran <txgvnn@gmail.com> 2016
# Tên <email> năm-dịch
msgid ""
msgstr ""
"Project-Id-Version: 0\n"
"POT-Creation-Date: 2015-10-01 20:53+0200\n"
"PO-Revision-Date: 2015-10-01 20:53+0200\n"
"Last-Translator: Automatically generated\n"
"Language-Team: Debian-VN\n"
"Language: vi-VN \n"
"MIME-Version: 1.0\n"
"Content-Type: application/x-publican; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Publican v4.3.2\n"

msgid "Preface"
msgstr "Lời nói đầu"

Đầu tiên hãy thêm tác giả dịch cho chính mình bằng chú thích # TÊN EMAIL NĂM_DỊCH.
Dịch các thông tin trong bản gốc msgid và điền vào msgstr.

Gửi đóng góp bản dịch

Tạo commit thôi

        git add vi-VN/00a_preface.po
        git commit -m 'vi-VN: translate first line in 00a_preface'

Chú ý là commit thì bắt đầu bằng vi-VN: để các bạn nước khác còn biết mà phân biệt nhé.

Đẩy lên github

    git push origin master

Travis sẽ tự động build ra PDF với mỗi commit được push lên

Bạn có thể xem log của travis để down về bản xem thử.

Như vậy là xong

[Tuỳ chọn] Bạn muốn build thử pdf,html hay epub trên chính máy bạn.

Cài đặt môi trường, tool để build

        sudo apt-get install \
        dblatex texlive texlive-xetex publican publican-debian \
        curl lmodern texlive-lang-cyrillic ghostscript \
        texlive-fonts-extra texlive-font-utils texlive-generic-recommended \
        texlive-math-extra texlive-pstricks

Build thôi

        cd ~/debian-handbook
        ./build/build-pdf --lang="vi-VN"        #build only pdf
        ./build/build-html --lang="vi-VN"       #build only html

Còn để build epub còn 1 số gói phụ thuộc nữa.