You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Đối với người dùng Mac OSX, asciidoc có thể được cài bằng port hoặc brew. Còn Inkscape, bạn có thể download và cài từ website chính thức của Inkscape
Biên Dịch và Xem Thử Bằng HTML
make html
http-server
http-server là lệnh command line để tạo một thư mục web ảo để xem với localhost trên trình duyệt. Lệnh này có thể được cài với $ sudo npm install --global http-server
Quy Ước Văn Bản Dịch
Sử dụng tiếng Việt Unicode dựng sẵn (mặc định với hầu hết các bộ gõ)
Ngắt dòng bằng tay và canh chiều rộng 70 cho cột văn bản. Lý do là đoạn văn nằm trên nhiều dòng sẽ dễ so sánh những chỉnh sửa thông qua trình quản lý phiên bản và trên Github.
Những thuật ngữ chưa có từ tiếng Việt tương đương có thể được giữ nguyên từ tiếng Anh. Chúng ta sẽ thêm phần phục lục để giải thích hoặc tạo 1 wiki để trao đổi và lần lượt dịch các thuật ngữ khó.
Hỗ Trợ Người Dịch
SublimeText
Đây là chương trình xử lý code và văn bản thuần rất mạnh, chạy trên tất cả các HĐH chính. Các plugin và cài đặt sau sẽ giúp cho việc biên soạn và dịch bài thuận tiên hơn:
Cài plugin Asciidoctor để hỗ trợ highlight cho cú pháp của ASCIIDoc
Cài plugin AutoWrap để tự ngắt dòng khi hết chiều rộng cột
Cài đặt chiều rộng cột 70 trong menu: View > Ruler > 70
Chạy lệnh Edit > Wrap > Wrap paragraph at ruler (Cmd + Option + Q) để điều chỉnh lại đoạn văn cho vừa chiều rộng cột
Nhập Môn ASCIIDOC
Mã nguồn của quyển sách này được viết bằng ASCIIDoc, một chuẩn văn bản có quy ước định dạng bằng text thuần. Để tiện cho người dịch dễ tiếp cận, sau đây là ghi chú về một số cú pháp định dạng hay dùng trong sách: