Kommandoradsargument för tillägg

Kommando för hantering av Blender-tillägg.

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

underkommandon:

Package Management
lista:

Lista alla paket.

synk:

Synkronisera med fjärrarkiv.

uppdatering:

Uppgradera eventuella föråldrade paket.

installera:

Installera paket.

installationsfil:

Installera paket från fil.

ta bort:

Ta bort förpackningar.

Förrådshantering
repo-list:

Lista lagringsplatser.

lägg till repo:

Lägg till förråd.

repo-remove:

Ta bort förrådet.

Extension Creation
bygg:

Bygg ett paket.

validera:

Validera ett paket.

server-generera:

Skapa en lista från alla paket.

Pakethantering

Underkommando: list

användning:

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

Lista paket från alla aktiverade arkiv.

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

-s, --sync

Synkronisera fjärrkatalogen innan du utför åtgärden.

Underkommando: sync

användning:

blender --command extension sync [-h]

Hämta paketinformation för fjärrförråd.

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

Underkommando: update

användning:

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

Ladda ner och uppdatera eventuella föråldrade paket.

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

-s, --sync

Synkronisera fjärrkatalogen innan du utför åtgärden.

Underkommando: install

användning:

blender --command extension install [-h] [-s] [-e] [--no-prefs]
                                    PACKAGES
positionella argument:
PAKET:

De paket som ska användas (åtskilda med , utan mellanslag).

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

-s, --sync

Synkronisera fjärrkatalogen innan du utför åtgärden.

-e, --enable

Aktivera tillägget efter installationen.

--no-prefs

Behandla användarinställningarna som skrivskyddade, vilket förhindrar uppdateringar för åtgärder som annars skulle ändra dem. Detta innebär att användarinställningarna inte uppdateras om du till exempel tar bort tillägg eller arkiv.

Underkommando: install-file

användning:

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

Installera en paketfil i ett användarförråd.

positionella argument:
FIL:

Paketfilen.

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

-r REPO, --repo REPO

Identifierare för förrådet.

-e, --enable

Aktivera tillägget efter installationen.

--no-prefs

Behandla användarinställningarna som skrivskyddade, vilket förhindrar uppdateringar för åtgärder som annars skulle ändra dem. Detta innebär att användarinställningarna inte uppdateras om du till exempel tar bort tillägg eller arkiv.

Underkommando: remove

användning:

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

Inaktivera och ta bort paket.

positionella argument:
PAKET:

De paket som ska användas (åtskilda med , utan mellanslag).

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

--no-prefs

Behandla användarinställningarna som skrivskyddade, vilket förhindrar uppdateringar för åtgärder som annars skulle ändra dem. Detta innebär att användarinställningarna inte uppdateras om du till exempel tar bort tillägg eller arkiv.

Förrådshantering

Underkommando: repo-list

användning:

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

Lista alla arkiv som lagras i Blenders preferenser.

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

Underkommando: repo-add

användning:

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

Lägg till ett nytt lokalt arkiv eller fjärrarkiv.

positionella argument:
ID:

Identifierare för förrådet.

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

--name NAME

Det namn som ska visas i gränssnittet (valfritt).

--directory DIRECTORY

Den katalog där förrådet lagrar lokala filer (valfritt). Om den utelämnas väljs automatiskt en katalog i användarkatalogen.

--url URL

URL för fjärrförråd (valfritt). Om den utelämnas anses förrådet vara ”lokalt” eftersom det inte är anslutet till ett externt förråd, där paket kan installeras via fil eller hanteras manuellt.

--access-token ACCESS_TOKEN

Den åtkomsttoken som ska användas för fjärrarkiv som kräver en token.

--source SOURCE

Typ av källa i (’USER’, ’SYSTEM’). Systemarkiv hanteras utanför Blender och anses vara skrivskyddade.

--cache BOOLEAN

Använd paketcache (standard=1).

--clear-all

Rensa alla arkiv innan du lägger till, vilket förenklar testuppsättningen.

--no-prefs

Behandla användarinställningarna som skrivskyddade, vilket förhindrar uppdateringar för åtgärder som annars skulle ändra dem. Detta innebär att användarinställningarna inte uppdateras om du till exempel tar bort tillägg eller arkiv.

Underkommando: repo-remove

användning:

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

Ta bort ett arkiv.

positionella argument:
ID:

Identifierare för förrådet.

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

--no-prefs

Behandla användarinställningarna som skrivskyddade, vilket förhindrar uppdateringar för åtgärder som annars skulle ändra dem. Detta innebär att användarinställningarna inte uppdateras om du till exempel tar bort tillägg eller arkiv.

Skapa tillägg

Underkommando: build

användning:

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]

Bygg ett paket i den aktuella katalogen.

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

--source-dir SOURCE_DIR

Paketets källkatalog som innehåller ett blender_manifest.toml manifest.

Standard är den aktuella katalogen.

--output-dir OUTPUT_DIR

Paketets utdatakatalog.

Standard är den aktuella katalogen.

--output-filepath OUTPUT_FILEPATH

Filväg för paketets utdata (bör innehålla tillägget .zip).

Standardvärdet är {id}-{version}.zip med värden från manifestet.

--valid-tags VALID_TAGS_JSON

Hänvisning till en filsökväg som innehåller giltiga tagglistor.

Om du vill referera till anpassade taggar kan du använda filen .json. Innehållet måste vara en ordbok med listor där key matchar tilläggstypen.

Till exempel:

{"add-ons": ["Exempel", "Annat"], "tema": ["Annat", "Taggar"]}

För att inaktivera validering av taggar, skicka in en tom sökväg –valid-tags=””.

--split-platforms

Bygga ett separat paket för varje plattform. Lägga till plattformen som ett suffix i filnamnet (före tillägget).

Detta kan vara användbart för att minska uppladdningsstorleken för paket som innehåller stora plattformsspecifika moduler (*.whl-filer).

--verbose

Inkludera verbose-utdata.

Underkommando: validate

användning:

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

Validera paketets metadata i den aktuella katalogen.

positionella argument:
Käll_slinga:

Paketets källsökväg (antingen en katalog som innehåller paketfiler eller paketarkivet). Denna sökväg måste innehålla ett blender_manifest.toml manifest.

Standardvärdet är den aktuella katalogen.

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

--valid-tags VALID_TAGS_JSON

Hänvisning till en filsökväg som innehåller giltiga tagglistor.

Om du vill referera till anpassade taggar kan du använda filen .json. Innehållet måste vara en ordbok med listor där key matchar tilläggstypen.

Till exempel:

{"add-ons": ["Exempel", "Annat"], "tema": ["Annat", "Taggar"]}

För att inaktivera validering av taggar, skicka in en tom sökväg –valid-tags=””.

Underkommando: server-generate

användning:

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

Skapar en lista över alla paket som finns lagrade i en katalog. Detta kan användas för att hosta paket som endast kräver hosting av statiska filer.

alternativ:
-h, --help

visa detta hjälpmeddelande och avsluta

--repo-dir REPO_DIR

Katalogen för fjärrförrådet.

--repo-config REPO_CONFIG

En valfri serverkonfiguration för att inkludera information som inte kan upptäckas. Standard är blender_repo.toml (i förrådskatalogen).

Detta kan användas för att definiera blockerade anknytningar, t.ex:

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

Skapa en HTML-fil (index.html) samt förrådets JSON för att stödja bläddring av tillägg online med statisk hosting.

--html-template HTML_TEMPLATE_FILE

En valfri HTML-filsökväg för att ersätta standard HTML-mall med din egen.

Följande nycklar kommer att ersättas med genererat innehåll:

  • ${body} ersätts med tilläggets innehåll.

  • ${date} ersätts med skapelsedatumet.