Pencil

Скачайте Pencil с [Github][releases] или [Mozilla][amo-pkg].

Проверьте [Pencil v3][pencil3] от Evolus — но сначала сделайте резервную копию ваших данных!

Инструмент для создания прототипов графического интерфейса пользователя (GUI) для Firefox, GNU/Linux, OS X и Windows.

![Скриншот][screenshot]

Статус

[Pencil v3][pencil3] находится в разработке компанией Evolus, будущая работа над этой веткой будет минимальной. Файлы Pencil v3 не совместимы с предыдущими версиями, обязательно сделайте резервную копию своих данных!

Этот проект изначально размещался на https://code.google.com/p/evoluspencil/ и был заброшен примерно в 2013 году. Эта ветка была запущена для новой разработки 13 марта 2015 года.

Ссылки

• [Документация][docs]
• [Форум для обсуждения][google-group]
• [Домашняя страница оригинального проекта][evolus-page]
• [Оригинальный репозиторий][evolus-repo]
• [Загрузки][releases]

Дополнительные коллекции Stencil

• Коллекция Android Lollipop[lollipop-collection] от [Nathanielw][nathanielw]
• Коллекция Bootstrap[bootstrap-collection] от [Nathanielw][nathanielw]
• Коллекция иконок Bootstrap Glyph Icons[bootstrap-icon-collection] от [Craig-Fisk][craigfisk]
• Коллекция Material Design Icons[material-collection] от [Nathanielw][nathanielw]
• Коллекция Polymer Iron Icons[iron-icons-collection] от [MercMobily][mercmobily]

Дополнительные коллекции доступны на [странице загрузки оригинальных Stencils][evolus-stencil-downloads].

Известные проблемы

• Собственная коллекция Stencil UI не загружается и не экспортируется правильно, вам следует избегать использования этой коллекции Stencil в настоящее время (см. #602).
• Перетаскивание трафаретов на рабочее пространство не работает в более новых версиях Firefox, либо используйте Pale Moon, Xulrunner, более старую версию Firefox или запустите Pencil, используя firefox --app /path/to/application.ini (см. №802).

Необходимые условия

Вам потребуется версия 4 или выше программы [firefox][firefox], чтобы запустить Pencil как расширение для Firefox. Пользователям Linux потребуется версия 4 или выше firefox, iceweasel или [xulrunner][xulrunner], или версия 25 или выше [palemoon][palemoon]. В установщике Windows и архиве OS X есть всё необходимое.

Установка

Пакеты Windows, Linux, OS X & Firefox доступны для скачивания со [страницы релизов][releases].

Вы также можете установить дополнение Firefox из [репозитория дополнений Mozilla][amo-pkg].

Чтобы установить пакет OS X, разархивируйте архив и скопируйте папку Pencil.app в каталог Applications.

Для конкретных дистрибутивов Linux:

• Arch Linux — доступно в [AUR][aur-pkg].
• Nix/NixOS — выполните команду nix-env -iA pencil. Вам нужно будет отслеживать [Нестабильную][nix-unstable].
• openSUSE — доступно в [графическом репозитории][graphics-repository].
• Ubuntu — файл .deb доступен на [странице релизов][releases].

Сборка

Расширение Firefox

Pencil можно установить как расширение Firefox вместо отдельного приложения. Чтобы создать файл XPI расширения:

cd build
./build.sh xpi
firefox Outputs/Pencil*.xpi

Linux

cd build
./build.sh linux
xulrunner Outputs/Linux/application.ini || firefox --app Outputs/Linux/Application.ini

Также будет создан файл пакета Pencil-*-linux-pkg.tar.gz. Он содержит Pencil внутри структуры каталогов, которую ожидает большинство дистрибутивов Linux (в /usr/share и /usr/bin), а также исполняемый файл, запись на рабочем столе и информацию о типе MIME. Это можно использовать для создания пакетов для конкретных дистрибутивов.

Windows

Вам понадобится curl, установленный для загрузки среды выполнения Windows XULRunner и [NSIS][nsis] для компиляции установщика.

cd build
./build.sh win32

Это должно поместить исполняемый файл установщика в папку Outputs.

OS X

Вам понадобится curl, установленный для получения среды выполнения OS X XULRunner.

cd build
./build.sh mac

Будет создана папка Outputs/. Pencil.app папка в Outputs/Mac и сжатая версия в Outputs/.

Документация

Чтобы создать документацию локально, вам понадобится Sphinx вместе с некоторыми плагинами, которые легко установить с помощью установщика Python pip:

cd docs/
sudo pip install -r requirements.txt
make html
# Или если вы хотите PDF
make latexpdf

Выходные файлы будут помещены в /docs/build/.

Вклад

Вам не нужно быть программистом, чтобы внести свой вклад! Все запросы на функции и отчёты об ошибках приветствуются.

Пользователи

• Оставляйте отчёты об ошибках и запросы функций. Если вы не знаете, как это сделать, прочитайте «Написание хороших отчётов об ошибках».
• Воспроизводите ошибки — существует множество проблем, которые не были подтверждены после переноса из исходного проекта. Попробуйте воспроизвести ошибку и укажите в комментарии, смогли ли вы её воспроизвести или нет. Укажите вашу операционную систему и версию Pencil (пример ошибки).
• Сообщайте о повторяющихся ошибках — многие импортированные ошибки являются дубликатами и просто создают шум в системе отслеживания ошибок. Если вы заметили повторяющуюся проблему, пожалуйста, оставьте комментарий к проблеме и упомяните проблему, которую, по вашему мнению, она дублирует.
• Улучшайте документацию. Файлы находятся в папке docs и написаны в reStructuredText.
• Просто расскажите об этом :)

Технические пользователи

• Упакуйте Pencil для вашего дистрибутива или ОС.
• Создайте коллекцию Stencil для вашей любимой среды пользовательского интерфейса или улучшите предложение Pencil по умолчанию, как описано в документации разработчика Stencil.

Разработчики

• Есть много ошибок, которые нужно исправить — было бы здорово, если бы вы могли решить одну или две! У самых важных ошибок есть метка «Критическая». Метка «звёзды» — это наследие старого репозитория Google Code: много звёзд = много людей, заинтересованных в ошибке или функции. Вы также можете проверить вехи для решения проблем.
• Комментирование и документирование кода, чтобы облегчить программирование для других — большая часть его в настоящее время без комментариев, и их наличие очень помогло бы.

Если вы вносите изменения, влияющие на пользователей, обновите CHANGELOG.md.

Для получения дополнительной информации о начале разработки на Pencil ознакомьтесь с документацией разработчика.

Лицензия

Этот форк выпущен под GPLv2, как и родительская кодовая база.