Cài đặt trên Windows

Hướng dẫn này bao gồm các chủ đề sau:

  1. Cài đặt Python -- Installing Python (được sử dụng để "chuyển đổi" các tập tin nguồn sang định dạng HTML)

  2. Cài Đặt SVN và Tải Kho Lưu Trữ về Máy -- Installing SVN and Downloading the Repository

  3. Thiết Lập Môi Trường Biên Dịch -- Setting up the Build Environment

Cài Đặt Python

  1. Tải xuống máy Gói cài đặt Python -- Python installation package -- dành cho Windows. Trong hướng dẫn này phiên bản 3.9.x sẽ được sử dụng.

  2. Cài đặt Python bằng trình hướng dẫn cài đặt. Xin vui lòng đảm bảo rằng bạn đã bật tùy chọn Thêm Python vào PATH -- Add Python to PATH:

    ../../../_images/about_contribute_install_windows_installer.png

    Tùy chọn phải được bật lên để bạn có thể biên dịch bản hướng dẫn sử dụng bằng tập lệnh make.

    Toàn bộ các cài đặt khác có thể vẫn để như Sắp đặt mặc định.

Cảnh báo

Python 3.10 là phiên bản chưa được hỗ trợ. Chúng tôi đề cử là các bạn nên sử dụng phiên bản Python 3.9 hoặc trước đó thôi nhé.

Cài Đặt SVN và Tải về Máy Kho Lưu Trữ

Trong hướng dẫn này, chúng tôi sẽ sử dụng TortoiseSVN, mặc dù bất kỳ trình khách ứng dụng Subversion nào cũng có thể sử dụng được.

  1. Tải xuống máy bản TortoiseSVN dành cho Windows.

  2. Cài đặt TortoiseSVN bằng trình hướng dẫn cài đặt. Khi chọn các tính năng sẽ được cài đặt thì bạn nên cho bật các công cụ trình khách dòng lệnh lên để cho phép mình truy cập vào SVN từ dòng lệnh (thực hiện việc này không có gì hại cả, song ngược lại, có thể lại rất hữu ích, đặc biệt là nếu bạn gặp phải bất kỳ rắc rối nào trong khi làm nữa).

  3. Sau khi cài đặt xong, hãy tạo một thư mục mới để chứa tất cả mọi thứ liên quan đến Bản Hướng Dẫn Sử Dụng Blender. Trong hướng dẫn này, chúng ta sẽ sử dụng thư mục C:\blender_docs nhé.

  4. Mở thư mục mới, nhấp chuột phải và chọn SVN Checkout ... từ trình đơn Ngữ Cảnh.

  5. Trong ô URL of repository, làm ơn điền: https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs.

  6. Trong ô Checkout directory, làm ơn điền: C:\blender_docs.

  7. Nhấp vào OK, kho lưu trữ sẽ được tải xuống ngay lúc này, có thể phải đợi mất vài phút, tùy thuộc vào chất lượng đường kết nối Internet của bạn.

Thiết Lập Môi Trường Biên Dịch

  • Mở một Nhắc Lệnh. (Chạy trong chế độ Người Quản Trị Hệ Thống)

  • Bước vào thư mục blender_docs vừa được kiến tạo và bổ sung bởi việc kiểm xuất (checkout) SVN:

    cd C:\blender_docs

  • Bên trong thư mục đó có một tập tin với cái tên 'requirements.txt', và trong đó có chứa một Danh Sách Toàn bộ các phần mềm phụ thuộc mà chúng ta cần phải có. Để cài đặt các phụ thuộc này, chúng ta có thể sử dụng lệnh 'pip' như sau:

    pip install -r requirements.txt

  • Nếu mọi việc xảy ra trôi chảy thì bạn sẽ thấy thông báo sau khi nó hoàn thành:

    Successfully installed Jinja2 MarkupSafe Pygments Sphinx docutils sphinx-rtd-theme Cleaning up...

Trong khi thiết lập, một số cảnh báo có thể xuất hiện, nhưng đừng lo lắng về chúng. Đương nhiên, nếu có bất kỳ lỗi nào xảy ra, chúng có thể gây ra một số rắc rối.

Ghi chú

Thỉnh thoảng, bạn có thể muốn đảm bảo là các thư viện phụ thuộc của bạn được cập nhật với những thay đổi gần đây nhất, bằng cách sử dụng:

pip install -r requirements.txt --upgrade