openpencil/packages/docs/it/programmable/cli/inspecting.md
Danila Poyarkov b9753aa016
docs: sync translations with documentation changes since v0.15.1 (#886)
Eleven translated pages changed in English since the last release without
matching updates: system requirements, the Lint tab, AI chat diff tools,
collaboration with agents, design JSX imports and export fidelity,
Storybook and live-app export, lint fixes, page navigation, and Checking
Designs. Bring de, es, fr, it, pl, and ru up to date, add the sections
the abridged translations lacked where a change landed, use each
language's UI labels, and point the export page at documents list.
2026-10-04 16:38:35 +00:00

2.5 KiB
Raw Blame History

title description
Esaminare file con la CLI Consultare pagine, oggetti, gerarchie, variabili e formati dei documenti `.fig`.

Esaminare file con la CLI

La CLI permette di capire la struttura di un file senza aprire l’editor.

bun open-pencil info design.fig
bun open-pencil pages design.fig
bun open-pencil tree design.fig

info mostra formato, versione, numero di pagine e oggetti, dimensioni dell’area di lavoro, font, variabili e metadati principali.

Pagine e albero

pages elenca le pagine. tree stampa la gerarchia e può limitare profondità, pagina o numero di risultati.

Cercare oggetti

find cerca per nome, tipo o altri criteri.

Mostrare un oggetto

node mostra le proprietà dell’identificatore indicato, tra cui geometria, stile, relazioni e dati specifici del tipo.

Variabili e formati

variables elenca raccolte, modalità, tipi e valori. formats mostra i formati registrati e le capacità di lettura e scrittura.

Modalità app in esecuzione

Con l’app desktop in esecuzione, ometti il file: la CLI si collega tramite RPC.

openpencil documents list    # elenca gli ID di documenti e pagine aperti
openpencil tree              # esamina il documento attivo
openpencil tree --document-id tab-123 --page-id 0:1
openpencil eval --document-id tab-123 --page-id 0:1 -c "..."

Nei flussi di lavoro con agenti usa openpencil documents list --json, poi passa esplicitamente --document-id e --page-id invece di affidarti alla scheda o pagina attiva. Per aprire, salvare, cambiare e chiudere documenti, annullare, modificare le impostazioni o chiamare qualsiasi strumento dell’editor, vedi Controllare l’app.

Lint dei design

openpencil lint design.fig --preset strict
openpencil lint design.fig --rule color-contrast
openpencil lint design.fig --list-rules
openpencil lint design.fig --fix -o fixed.fig

Usa --json per un output leggibile dalle macchine; ogni messaggio include fix e suggestions come dati. --fix applica le correzioni sicure (collega i colori alla variabile di colore corrispondente e arrotonda la geometria a pixel interi) e scrive il risultato nel file .fig indicato con -o.

Output JSON

I comandi di consultazione supportano --json, adatto a jq, CI e programmi che richiedono un output stabile e leggibile dalle macchine.

bun open-pencil pages design.fig --json | jq '.[].name'

Usa bun open-pencil --help o aggiungi --help a un sottocomando per vedere tutte le opzioni.