Xây Dựng trên Hệ Điều Hành macOS -- Building on macOS¶
Chuyển đổi các tập tin RST sang các trang HTML đẹp đẽ.
Hãy mở một cửa sổ dòng lệnh tại thư mục ~/blender_docs và đơn thuần thi hành dòng lệnh:
make
Lệnh này là lệnh bạn sẽ luôn luôn sử dụng khi xây dựng các tài liệu. Quá trình xây dựng lần đầu tiên (hoặc sau những thay đổi lớn) sẽ kéo dài vài phút, song lần xây dựng sau sẽ chỉ kéo dài vài giây mà thôi.
Duyệt Thảo Bản Hướng Dẫn Sử Dụng Cục Bộ -- Viewing the Local Manual¶
Một khi các tài liệu đã được xây dựng thì toàn bộ các tập tin HTML sẽ nằm trong thư mục ~/blender_docs/build/html. Hãy thử mở thư mục build/html/index.html trong trình duyệt mạng của bạn và đọc bản hướng dẫn sử dụng ở đó:
open build/html/index.html
Lúc này là lúc bạn đã có thể bắt đầu xây dựng bản hướng dẫn sử dụng rồi. Phần tiếp theo sẽ bàn về phương pháp xây dựng nhanh chóng khác mà bạn có thể thi hành.
Xây Dựng một Chương mà thôi -- Building a Single Chapter¶
Nếu bạn, hiện tại, chỉ tập trung làm việc trên một chương cụ thể nào đó của bản hướng dẫn sử dụng mà thôi, thì bạn có thể xây dựng nó nhanh chóng dùng:
make <chapter name>
Lấy ví dụ, để chỉ xây dựng bản tài liệu về các bộ điều chỉnh thì hãy sử dụng lệnh 'make modifiers'. Sau đó, bạn có thể duyệt thảo kết quả xây dựng nhanh chóng này bằng cách mở tập tin build/html/contents_quicky.html lên.
Việc làm này, tuy sẽ xây dựng nhanh chóng, song nó cũng có nghĩa là quá trình xây dựng toàn phần sau này, bao gồm toàn bộ tất cả các chương, sẽ chậm hơn.
Tiếp tục với bước tới: Biên Soạn -- Editing.