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.
79 lines
2.9 KiB
Markdown
79 lines
2.9 KiB
Markdown
---
|
||
title: Examiner des fichiers avec la CLI
|
||
description: Consulter pages, objets, hiérarchies, variables et formats des documents `.fig`.
|
||
---
|
||
|
||
# Examiner des fichiers avec la CLI
|
||
|
||
La CLI permet de comprendre la structure d’un fichier sans ouvrir l’éditeur.
|
||
|
||
```sh
|
||
bun open-pencil info design.fig
|
||
bun open-pencil pages design.fig
|
||
bun open-pencil tree design.fig
|
||
```
|
||
|
||
## Résumé
|
||
|
||
`info` affiche le format, la version, le nombre de pages et d’objets, la taille de la zone de travail, les polices, les variables et les principales métadonnées.
|
||
|
||
## Pages et arbre
|
||
|
||
`pages` énumère les pages. `tree` affiche la hiérarchie et peut limiter la profondeur, la page ou le nombre de résultats.
|
||
|
||
## Rechercher des objets
|
||
|
||
`find` recherche par nom, type ou autres critères.
|
||
|
||
```sh
|
||
bun open-pencil find design.fig --name Button
|
||
bun open-pencil find design.fig --type TEXT
|
||
```
|
||
|
||
## Afficher un objet
|
||
|
||
`node` affiche les propriétés de l’identifiant indiqué, notamment la géométrie, le style, les relations et les données propres à son type.
|
||
|
||
## Variables
|
||
|
||
`variables` énumère collections, modes, types et valeurs.
|
||
|
||
## Formats
|
||
|
||
`formats` affiche les formats enregistrés et leurs capacités de lecture et d’écriture.
|
||
|
||
## Mode application en direct
|
||
|
||
Lorsque l’application de bureau est lancée, omettez le fichier : la CLI se connecte via RPC et agit sur la zone de travail active :
|
||
|
||
```sh
|
||
openpencil documents list # list open document/page IDs
|
||
openpencil tree # inspect the active live document
|
||
openpencil tree --document-id tab-123 --page-id 0:1
|
||
openpencil eval --document-id tab-123 --page-id 0:1 -c "..."
|
||
```
|
||
|
||
Dans les workflows d’agents, utilisez `openpencil documents list --json`, puis passez explicitement `--document-id` et `--page-id` au lieu de vous fier à l’onglet ou à la page visibles. Pour ouvrir, enregistrer, changer et fermer des documents, annuler, modifier les réglages ou appeler un outil de l’éditeur, consultez [Piloter l’application](/programmable/cli/app-control).
|
||
|
||
## Analyser la qualité du design
|
||
|
||
```sh
|
||
openpencil lint design.fig
|
||
openpencil lint design.pen --preset strict
|
||
openpencil lint design.fig --rule color-contrast
|
||
openpencil lint design.fig --list-rules
|
||
openpencil lint design.fig --fix -o fixed.fig
|
||
```
|
||
|
||
Utilisez `--json` pour une sortie exploitable par une machine ; chaque message porte ses `fix` et `suggestions` sous forme de données. `--fix` applique les corrections sûres — liaison des couleurs à la variable de couleur correspondante et arrondi de la géométrie au pixel entier — et écrit le résultat dans le fichier `.fig` indiqué avec `-o`.
|
||
|
||
## Sortie JSON
|
||
|
||
Les commandes de consultation acceptent `--json`, adapté à `jq`, la CI et aux programmes qui nécessitent une sortie stable et exploitable par une machine.
|
||
|
||
```sh
|
||
bun open-pencil pages design.fig --json | jq '.[].name'
|
||
```
|
||
|
||
Utilisez `bun open-pencil --help` ou ajoutez `--help` à une sous-commande pour voir toutes les options.
|