Danila Poyarkov 3ef554ab2d docs: reorganize documentation and improve integrity

- Replace the ambiguous Guide section with explicit overview, reference, and development routes while preserving legacy URLs with redirects
- Route missing localized content to maintained canonical pages and emit SEO alternates only for real translations
- Add parser-backed documentation integrity checks and make the optimized local build the default while retaining a complete production build

2026-08-13 14:19:12 +03:00

3.6 KiB

Raw Blame History

Начало работы

Попробовать онлайн

OpenPencil работает в браузере — установка не требуется. Откройте app.openpencil.dev, чтобы начать проектирование.

Скачать десктоп-приложение

Собранные бинарные файлы для macOS, Windows и Linux доступны на странице релизов.

Платформа	Загрузка
macOS (Apple Silicon)	`.dmg` (aarch64)
macOS (Intel)	`.dmg` (x64)
Windows (x64)	`.msi` / `.exe`
Windows (ARM)	`.msi` / `.exe`
Linux (x64)	`.AppImage` / `.deb`

macOS через Homebrew

brew install open-pencil/tap/open-pencil

Устанавливает последний подписанный релиз для macOS (Apple Silicon и Intel). Tap автоматически обновляется с каждым релизом.

Сборка из исходников

Предварительные требования

Bun (пакетный менеджер и среда выполнения)
Rust (только для десктоп-приложения)

Установка

git clone https://github.com/open-pencil/open-pencil.git
cd open-pencil
bun install

Сервер разработки

bun run dev

Открывает редактор по адресу http://localhost:1420.

Доступные скрипты

Команда	Описание
`bun run dev`	Сервер разработки с HMR
`bun run build`	Продакшн-сборка
`bun run check`	Линтинг (oxlint) + проверка типов (tsgo)
`bun run test`	E2E визуальная регрессия (Playwright)
`bun run test:update`	Перегенерация эталонных скриншотов
`bun run test:unit`	Модульные тесты (bun:test)
`bun run docs:dev`	Сервер документации
`bun run docs:build`	Быстрая локальная сборка документации
`bun run docs:build:production`	Полная сборка документации для развёртывания

Десктоп-приложение (Tauri)

Десктоп-приложение требует Rust и платформо-зависимые компоненты.

macOS

xcode-select --install
cargo install tauri-cli --version "^2"
bun run tauri dev

Windows

Установите Rust с тулчейном stable-msvc:
```
rustup default stable-msvc
```
Установите Visual Studio Build Tools с компонентом «Разработка классических приложений на C++»
WebView2 предустановлен в Windows 10 (1803+) и Windows 11
Запустите:
```
bun run tauri dev
```

Linux

Установите системные зависимости (Debian/Ubuntu):

sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
  libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev

Затем:

bun run tauri dev

Сборка для распространения

bun run tauri build                                    # Текущая платформа
bun run tauri build --target universal-apple-darwin    # macOS universal

3.6 KiB Raw Blame History Unescape Escape