chws_tool

chws_tool

Этот инструмент добавляет функции Opentype chws , vchw , halt и vhal к шрифтам OpenType/Truetype, когда какая -либо из этих функций отсутствует. Пожалуйста, смотрите в восточно-азиатском интервале для получения подробной информации об этих функциях.

Этот инструмент использует пакет с восточно-азиатским интервалом в качестве основного двигателя и имеет следующие преимущества:

• Более простые параметры API и командной строки.
• Поддерживает шрифты CJK на fonts.google.com в его встроенной конфигурации.

Чтобы добавить новые шрифты в поддерживаемый список шрифтов, см. В разделе «Добавление шрифтов» ниже.

Установить

pip install chws-tool

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

git clone https://github.com/googlefonts/chws_tool.git
cd chws_tool
pip install -e ' .[dev] ' 

Использование командной строки

Следующий пример добавляет функции в input.otf и сохраняет их в каталоге build . Если аргумент является каталогом, инструмент расширяет его на все шрифты в каталоге рекурсивно.

add-chws input.otf

Используйте опцию -o , чтобы изменить выходной каталог или опцию --help для полного списка параметров.

add-chws input_dir -o output_dir

API

Следующий пример создает шрифт с функциями в каталоге " build ", если функции применимы:

 import chws_tool

def main ():
    output_path = chws_tool . add_chws ( "fonts/input.otf" , "build" )
    if output_path :
        print ( f"Success! saved to { output_path } " )
    else :
        print ( "Skipped" )

Если вы предпочитаете перезаписать существующие шрифты, вы можете опустить выходной каталог.

 import chws_tool

def main ():
    chws_tool . add_chws ( "fonts/input.otf" )

Если ваша программа использует Asyncio:

 import asyncio
import chws_tool

async def main_async ():
    output_path = await chws_tool . add_chws_async ( "fonts/input.otf" , "build" )
    if output_path :
        print ( f"Success! saved to { output_path } " )
    else :
        print ( "Skipped" )

asyncio . run ( main_async ())

Добавление шрифтов

Этот пакет имеет встроенный список поддерживаемых шрифтов в его конфигурации.

Шрифты не в известном списке по -прежнему обрабатываются с конфигурацией по умолчанию, но в этом пакете отображается предупреждающее сообщение.

При добавлении новых шрифтов в известный список шрифтов рекомендуется:

1. Найдите имена шрифтов. Запуск add-chws с опцией --print-name может распечатать их.
2. Добавьте их в конфигурацию.
3. (Необязательно) Создайте шрифт и запустите визуальный тест. Этот шаг не является обязательным, потому что этот пакет автоматически избегает столкновений с глифами, вычисляя очертания Glyph.
4. (Необязательно) При необходимости настройте конфигурацию.

Визуальный тест

Основной целью этого процесса является поиск слишком жестких расстояний или столкновений с глифами, вызванными ядрами.

Этот инструмент имеет эвристические правила для определения применимости пространств с использованием метрик глифа, но предполагает, что глифы пунктуации полной ширины имеют достаточное количество внутренних пространств в соответствии с лингвистическими соглашениями, как в UAX#50 или в Clreq. К сожалению, не все шрифты следуют конвенциям.

Чтобы запустить визуальный тест:

1. Добавьте тестовый шрифт в список шрифтов в верхнем <script> блока tests/test.html .
2. Откройте его в своем браузере.
3. Проверьте флажки «Полная трубка», «вертикально» и «скрыть тот же размер».

Вот контрольный список и советы:

• Найдите, где глифы слишком плотны или сталкиваются, когда функция включена, но выглядите прекрасно без этой функции.
  • Цитаты могут столкнуться чаще всего, особенно в вертикальном потоке, но иногда в горизонтальном потоке тоже.
  • «Open+Open» и «Close+Close» с большей вероятностью столкнутся, чем другие пары.
  • Выберите Glyph, чтобы проверить, сколько чернила переполняет метрики Glyph.
• Проверьте как горизонтальные, так и вертикальные потоки, перевернув «вертикальный» флажок.

Другие элементы управления в тесте не являются обязательными, но они могут быть полезны в следующих случаях.

• Снимите «скрыть тот же размер», чтобы увидеть случаи, когда встроенные правила не применяются. Они обычно в порядке. В большинстве случаев они связаны с тем, что глифы отсутствуют, они не являются полной шириной, или пара не должна применяться для сценария шрифта. Код тестового файла Contaisn poitns для всех сценариев Восточной Азии, но не все точки кода должны применять пространства для всех сценариев.
• Список «языка» в большинстве случаев не имеет значения, за исключением случаев, когда шрифт поддерживает несколько локалов, таких как Noto CJK.
• Функция «полная трудовая» может изменить глифы, но в большинстве случаев, если глифы выглядят нормально с этой функцией, они должны быть в порядке с этой функцией.
• Функция «Право» действительна только в вертикальном потоке. Вы можете просто проверить это, по той же причине, что и функция «полная труба».
• Поля «символов» могут изменить тестовые примеры. Вам не нужно их менять, если у вас нет конкретных потребностей.

Выпуск

См. Https://googlefonts.github.io/python#make-a.