fontship

О шрифте

Шрифт - это инструментарий для создания шрифтов и инструментов для совместного рабочего процесса.

Разработанный в Лиге подвижного типа с учетом потребностей проектов шрифтов с открытым исходным кодом, Fontship автоматизирует процесс превращения ваших источников дизайна в готовые файлы шрифтов производства и объединить их для публикации. Да, вы можете предпринять все те же шаги вручную. Да, вы могли бы написать свои собственные сценарии, чтобы выполнить ту же работу. То, что приносит в стол, - это полный пакет всех инструментов, которые необходимо собирать с большинством битов, уже подключаемых.

Один шрифт здания из источников полностью автоматизирована, автоматические сборки из CI и публикационные выпуски - это всего лишь шаг. В качестве дополнительного бонуса все тщательно организовано, чтобы сделать асинхронное удаленное сотрудничество с помощью систем управления версиями (например, GIT) как можно проще. Дизайнерам даже не нужно использовать те же инструменты дизайна!

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

Настраивать

Подъемник может быть использован любым из трех разных способов:

1. Удаленно через бегуна CI, который отвечает на события в удаленном хранилище GIT.
2. Локально через все включенное изображение Docker для низкой настройки хлопот.
3. Локально через регулярную установку системной утилиты (при условии также установлены все необходимые зависимости).

ПРИМЕЧАНИЕ. Четвертый метод, поддерживаемый через V0.5.0, прямое включение файлов правил Fontship в существующий MakeFile вашего проекта, установилось. В зависимости от вашего проекта, такое использование может или не может продолжать функционировать с ограничениями в настоящее время, но новые функции, добавленные в CLI, будут предположить в правилах в будущем.

CI установка

Создайте свои шрифты, не устанавливая и не выполняя ничего локально! Просто подтолкните свои источники в удаленный репозиторий GIT и позвольте шрифту сделать все остальное.

Для использования с действиями GitHub добавьте файл конфигурации в ваш репозиторий, такой как .github/workflows/fontship.yml :

 name : Fontship
on : [push, pull_request]
jobs :
  fontship :
    runs-on : ubuntu-latest
    name : Fontship
    steps :
      - name : Checkout
        uses : actions/checkout@v2
        with :
          fetch-depth : 0
      - name : Fetch tags
        run : git fetch --prune --tags
      - name : Fontship
        uses : theleagueof/fontship@latest

В настоящее время шрифт только встроит шрифты в текущий каталог проектов, оно нигде не публикует их. Вам нужно будет опубликовать полученные артефакты с помощью (например, прикрепив их к каждому CI Run или публикуя их в выпусках) в качестве еще одного шага рабочего процесса вашего проекта. Для полных рабочих примеров см. В рабочих процессах Spartan's Spartan или Libertinus.

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

Настройка Docker

Предварительные изображения Docker доступны в Docker Hub, Github Packages, или вы можете построить их самостоятельно.

Самый простой способ создания контейнера Docker со всеми правильными аргументами - это установить псевдоним (который может быть добавлен в файл RC вашей оболочки, чтобы сохранить его):

Используя Docker Hub в качестве примера, может быть псевдоним:

$ alias fontship= ' docker run -it --volume "$(pwd):/data" --user "$(id -u):$(id -g)" theleagueof/fontship:latest '

Docker автоматически вытащит контейнеры, которые ему необходимы для запуска этого при первом использовании, после чего он просто будет использовать свой локальный кеш контейнеров. Чтобы запустить загрузку, не запустив fontship или для вручную обновить свой кэш позже (например, когда последнее обновляется до нового релиза), используйте docker pull theleagueof/fontship:latest .

Вы можете заменить последнюю (которая всегда будет самым последним выпущенным тегом версии) на Master , чтобы использовать самую свежую неизданную сборку с именем тега, таким как v0.3.2 , для явного использования конкретной версии или с головой для использования изображения, созданного локально.

Чтобы создать изображение Docker локально, вы захотите клонировать этот репозиторий и запустить ./bootstrap.sh или загрузить и извлечь источники из релиза, затем запустите:

$ ./configure
$ make docker

Настройка системы

Если вы используете Arch Linux, вы можете установить этот пакет AUR (предварительно построенный в этом репозитории).

В противном случае, чтобы установить и использовать локально из источника, вам понадобятся некоторые зависимости:

• Git,
• GNU Core Utilities Plus diffutils , bsdtar , entr , zsh ,
• GNU make (4.2+) с соответствующими инструментами AutoConf,
• Python 3 Plus
• Инструменты ржавчины, включая cargo и rustc для построения CLI,
• И несколько других утилит CLI, связанных с шрифтом, а именно: sfnt2woff-zopfli , psautohint , ttfautohint и woff2_compress .

Чтобы установить программное обеспечение на свой компьютер, либо клонируйте этот репозиторий и запустите ./bootstrap.sh или загрузите и извлеките последний релиз, затем запустите:

$ ./configure
$ make
$ sudo make install

Использование

Здание

Чтобы создать все возможные форматы для вашего проекта шрифта, запустите

$ fontship make all

Чтобы генерировать только определенный формат, попробуйте:

# Just static OTF fonts
$ fontship make otf

# All static formats
$ fontship make static

# All variable formats
$ fontship make variable

# Just variable TTF format
$ fontship make variable-ttf

Если вы заинтересованы только в одном конкретном файле (скажем, экземпляру статического веса), вы можете указать точное имя файла, которое вы ожидаете получить максимально быстрое восстановление только этого файла:

$ fontship make FooBar-Black.otf

Издательский

Когда все будет готово или вы хотите отправить шрифт (или отправить образец другу), вы захотите построить распределительный пакет:

$ fontship make dist

Версии

Настройка версии шрифта во всех сгенерированных шрифтах определяется тегом в репозитории GIT. Теги версий должны соответствовать формату MAJOR.MINOR , описанного OpenFV.