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 make help. Lệnh này sẽ 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 vài giây mà thôi.