Tham Số Dòng Lệnh cho các Trình Mở Rộng [Extensions Command Line Arguments]¶

Command for managing Blender extensions.

các tùy chọn [options]:

-h, --help: show this help message and exit

subcommands:

Quản Lý Gói (Package Management)

list:

Liệt kê các gói phần mềm

sync:

Synchronize with remote repositories.

update:

Upgrade any outdated packages.

install:

Install packages.

install-file:

Cài đặt gói từ tập tin.

remove:

Xóa gói phần mềm.

Quản Lý Kho Lưu Trữ (Repository Management)

repo-list:

Liệt kê các kho lưu trữ.

repo-add:

Thêm kho lưu trữ.

repo-remove:

Xóa kho lưu trữ.

Kiến Tạo Trình Mở Rộng (Extension Creation)

build:

Xây dựng gói.

validate:

Xác nhận gói.

server-generate:

Tạo một bản liệt kê từ toàn bộ các gói.

Quản Lý Gói [Package Management]¶

Subcommand: `list`¶

cách dùng:

blender --command extension list [-h] [-s]

List packages from all enabled repositories.

các tùy chọn [options]:

-h, --help: show this help message and exit
-s, --sync: Đồng bộ hóa thư mục từ xa trước khi thực hiện hành động.

Subcommand: `sync`¶

cách dùng:

blender --command extension sync [-h]

Download package information for remote repositories.

các tùy chọn [options]:

-h, --help: show this help message and exit

Subcommand: `update`¶

cách dùng:

blender --command extension update [-h] [-s]

Download and update any outdated packages.

các tùy chọn [options]:

-h, --help: show this help message and exit
-s, --sync: Đồng bộ hóa thư mục từ xa trước khi thực hiện hành động.

Subcommand: `install`¶

cách dùng:

blender --command extension install [-h] [-s] [-e] [--no-prefs]
                                    PACKAGES

các đối số tuân theo vị trí [positional arguments]:

PACKAGES [Các Gói Phần Mềm]:: The packages to operate on (separated by , without spaces).

các tùy chọn [options]:

-h, --help: show this help message and exit
-s, --sync: Đồng bộ hóa thư mục từ xa trước khi thực hiện hành động.
-e, --enable: Enable the extension after installation.
--no-prefs: Treat the user-preferences as read-only, preventing updates for operations that would otherwise modify them. This means removing extensions or repositories for example, won't update the user-preferences.

Subcommand: `install-file`¶

cách dùng:

blender --command extension install-file [-h] -r REPO [-e] [--no-prefs]
                                         FILE

Install a package file into a user repository.

các đối số tuân theo vị trí [positional arguments]:

FILE [TẬP TIN]:: Tập tin gói phần mềm.

các tùy chọn [options]:

-h, --help: show this help message and exit
-r REPO, --repo REPO: Mã định danh kho lưu trữ.
-e, --enable: Enable the extension after installation.
--no-prefs: Treat the user-preferences as read-only, preventing updates for operations that would otherwise modify them. This means removing extensions or repositories for example, won't update the user-preferences.

Subcommand: `remove`¶

cách dùng:

blender --command extension remove [-h] [--no-prefs] PACKAGES

Disable & remove package(s).

các đối số tuân theo vị trí [positional arguments]:

PACKAGES [Các Gói Phần Mềm]:: The packages to operate on (separated by , without spaces).

các tùy chọn [options]:

-h, --help: show this help message and exit
--no-prefs: Treat the user-preferences as read-only, preventing updates for operations that would otherwise modify them. This means removing extensions or repositories for example, won't update the user-preferences.

Quản Lý Kho Lưu Trữ [Repository Management]¶

Subcommand: `repo-list`¶

cách dùng:

blender --command extension repo-list [-h]

List all repositories stored in Blender's preferences.

các tùy chọn [options]:

-h, --help: show this help message and exit

Subcommand: `repo-add`¶

cách dùng:

blender --command extension repo-add [-h] [--name NAME]
                                     [--directory DIRECTORY]
                                     [--url URL]
                                     [--access-token ACCESS_TOKEN]
                                     [--source SOURCE]
                                     [--cache BOOLEAN] [--clear-all]
                                     [--no-prefs]
                                     ID

Add a new local or remote repository.

các đối số tuân theo vị trí [positional arguments]:

ID (Chỉ Danh):: Mã định danh kho lưu trữ.

các tùy chọn [options]:

-h, --help: show this help message and exit
--name NAME: Tên hiển thị trên giao diện (không bắt buộc).
--directory DIRECTORY: The directory where the repository stores local files (optional). When omitted a directory in the users directory is automatically selected.
--url URL: The URL, for remote repositories (optional). When omitted the repository is considered "local" as it is not connected to an external repository, where packages may be installed by file or managed manually.
--access-token ACCESS_TOKEN: The access token to use for remote repositories which require a token.
--source SOURCE: The type of source in ('USER', 'SYSTEM'). System repositories are managed outside of Blender and are considered read-only.
--cache BOOLEAN: Use package cache (default=1).
--clear-all: Clear all repositories before adding, simplifies test setup.
--no-prefs: Treat the user-preferences as read-only, preventing updates for operations that would otherwise modify them. This means removing extensions or repositories for example, won't update the user-preferences.

Subcommand: `repo-remove`¶

cách dùng:

blender --command extension repo-remove [-h] [--no-prefs] ID

Remove a repository.

các đối số tuân theo vị trí [positional arguments]:

ID (Chỉ Danh):: Mã định danh kho lưu trữ.

các tùy chọn [options]:

-h, --help: show this help message and exit
--no-prefs: Treat the user-preferences as read-only, preventing updates for operations that would otherwise modify them. This means removing extensions or repositories for example, won't update the user-preferences.

Kiến Tạo Trình Mở Rộng [Extension Creation]¶

Subcommand: `build`¶

cách dùng:

blender --command extension build [-h] [--source-dir SOURCE_DIR]
                                  [--output-dir OUTPUT_DIR]
                                  [--output-filepath OUTPUT_FILEPATH]
                                  [--valid-tags VALID_TAGS_JSON]
                                  [--split-platforms] [--verbose]

Xây dựng một gói trong thư mục hiện tại.

các tùy chọn [options]:

-h, --help

show this help message and exit

--source-dir SOURCE_DIR

The package source directory containing a blender_manifest.toml manifest.

Mặc định là thư mục hiện tại.

--output-dir OUTPUT_DIR

Thư mục đầu ra của gói.

Mặc định là thư mục hiện tại.

--output-filepath OUTPUT_FILEPATH

The package output filepath (should include a .zip extension).

Defaults to {id}-{version}.zip using values from the manifest.

--valid-tags VALID_TAGS_JSON

Reference a file path containing valid tags lists.

If you wish to reference custom tags a .json file can be used. The contents must be a dictionary of lists where the key matches the extension type.

Lấy ví dụ:: {"add-ons": ["Example", "Another"], "theme": ["Other", "Tags"]}

To disable validating tags, pass in an empty path --valid-tags="".

--split-platforms

Build a separate package for each platform. Adding the platform as a file name suffix (before the extension).

This can be useful to reduce the upload size of packages that bundle large platform-specific modules (*.whl files).

--verbose

Bao gồm đầu ra chi tiết dài dòng.

Subcommand: `validate`¶

cách dùng:

blender --command extension validate [-h]
                                     [--valid-tags VALID_TAGS_JSON]
                                     [SOURCE_PATH]

Validate the package meta-data in the current directory.

các đối số tuân theo vị trí [positional arguments]:

SOURCE_PATH [ĐƯỜNG_DẪN_MÃ_NGUỒN]:

The package source path (either directory containing package files or the package archive). This path must containing a blender_manifest.toml manifest.

Mặc định là thư mục hiện tại.

các tùy chọn [options]:

-h, --help

show this help message and exit

--valid-tags VALID_TAGS_JSON

Reference a file path containing valid tags lists.

If you wish to reference custom tags a .json file can be used. The contents must be a dictionary of lists where the key matches the extension type.

Lấy ví dụ:: {"add-ons": ["Example", "Another"], "theme": ["Other", "Tags"]}

To disable validating tags, pass in an empty path --valid-tags="".

Subcommand: `server-generate`¶

cách dùng:

blender --command extension server-generate [-h] --repo-dir REPO_DIR
                                            [--repo-config REPO_CONFIG]
                                            [--html]
                                            [--html-template HTML_TEMPLATE_FILE]

Generate a listing of all packages stored in a directory. This can be used to host packages which only requires static-file hosting.

các tùy chọn [options]:

-h, --help

show this help message and exit

--repo-dir REPO_DIR

The remote repository directory.

--repo-config REPO_CONFIG

An optional server configuration to include information which can't be detected. Defaults to blender_repo.toml (in the repository directory).

This can be used to defined blocked extensions, for example

schema_version = "1.0.0"

[[blocklist]]
id = "my_example_package"
reason = "Explanation for why this extension was blocked"
[[blocklist]]
id = "other_extension"
reason = "Another reason for why this is blocked"

--html

Create a HTML file (index.html) as well as the repository JSON to support browsing extensions online with static-hosting.

--html-template HTML_TEMPLATE_FILE

An optional HTML file path to override the default HTML template with your own.

Các khóa sau sẽ được thay thế bằng nội dung sinh tạo:

${body} is replaced the extensions contents.
${date} is replaced the creation date.

Tham Số Dòng Lệnh cho các Trình Mở Rộng [Extensions Command Line Arguments]¶

Quản Lý Gói [Package Management]¶

Subcommand: list¶

Subcommand: sync¶

Subcommand: update¶

Subcommand: install¶

Subcommand: install-file¶

Subcommand: remove¶

Quản Lý Kho Lưu Trữ [Repository Management]¶

Subcommand: repo-list¶

Subcommand: repo-add¶

Subcommand: repo-remove¶

Kiến Tạo Trình Mở Rộng [Extension Creation]¶

Subcommand: build¶

Subcommand: validate¶

Subcommand: server-generate¶

Subcommand: `list`¶

Subcommand: `sync`¶

Subcommand: `update`¶

Subcommand: `install`¶

Subcommand: `install-file`¶

Subcommand: `remove`¶

Subcommand: `repo-list`¶

Subcommand: `repo-add`¶

Subcommand: `repo-remove`¶

Subcommand: `build`¶

Subcommand: `validate`¶

Subcommand: `server-generate`¶