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

Команда для керування розширеннями 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: Рахувати уподобання користувача як такі, що тільки читабельні, запобігаючи оновленням які можуть по іншому модифікувати їх. Це означає, що коли вилучається розширення або сховища, як приклад, це не призведе до оновлення уподобань користувача.

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: Рахувати уподобання користувача як такі, що тільки читабельні, запобігаючи оновленням які можуть по іншому модифікувати їх. Це означає, що коли вилучається розширення або сховища, як приклад, це не призведе до оновлення уподобань користувача.

Subcommand: `remove`¶

usage:

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

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

positional arguments:

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

options:

-h, --help: відобразити це довідкове повідомлення та вийти
--no-prefs: Рахувати уподобання користувача як такі, що тільки читабельні, запобігаючи оновленням які можуть по іншому модифікувати їх. Це означає, що коли вилучається розширення або сховища, як приклад, це не призведе до оновлення уподобань користувача.

Керування Сховищем¶

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: Рахувати уподобання користувача як такі, що тільки читабельні, запобігаючи оновленням які можуть по іншому модифікувати їх. Це означає, що коли вилучається розширення або сховища, як приклад, це не призведе до оновлення уподобань користувача.

Subcommand: `repo-remove`¶

usage:

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

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

positional arguments:

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

options:

-h, --help: відобразити це довідкове повідомлення та вийти
--no-prefs: Рахувати уподобання користувача як такі, що тільки читабельні, запобігаючи оновленням які можуть по іншому модифікувати їх. Це означає, що коли вилучається розширення або сховища, як приклад, це не призведе до оновлення уподобань користувача.

Створення Розширення¶

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