99 lines
2 KiB
Markdown
99 lines
2 KiB
Markdown
---
|
|
title: Dateien inspizieren
|
|
description: Knotenbäume durchsuchen, nach Name oder Typ suchen und Eigenschaften im Terminal untersuchen.
|
|
---
|
|
|
|
# Dateien inspizieren
|
|
|
|
Das CLI ermöglicht es, `.fig`-Dateien zu erkunden, ohne den Editor zu öffnen. Jeder Befehl funktioniert auch mit der laufenden App — lass einfach das Dateiargument weg.
|
|
|
|
::: tip Installation
|
|
```sh
|
|
npm install -g @open-pencil/cli
|
|
# oder
|
|
brew install open-pencil/tap/open-pencil
|
|
```
|
|
:::
|
|
|
|
## Dokumentinformationen
|
|
|
|
Erhalte einen schnellen Überblick — Seitenanzahl, Gesamtknoten, verwendete Schriften, Dateigröße:
|
|
|
|
```sh
|
|
openpencil info design.fig
|
|
```
|
|
|
|
## Knotenbaum
|
|
|
|
Gibt die vollständige Knotenhierarchie aus:
|
|
|
|
```sh
|
|
openpencil tree design.fig
|
|
```
|
|
|
|
```
|
|
[0] [page] "Getting started" (0:46566)
|
|
[0] [section] "" (0:46567)
|
|
[0] [frame] "Body" (0:46568)
|
|
[0] [frame] "Introduction" (0:46569)
|
|
[0] [frame] "Introduction Card" (0:46570)
|
|
[0] [frame] "Guidance" (0:46571)
|
|
```
|
|
|
|
## Knoten finden
|
|
|
|
Nach Typ suchen:
|
|
|
|
```sh
|
|
openpencil find design.fig --type TEXT
|
|
```
|
|
|
|
Nach Name suchen:
|
|
|
|
```sh
|
|
openpencil find design.fig --name "Button"
|
|
```
|
|
|
|
Beide Flags können kombiniert werden, um Ergebnisse weiter einzugrenzen.
|
|
|
|
## Knotendetails
|
|
|
|
Alle Eigenschaften eines bestimmten Knotens anhand seiner ID inspizieren:
|
|
|
|
```sh
|
|
openpencil node design.fig --id 1:23
|
|
```
|
|
|
|
## Seiten
|
|
|
|
Alle Seiten im Dokument auflisten:
|
|
|
|
```sh
|
|
openpencil pages design.fig
|
|
```
|
|
|
|
## Variablen
|
|
|
|
Designvariablen und ihre Sammlungen auflisten:
|
|
|
|
```sh
|
|
openpencil variables design.fig
|
|
```
|
|
|
|
## Live-App-Modus
|
|
|
|
Wenn die Desktop-App läuft, lass das Dateiargument weg — das CLI verbindet sich über RPC und arbeitet auf der Live-Zeichenfläche:
|
|
|
|
```sh
|
|
openpencil tree # das Live-Dokument inspizieren
|
|
openpencil eval -c "..." # den Editor abfragen
|
|
```
|
|
|
|
## JSON-Ausgabe
|
|
|
|
Alle Befehle unterstützen `--json` für maschinenlesbare Ausgabe — weiterleiten an `jq`, in CI-Skripte einspeisen oder mit anderen Werkzeugen verarbeiten:
|
|
|
|
```sh
|
|
openpencil tree design.fig --json | jq '.[] | .name'
|
|
```
|