Аргументи Командного Рядка Розширень¶

Команда для керування розширеннями Blender.

options:

-h, --help: відобразити це довідкове повідомлення та вийти

subcommands:

Package Management

list:

Відобразити всі пакунки.

sync:

Синхронізувати з відваленими сховищами.

update:

Оновити будь-які застарілі пакунки.

install:

Встановити пакунки.

install-file:

Встановити файли з пакунку.

remove:

Вилучити пакунки.

Repository Management

repo-list:

Список сховищ.

repo-add:

Додати сховище.

repo-remove:

Вилучити сховище.

Extension Creation

build:

Зробити пакунок.

validate:

Перевірити пакунок.

server-generate:

Створити список з усіх пакунків.

Керування Пакунками¶

Subcommand: `list`¶

usage:

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

Зробити список з усіх увімкнених сховищ.

options:

-h, --help: відобразити це довідкове повідомлення та вийти
-s, --sync: Синхронізувати віддалену директорію перед тим як робити якусь дію.

Subcommand: `sync`¶

usage:

blender --command extension sync [-h]

Завантажити інформацію пакунку для віддаленого сховища.

options:

-h, --help: відобразити це довідкове повідомлення та вийти

Subcommand: `update`¶

usage:

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

Завантажити та оновити будь-які застарілі пакунки.

options:

-h, --help: відобразити це довідкове повідомлення та вийти
-s, --sync: Синхронізувати віддалену директорію перед тим як робити якусь дію.

Subcommand: `install`¶

usage:

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

positional arguments:

PACKAGES:: Пакунки над якими працювати (розділені , без пробілів).

options:

-h, --help: відобразити це довідкове повідомлення та вийти
-s, --sync: Синхронізувати віддалену директорію перед тим як робити якусь дію.
-e, --enable: Увімкнути розширення після інсталювання.
--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`¶

usage:

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

Встановити файл пакунку в сховище користувача.

positional arguments:

FILE:: Файл пакунків.

options:

-h, --help: відобразити це довідкове повідомлення та вийти
-r REPO, --repo REPO: Ідентифікатор сховища.
-e, --enable: Увімкнути розширення після інсталювання.
--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`¶

usage:

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

Вимкнути та вилучити пакунок(пакунки).

positional arguments:

PACKAGES:: Пакунки над якими працювати (розділені , без пробілів).

options:

-h, --help: відобразити це довідкове повідомлення та вийти
--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-list`¶

usage:

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

Показати список всіх сховищ у налаштуваннях Blender.

options:

-h, --help: відобразити це довідкове повідомлення та вийти

Subcommand: `repo-add`¶

usage:

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

Додати нове локальне або віддалене сховище.

positional arguments:

ID – Ідентифікатор:: Ідентифікатор сховища.

options:

-h, --help: відобразити це довідкове повідомлення та вийти
--name NAME: Назва яка буде відображатись в інтерфейсі (опціонально).
--directory DIRECTORY: Директорія де сховище зберігає локальні файли (опціонально). Коли пропущено, директорія в директорії користувача буде автоматично обрана.
--url URL: URL-адреса, для віддаленого сховища (опціонально). Коли пропущено сховище рахується як «локальне» і воно не під’єднано до додаткового сховища, де пакунки можуть бути встановлені файлом або керуються вручну.
--access-token ACCESS_TOKEN: Токен доступу, щоб використовувати для віддаленого сховища яке потребує токен.
--source SOURCE: Тип джерела в („USER“, „SYSTEM“). Системні сховища керується ззовні Blender та рахуються, як ті, що тільки читаються.
--cache BOOLEAN: Використовувати кеш пакунку (типово=1).
--clear-all: Почистити всі сховища перед додаванням, полегшує встановлення тестів.
--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`¶

usage:

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

Вилучити сховище.

positional arguments:

ID – Ідентифікатор:: Ідентифікатор сховища.

options:

-h, --help: відобразити це довідкове повідомлення та вийти
--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: `build`¶

usage:

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]

Зібрати пакунок в наявній директорії.

options:

-h, --help

відобразити це довідкове повідомлення та вийти

--source-dir SOURCE_DIR

Директорія джерела пакунку містить blender_manifest.toml маніфест файл.

Шлях є типовим для поточної директорії.

--output-dir OUTPUT_DIR

Директорія виводу з пакунку.

Шлях є типовим для поточної директорії.

--output-filepath OUTPUT_FILEPATH

Шлях виводу з пакунку (повинен включати .zip розширення).

Типова назва {id}-{version}.zip використовуючи значення з маніфест файлу.

--valid-tags VALID_TAGS_JSON

Посилання шляху файлу містить правильні списки тегів.

Якщо ви бажаєте зробити посилання з кастомізованими тегами, .json файл може бути використаний. Зміст повинен бути словником списків, де key має збіг з типом розширення.

Наприклад:: {"add-ons": ["Example", "Another"], "theme": ["Other", "Tags"]}

Щоб вимкнути валідацію тегів, введіть пустий шлях --valid-tags="".

--split-platforms

Зібрати окремий пакунок для кожної платформи. Додаючи платформу як суфікс в назві файлу (перед розширенням).

Це може бути корисним, щоб зменшити розмір файлу відвантаження пакунку, який збирає до купи великі специфічні для платформи модулі (*.whl файли).

--verbose

Включити детальний вивід.

Subcommand: `validate`¶

usage:

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

Провести валідацію мета-даних пакунку в поточній директорії.

positional arguments:

SOURCE_PATH:

Шлях джерела пакунку (або директорія яка містить файли пакунків або архівний пакунок). Цей шлях має містити blender_manifest.toml маніфест файл.

Шлях є типовим для поточної директорії.

options:

-h, --help

відобразити це довідкове повідомлення та вийти

--valid-tags VALID_TAGS_JSON

Посилання шляху файлу містить правильні списки тегів.

Наприклад:: {"add-ons": ["Example", "Another"], "theme": ["Other", "Tags"]}

Щоб вимкнути валідацію тегів, введіть пустий шлях --valid-tags="".

Subcommand: `server-generate`¶

usage:

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

Згенерувати список всі пакунків збережених у директорії. Це може бути використано, щоб займати пакунки, які тільки потребують займання статичних файлів.

options:

-h, --help

відобразити це довідкове повідомлення та вийти

--repo-dir REPO_DIR

Директорія віддаленого сховища.

--repo-config REPO_CONFIG

Опціональна конфігурація сервера, щоб включити інформацію яка може бути знайдена. Типово відноситься до blender_repo.toml (в директорії сховища).

Це може бути використано до визначених заблокованих розширень

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

Створити HTML файл (index.html) , так само як і сховище JSON для підтримки онлайн розширень браузера із статичним хостингом.

--html-template HTML_TEMPLATE_FILE

Опціональний HTML шлях файлу, щоб перезаписати типовий HTML шаблон вашим власним.

Наступні ключі будуть замінені згенерованим змістом:

${body} замінено розширенням змісту.
${date} замінено датою створення.

Аргументи Командного Рядка Розширень¶

Керування Пакунками¶

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¶

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`¶