Danila Poyarkov 904f3ca390

fix: use official Homebrew cask installation guidance (#712 )

* fix: use official Homebrew cask installation guidance

* docs: guide localized pages through the old Homebrew tap

The translated getting-started pages documented the official cask but not
the migration from the archived tap, so readers of those pages had no
uninstall step for the old formula.

2026-09-17 13:36:17 +03:00

2.6 KiB

Raw Blame History

title	description
Przeglądanie dokumentów	Drzewo obiektów, wyszukiwanie według nazwy i typu oraz właściwości z terminala.

Przeglądanie dokumentów

CLI pozwala analizować dokumenty projektu bez uruchamiania edytora. Te same polecenia działają z otwartą aplikacją komputerową, jeśli nie podasz pliku.

::: tip Instalacja

npm install -g @open-pencil/cli
# albo
bun add -g @open-pencil/cli

:::

Informacje ogólne

Liczba stron i obiektów, używane czcionki oraz rozmiar pliku:

openpencil info design.fig

Drzewo obiektów

openpencil tree design.fig

Wyszukiwanie obiektów

Według typu:

openpencil find design.fig --type TEXT

Według nazwy:

openpencil find design.fig --name "Button"

Zapytania XPath

Selektory XPath wyszukują obiekty według typu, atrybutów i położenia w drzewie:

openpencil query design.fig "//FRAME"

openpencil query design.fig "//TEXT"                    # Wszystkie obiekty tekstowe
openpencil query design.fig "//COMPONENT"               # Wszystkie komponenty
openpencil query design.fig "//INSTANCE"                # Wszystkie egzemplarze
openpencil query design.fig "//FRAME[@width < 300]"     # Ramki węższe niż 300 px
openpencil query design.fig "//*[@cornerRadius > 0]"    # Obiekty z zaokrąglonymi narożnikami
openpencil query design.fig "//*[@visible = false]"     # Ukryte obiekty
openpencil query design.fig "//SECTION//TEXT"            # Tekst wewnątrz sekcji

Nazwy dostępnych atrybutów, takie jak fontSize, layoutMode i strokeWeight, pozostają zgodne z API.

Właściwości obiektu

openpencil node design.fig --id 1:23

Strony i zmienne

openpencil pages design.fig
openpencil variables design.fig

Praca z otwartą aplikacją

Jeśli aplikacja komputerowa jest uruchomiona, nie podawaj ścieżki pliku. CLI połączy się przez RPC z otwartym dokumentem:

openpencil documents
openpencil tree
openpencil tree --document-id tab-123 --page-id 0:1
openpencil eval --document-id tab-123 --page-id 0:1 -c "..."

W procesach automatycznych najpierw wywołaj openpencil documents --json, a potem jawnie przekazuj --document-id i --page-id.

Kontrola jakości

Sprawdzanie nazw, układu, struktury i dostępności:

openpencil lint design.fig
openpencil lint design.pen --preset strict
openpencil lint design.fig --rule color-contrast
openpencil lint design.fig --list-rules

Wyjście JSON

Wszystkie polecenia obsługują --json. Wynik można przekazać do jq, CI albo innego programu.

2.6 KiB Raw Blame History