Cài Đặt trên Windows (Installation on Windows)

Hướng dẫn này bao chù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 (Installing 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 cách làm theo 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 "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ài Đặt SVN và Tải Kho Lưu Trữ về Máy (Installing SVN and Downloading the Repository)

Trong hướng dẫn này, chúng tôi sẽ sử dụng TortoiseSVN, đương nhiên, 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 cách làm theo 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 thì hãy tạo một thư mục mới để chứa toàn bộ 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 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 (Setting up the Build Environment)

  • Open a Command Prompt. (Run as Administrator)

  • 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 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 đây, 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