b9753aa016
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.
73 lines
2.1 KiB
Markdown
73 lines
2.1 KiB
Markdown
---
|
||
title: Dateien untersuchen
|
||
description: Dokumentbaum, Objekte, Seiten und Variablen über die CLI lesen.
|
||
---
|
||
|
||
# Dateien untersuchen
|
||
|
||
Die CLI liest `.fig`-Dateien, ohne den Editor zu öffnen. Läuft die Desktop-App, kann der Dateiname entfallen; die CLI verwendet dann RPC für das geöffnete Dokument.
|
||
|
||
::: tip Installation
|
||
|
||
```sh
|
||
npm install -g @open-pencil/cli
|
||
# oder
|
||
bun add -g @open-pencil/cli
|
||
```
|
||
|
||
:::
|
||
|
||
## Dokumentinformationen
|
||
|
||
```sh
|
||
openpencil info design.fig
|
||
```
|
||
|
||
Zeigt Seiten, Objektanzahl, verwendete Schriften und Dateigröße.
|
||
|
||
## Dokumentbaum und Suche
|
||
|
||
```sh
|
||
openpencil tree design.fig
|
||
openpencil find design.fig --type TEXT
|
||
openpencil find design.fig --name "Button"
|
||
```
|
||
|
||
## XPath-Abfragen
|
||
|
||
```sh
|
||
openpencil query design.fig "//FRAME"
|
||
openpencil query design.fig "//TEXT[@fontSize >= 24]"
|
||
openpencil query design.fig "//*[@visible = false]"
|
||
```
|
||
|
||
Attributnamen wie `fontSize`, `layoutMode` und `strokeWeight` entsprechen der API und bleiben unverändert.
|
||
|
||
## Objekte, Seiten und Variablen
|
||
|
||
```sh
|
||
openpencil node design.fig --id 1:23
|
||
openpencil pages design.fig
|
||
openpencil variables design.fig
|
||
```
|
||
|
||
## Geöffnetes Dokument
|
||
|
||
```sh
|
||
openpencil documents list
|
||
openpencil tree --document-id tab-123 --page-id 0:1
|
||
```
|
||
|
||
Für automatisierte Abläufe zuerst `openpencil documents list --json` aufrufen und anschließend `--document-id` und `--page-id` ausdrücklich übergeben. Dokumente öffnen, speichern, wechseln und schließen, Rückgängig machen, Einstellungen ändern und beliebige Editor-Werkzeuge aufrufen: siehe [Controlling the App](/programmable/cli/app-control).
|
||
|
||
## Qualitätsprüfung
|
||
|
||
```sh
|
||
openpencil lint design.fig
|
||
openpencil lint design.pen --preset strict
|
||
openpencil lint design.fig --rule color-contrast
|
||
openpencil lint design.fig --fix -o fixed.fig
|
||
```
|
||
|
||
Alle Befehle unterstützen `--json`; jede Meldung enthält ihre `fix`- und `suggestions`-Angaben als Daten. `--fix` wendet die sicheren Korrekturen an – Farben werden an die passende Farbvariable gebunden und die Geometrie auf ganze Pixel gerundet – und schreibt das Ergebnis in die mit `-o` angegebene `.fig`-Datei.
|