Argumenty príkazového riadku rozšírení

Príkaz na správu rozšírení Blenderu.

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

podpríkazy:

Správa balíkov
list:

Zoznam všetkých balíkov.

sync:

Synchronizácia so vzdialenými úložiskami.

update:

Aktualizujte všetky zastarané balíky.

install:

Inštalácia balíkov.

install-file:

Inštalácia balíka zo súboru.

remove:

Odstránenie balíkov.

Správa úložiska
repo-list:

Zoznam úložísk.

repo-add:

Pridať úložisko.

repo-remove:

Odstrániť úložisko.

Vytváranie rozšírení
build:

Zostaviť balík.

validate:

Overiť balík.

server-generate:

Vytvoriť zoznam zo všetkých balíkov.

Správa balíkov

Podpríkaz:list

použitie:

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

Zoznam balíkov zo všetkých povolených úložísk.

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

-s, --sync

Pred vykonaním akcie synchronizuje vzdialený priečinok.

Podpríkaz: sync

použitie:

blender --command extension sync [-h]

Stiahnuť informácie o balíkoch pre vzdialené úložiská.

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

Podpríkaz: update

použitie:

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

Stiahnuť a aktualizovať všetky zastarané balíky.

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

-s, --sync

Pred vykonaním akcie synchronizuje vzdialený priečinok.

Podpríkaz: install

použitie:

blender --command extension install [-h] [-s] [-e] [--no-prefs]
                                    PACKAGES
polohové argumenty:
BALÍKY:

Balíky, s ktorými sa má pracovať (oddelené znakmi , bez medzier).

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

-s, --sync

Pred vykonaním akcie synchronizuje vzdialený priečinok.

-e, --enable

Po inštalácii rozšírenie povoliť.

--no-prefs

Predvoľby užívateľa sa považujú len na čítanie, čím sa zabráni aktualizáciám operácií, ktoré by ich inak zmenili. To znamená, že napríklad pri odstraňovaní rozšírení alebo úložísk sa užívateľské nastavenia nebudú aktualizovať.

Podpríkaz: install-file

použitie:

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

Inštalácia súboru balíka do užívateľského úložiska.

polohové argumenty:
SÚBOR:

Súbor balíkov.

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

-r REPO, --repo REPO

Identifikátor úložiska.

-e, --enable

Po inštalácii rozšírenie povoliť.

--no-prefs

Predvoľby užívateľa sa považujú len na čítanie, čím sa zabráni aktualizáciám operácií, ktoré by ich inak zmenili. To znamená, že napríklad pri odstraňovaní rozšírení alebo úložísk sa užívateľské nastavenia nebudú aktualizovať.

Podpríkaz: remove

použitie:

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

Zakázať a odstrániť balík(y).

polohové argumenty:
BALÍKY:

Balíky, s ktorými sa má pracovať (oddelené znakmi , bez medzier).

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

--no-prefs

Predvoľby užívateľa sa považujú len na čítanie, čím sa zabráni aktualizáciám operácií, ktoré by ich inak zmenili. To znamená, že napríklad pri odstraňovaní rozšírení alebo úložísk sa užívateľské nastavenia nebudú aktualizovať.

Správa úložiska

Podpríkaz: repo-list

použitie:

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

Zoznam všetkých úložísk uložených v predvoľbách Blenderu.

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

Podpríkaz: repo-add

použitie:

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

Pridať nové miestne alebo vzdialené úložisko.

polohové argumenty:
ID:

Identifikátor úložiska.

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

--name NAME

Názov, ktorý sa zobrazí v rozhraní (nepovinné).

--directory DIRECTORY

Priečinok, do ktorého úložisko ukladá miestne súbory (nepovinné). Ak sa vynechá, automaticky sa vyberie priečinok v užívateľskom priečinku.

--url URL

Adresa URL pre vzdialené úložiská (nepovinné). Ak sa vynechá, úložisko sa považuje za „lokálne“, pretože nie je pripojené k externému úložisku, kde sa balíky môžu inštalovať pomocou súborov alebo spravovať ručne.

--access-token ACCESS_TOKEN

Prístupový token, ktorý sa má použiť pre vzdialené úložiská, ktoré vyžadujú token.

--source SOURCE

Typ zdroja v („USER“, „SYSTEM“). Systémové úložiská sa spravujú mimo Blenderu a považujú sa len na čítanie.

--cache BOOLEAN

Použiť zásobník balíka (predvolené=1).

--clear-all

Zmazať všetky úložiská pred pridaním, zjednodušuje nastavenie testov.

--no-prefs

Predvoľby užívateľa sa považujú len na čítanie, čím sa zabráni aktualizáciám operácií, ktoré by ich inak zmenili. To znamená, že napríklad pri odstraňovaní rozšírení alebo úložísk sa užívateľské nastavenia nebudú aktualizovať.

Podpríkaz: repo-remove

použitie:

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

Odstrániť úložisko.

polohové argumenty:
ID:

Identifikátor úložiska.

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

--no-prefs

Predvoľby užívateľa sa považujú len na čítanie, čím sa zabráni aktualizáciám operácií, ktoré by ich inak zmenili. To znamená, že napríklad pri odstraňovaní rozšírení alebo úložísk sa užívateľské nastavenia nebudú aktualizovať.

Vytvorenie rozšírenia

Podpríkaz: build

použitie:

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]

Zostaviť balík v aktuálnom priečinku.

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

--source-dir SOURCE_DIR

Zdrojový priečinok balíka obsahujúci manifest blender_manifest.toml.

Predvolené nastavenie je na aktuálny priečinok.

--output-dir OUTPUT_DIR

Výstupný priečinok balíka.

Predvolené nastavenie je na aktuálny priečinok.

--output-filepath OUTPUT_FILEPATH

Výstupná cesta k súboru balíka (mala by obsahovať príponu .zip).

Predvolené je {id}-{version}.zip s použitím hodnôt z manifestu.

--valid-tags VALID_TAGS_JSON

Odkaz na cestu k súboru obsahujúcemu platné zoznamy príznakov.

Ak chcete odkazovať na vlastné príznaky, môžete použiť súbor .json. Obsahom musí byť slovník zoznamov, kde key zodpovedá typu rozšírenia.

Napríklad:

{" doplnky": ["príklad", "ďalší"], "motív": ["iné", "príznaky"]}

Ak chcete vypnúť overovanie príznakov, zadajte prázdnu cestu --valid-tags=""`.

--split-platforms

Pre každú platformu vytvorí samostatný balík. Pridá platformy ako prípony názvu súboru (pred príponu).

To môže byť užitočné na zníženie veľkosti nahrávania balíkov, ktoré obsahujú veľké moduly špecifické pre platformu (súbory *.whl).

--verbose

Zahrnúť slovný výstup.

Podpríkaz: validate

použitie:

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

Overiť metaúdaje balíka v aktuálnom priečinku.

polohové argumenty:
ZDROJ_CESTA:

Cesta k zdroju balíka (priečinok obsahujúci súbory balíka alebo archív balíka). Táto cesta musí obsahovať manifest blender_manifest.toml.

Predvolené nastavenie je aktuálny priečinok.

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

--valid-tags VALID_TAGS_JSON

Odkaz na cestu k súboru obsahujúcemu platné zoznamy príznakov.

Ak chcete odkazovať na vlastné príznaky, môžete použiť súbor .json. Obsahom musí byť slovník zoznamov, kde key zodpovedá typu rozšírenia.

Napríklad:

{" doplnky": ["príklad", "ďalší"], "motív": ["iné", "príznaky"]}

Ak chcete vypnúť overovanie príznakov, zadajte prázdnu cestu --valid-tags=""`.

Podpríkaz: server-generate

použitie:

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

Vygenerovať zoznam všetkých balíkov uložených v priečinku. Toto sa môže použiť na hostiteľstvo balíkov, ktoré vyžaduje iba hosťovanie statických súborov.

možnosti:
-h, --help

zobrazí túto pomocnú správu a ukončí sa

--repo-dir REPO_DIR

Priečinok vzdialeného úložiska.

--repo-config REPO_CONFIG

Voliteľná konfigurácia servera, ktorá obsahuje informácie, ktoré nie je možné zistiť. Predvolené nastavenie je blender_repo.toml (v priečinku úložiska).

Toto možno použiť na definovanie blokovaných rozšírení, napríklad

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

Vytvára súbor HTML (index.html), ako aj JSON úložiska na podporu prezerania rozšírení online so statickým hostingom.

--html-template HTML_TEMPLATE_FILE

Voliteľná cesta k súboru HTML na prepísanie predvolenej šablóny HTML vlastnou šablónou.

Nasledujúce kľúče budú nahradené vygenerovaným obsahom:

  • ${body} je nahradený obsahom rozšírenia.

  • ${date} je nahradený dátumom vytvorenia.