Arguments de línia d’ordres d’extensions¶

Ordre per gestionar les extensions de Blender.

opcions:

-h, --help: Mostra aquest missatge d’ajuda i surt.

subordres:

Gestió de paquets

list:

Llista tots els paquets.

sync:

Sincronitza amb repositoris remots.

update:

Actualitza tots els paquets endarrerits.

install:

Instal·la paquets.

install-file:

Instal·la paquet des de document.

remove:

Suprimeix paquets.

Gestió de repositori

repo-list:

Llista repositoris.

repo-add:

Afegeix un repositori.

repo-remove:

Suprimeix repositoris.

Creació d’extensions

build:

Compila un paquet.

validate:

Valida un paquet.

server-generate:

Crea un llistat de tots els paquets.

Gestió de paquets¶

Subordre: `list`¶

ús:

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

Llista els paquets de tots els repositoris habilitats.

opcions:

-h, --help: Mostra aquest missatge d’ajuda i surt.
-s, --sync: Sincronitza el repositori remot abans d’executar l’acció.

Subordre: `sync`¶

ús:

blender --command extension sync [-h]

Descarrega la informació de paquets per als repositoris remots.

opcions:

-h, --help: Mostra aquest missatge d’ajuda i surt.

Subordre: `update`¶

ús:

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

Descarrega i actualitza els paquets endarrerits.

opcions:

-h, --help: Mostra aquest missatge d’ajuda i surt.
-s, --sync: Sincronitza el repositori remot abans d’executar l’acció.

Subordre: `install`¶

ús:

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

arguments posicionals:

PAQUETS:: Els paquets a operar (separació per , sense espais).

opcions:

-h, --help: Mostra aquest missatge d’ajuda i surt.
-s, --sync: Sincronitza el repositori remot abans d’executar l’acció.
-e, --enable: Habilita l’extensió després de la instal·lació.
--no-prefs: Tracta les preferències d’usuària com a només de lectura, evitant així actualitzacions d’operacions que d’altra manera les modificarien. Significa que eliminar extensions o repositoris, per exemple, no actualitzarà les preferències de la usuària.

Subordre: `install-file`¶

ús:

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

Instal·la un document paquet en un repositori d’usuària.

arguments posicionals:

FILE:: El document de paquets.

opcions:

-h, --help: Mostra aquest missatge d’ajuda i surt.
-r REPO, --repo REPO: Identificador del repositori.
-e, --enable: Habilita l’extensió després de la instal·lació.
--no-prefs: Tracta les preferències d’usuària com a només de lectura, evitant així actualitzacions d’operacions que d’altra manera les modificarien. Significa que eliminar extensions o repositoris, per exemple, no actualitzarà les preferències de la usuària.

Subordre: `remove`¶

ús:

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

Deshabilita i suprimeix el(s) paquet(s).

arguments posicionals:

PAQUETS:: Els paquets a operar (separació per , sense espais).

opcions:

-h, --help: Mostra aquest missatge d’ajuda i surt.
--no-prefs: Tracta les preferències d’usuària com a només de lectura, evitant així actualitzacions d’operacions que d’altra manera les modificarien. Significa que eliminar extensions o repositoris, per exemple, no actualitzarà les preferències de la usuària.

Gestió de repositoris¶

Subordre: `repo-list`¶

ús:

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

Llista tots els dipòsits emmagatzemats a les preferències de Blender.

opcions:

-h, --help: Mostra aquest missatge d’ajuda i surt.

Subordre: `repo-add`¶

ús:

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

Afegeix un nou repositori local o remot.

arguments posicionals:

ID:: Identificador del repositori.

opcions:

-h, --help: Mostra aquest missatge d’ajuda i surt.
--name NAME: El nom a mostrar a la interfície (opcional).
--directory DIRECTORY: El directori on el repositori emmagatzema els documents locals (opcional). Quan s’omet, se selecciona automàticament un directori del directori d’usuàries.
--url URL: L’URL per als repositoris remots (opcional). Quan s’omet, el repositori es considera «local» en no estar connectat a un repositori extern en què, amb la qual cosa els paquets es poden instal·lar mitjançant documents o gestionant-los manualment.
--access-token ACCESS_TOKEN: El tiquet (=token) d’accés per als repositoris remots que requereixen un tiquet.
--source SOURCE: El tipus de font a (“USER”, “SYSTEM”). Els repositoris del sistema es gestionen fora de Blender i es consideren de només lectura.
--cache BOOLEAN: Empra la memòria cau del paquet (per defecte=1).
--clear-all: Retira tots els repositoris abans d’afegir, simplifica la configuració de la prova.
--no-prefs: Tracta les preferències d’usuària com a només de lectura, evitant així actualitzacions d’operacions que d’altra manera les modificarien. Significa que eliminar extensions o repositoris, per exemple, no actualitzarà les preferències de la usuària.

Subordre: `repo-remove`¶

ús:

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

Suprimeix un repositori.

arguments posicionals:

ID:: Identificador del repositori.

opcions:

-h, --help: Mostra aquest missatge d’ajuda i surt.
--no-prefs: Tracta les preferències d’usuària com a només de lectura, evitant així actualitzacions d’operacions que d’altra manera les modificarien. Significa que eliminar extensions o repositoris, per exemple, no actualitzarà les preferències de la usuària.

Creació d’extensions¶

Subordre: `build`¶

ús:

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]

Compila un paquet en el directori actual.

opcions:

-h, --help

Mostra aquest missatge d’ajuda i surt.

--source-dir SOURCE_DIR

El directori font del paquet que conté un manifest blender_manifest.toml.

Per defecte va al directori en curs.

--output-dir OUTPUT_DIR

El directori d’egressió del paquet.

Per defecte va al directori en curs.

--output-filepath OUTPUT_FILEPATH

La ruta d’egressió del paquet (ha de venir amb una extensió .zip).

Per defecte és {id}-{version}.zip amb els valors des del manifest.

--valid-tags VALID_TAGS_JSON

Referencia una ruta de document que conté llistes vàlides d’etiquetes.

Si voleu referenciar les etiquetes personalitzades, es pot utilitzar un document .json El contingut ha de ser un diccionari de llistes on la key conlligui amb el tipus d’extensió.

Per exemple:: {"add-ons": ["Example", "Another"], "theme": ["Other", "Tags"]}

Per a deshabilitar les etiquetes de validació, cal passar una ruta buida --valid-tags="".

--split-platforms

Crea un paquet diferent per a cada plataforma, tot afegint la plataforma com a sufix del nom de document (abans de l’extensió).

Pot ser útil per reduir la mida de càrrega dels paquets que agrupen grans mòduls específics de la plataforma (documents *.whl).

--verbose

Incloure egressió detallada.

Subordre: `validate`¶

ús:

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

Valida les metadades del paquet dins el directori actual.

arguments posicionals:

SOURCE_PATH:

La ruta d’origen del paquet (ja sigui el directori que conté els documents del paquet o l’arxiu del paquet). Aquesta ruta ha de contenir un manifest blender_manifest.toml.

Per defecte va al directori en curs.

opcions:

-h, --help

Mostra aquest missatge d’ajuda i surt.

--valid-tags VALID_TAGS_JSON

Referencia una ruta de document que conté llistes vàlides d’etiquetes.

Si voleu referenciar les etiquetes personalitzades, es pot utilitzar un document .json El contingut ha de ser un diccionari de llistes on la key conlligui amb el tipus d’extensió.

Per exemple:: {"add-ons": ["Example", "Another"], "theme": ["Other", "Tags"]}

Per a deshabilitar les etiquetes de validació, cal passar una ruta buida --valid-tags="".

Subordre: `server-generate`¶

ús:

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

Genera un llistat de tots els paquets emmagatzemats en un directori. Es pot utilitzar per allotjar paquets que només requereixen allotjament de documents estàtics.

opcions:

-h, --help

Mostra aquest missatge d’ajuda i surt.

--repo-dir REPO_DIR

El directori del repositori remot.

--repo-config REPO_CONFIG

Una configuració de servidor facultativa per incloure informacions que no es puguin detectar. Per defecte és blender_repo.toml (dins el directori del repositori).

Es pot utilitzar per definir extensions blocades, per exemple

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

Crea un document HTML (index.html) així com el repositori JSON per donar suport a les extensions de navegació en línia amb allotjament estàtic.

--html-template HTML_TEMPLATE_FILE

Una ruta opcional de document HTML per substituir la plantilla HTML predeterminada per la vostra.

Les fites següents se substituiran per continguts generats:

${body} substitueix els continguts d’extensions.
${date} substitueix la data de creació.

Arguments de línia d’ordres d’extensions¶

Gestió de paquets¶

Subordre: list¶

Subordre: sync¶

Subordre: update¶

Subordre: install¶

Subordre: install-file¶

Subordre: remove¶

Gestió de repositoris¶

Subordre: repo-list¶

Subordre: repo-add¶

Subordre: repo-remove¶

Creació d’extensions¶

Subordre: build¶

Subordre: validate¶

Subordre: server-generate¶

Subordre: `list`¶

Subordre: `sync`¶

Subordre: `update`¶

Subordre: `install`¶

Subordre: `install-file`¶

Subordre: `remove`¶

Subordre: `repo-list`¶

Subordre: `repo-add`¶

Subordre: `repo-remove`¶

Subordre: `build`¶

Subordre: `validate`¶

Subordre: `server-generate`¶