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

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

  1. Installing Dependencies (Cài Đặt các Phụ Thuộc)

  2. Downloading the Repository (Tải Kho Lưu Trữ xuống Máy)

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

Ghi chú

Hướng dẫn này chú trọng rất nhiều đến các công cụ dòng lệnh. Chúng tôi giả định là bạn cũng ít nhất đã quen thuộc với trình ứng dụng bàn giao tiếp của hệ điều hành macOS rồi.

Cài Đặt các Phụ Thuộc (Installing Dependencies)#

Cài đặt các gói đó, hoặc đảm bảo rằng, trong hệ thống của mình, bạn đã có chúng rồi.

When using Homebrew, run the following commands in the terminal:

python3 -m ensurepip
brew install git git-lfs
git lfs install

Tải Kho Lưu Trữ xuống Máy (Downloading the Repository)#

Chỉ cần kiểm xuất kho lưu trữ của Bản Hướng Dẫn Sử Dụng Blender bằng cách sử dụng:

cd ~
git clone https://projects.blender.org/blender/blender-manual.git

Kho lưu trữ lúc này sẽ được tải xuống và mình có thể phải chờ mất vài phút, tùy theo 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)#

Mẹo

It is recommended to setup and activate a virtual Python environment where dependencies will be installed:

python3 -m venv .venv
source .venv/bin/activate

Repeat the source .venv/bin/activate command to re-activate the virtual environment, whenever you open a new terminal to build the documentation.

  • Mở một cửa sổ Thiết Bị Đầu Cuối.

  • Bước vào thư mục "blender-manual" vừa được thêm bởi "git clone":

    cd ~/blender-manual
    
  • Bên trong thư mục đó có một tập tin với cái tên '"phần mềm đòi hỏi, lệ thuộc"', 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 '"preferred installer program: trình lắp đặt ưa thích"' như sau:

    pip install -r requirements.txt
    

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