Xây Dựng bản Hướng Dẫn Sử Dụng (Building the Manual)

Việc chuyển đổi các tập tin RST sang thành các trang HTML đẹp đẽ là một việc đơn giản.

Hãy mở một thiết bị đầu cuối hay cửa sổ Nhắc lệnh, tại thư mục ~/blender_docs và đơn thuần thi hành dòng lệnh:

make

Mẹo

Trên Microsoft Windows, bạn chỉ cần mở tập tin make.bat để thi hành dòng lệnh một cách dễ dàng, mà không cần phải mở cửa sổ Nhắc lệnh và đánh các dòng lệnh.

Đây là lệnh mà bạn nên sử dụng khi xây dựng các tài liệu, song, bên cạnh đó, còn có các lệnh khác nữa mà chúng ta có thể thấy bằng việc đánh dòng lệnh "giúp đỡ về make: liệt kê thông tin về cách sử dụng công cụ make [tạo/làm/xây dựng], ví dụ như các thông số, tham số mình có thể điền và ý nghĩa, hiệu quả của chúng". Việc sử dụng lệnh tạo này sẽ cho phép chuyển đổi các tập tin RST sang thành các trang HTML, và tự động mở trình duyệt mạng mặc định của bạn để bạn có thể xem kết quả. Lệnh sẽ tiếp tục chạy ở nền và theo dõi các thay đổi được thực hiện đối với các tập tin RST và cập nhật các thay đổi, làm tươi mới lại các trang HTML khi cần thiết.

Ghi chú

Chúng ta có thể duyệt thảo các trang đã được chuyển đổi một cách thủ công, bằng cách duyệt thư mục xây dựng: ~/blender_docs/build/html nữa. Ví dụ, để mở trang chủ ra thì xin hãy mở trang build/html/index.html để đọc bản hướng dẫn sử dụng ở đó.

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 đối với những thay đổi sau này, thì quá trình sẽ chỉ kéo dài nên nhớ, cái này chỉ đúng với bản tiếng Anh mà thôi. Khi xây dựng lại các bản tiếng nước ngoài thì hầu như toàn bộ các thư mục đều phải được xây dựng lại, do sự bố trí của bản 'blender_manual.po', bao gộp toàn bộ các trang nhỏ lại thành một bản lớn, hòng tránh sự trùng lặp tràn lan một cách vô ích mà thôi.