chws_tool

chws_tool

Esta herramienta agrega las características OpenType chws , vchw , halt y vhal a las fuentes OpenType/TrueType cuando falta cualquiera de estas características. Consulte el espacio de este asiático para obtener detalles de estas características.

Esta herramienta utiliza el paquete de espacios de asiático este como su motor central, y tiene las siguientes ventajas:

• Opciones de API y línea de comandos más simples.
• Admite fuentes CJK en fuentes.google.com en su configuración incorporada.

Para agregar nuevas fuentes a la lista de fuentes compatibles, consulte la sección Agregar fuentes a continuación.

Instalar

pip install chws-tool

Si desea clonar e instalar en el modo editable con los paquetes de desarrollo:

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

Uso de la línea de comandos

El siguiente ejemplo agrega las características a input.otf y la guarda al directorio build . Si el argumento es un directorio, la herramienta lo expande a todas las fuentes en el directorio de manera recursiva.

add-chws input.otf

Use la opción -o para cambiar el directorio de salida, o la opción --help para la lista completa de opciones.

add-chws input_dir -o output_dir

API

El siguiente ejemplo crea una fuente con las características en el directorio " build " si las características son aplicables:

 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" )

Si prefiere sobrescribir las fuentes existentes, puede omitir el directorio de salida.

 import chws_tool

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

Si su programa usa 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 ())

Agregar fuentes

Este paquete tiene una lista incorporada de fuentes compatibles en su configuración.

Las fuentes que no están en la lista conocida todavía se procesan con la configuración predeterminada, pero este paquete muestra un mensaje de advertencia.

Al agregar nuevas fuentes a la lista de fuentes conocida, se recomienda el siguiente proceso:

1. Encuentra los nombres de fuentes. Ejecución de la opción add-chws con --print-name puede imprimirlos.
2. Agrégalos a la configuración.
3. (Opcional) Cree la fuente y ejecute la prueba visual. Este paso es opcional porque este paquete evita automáticamente las colisiones de glifo calculando los contornos de Glyph.
4. (Opcional) Ajuste la configuración si es necesario.

Prueba visual

El propósito principal de este proceso es encontrar espacios demasiado apretados o colisiones de glifo causadas por los kernings.

Esta herramienta tiene reglas heurísticas para determinar la aplicabilidad de los espacios utilizando las métricas del glifo, pero supone que los glifos de puntuación de ancho completo tienen suficientes espacios internos de acuerdo con las convenciones lingüísticas como en UAX#50 o en Clreq. Desafortunadamente, no todas las fuentes siguen las convenciones.

Para ejecutar la prueba visual:

1. Agregue la fuente de prueba a la lista de fuentes en el bloque superior <script> de tests/test.html .
2. Ábralo en tu navegador.
3. Verifique las casillas de verificación "Valor completo", "vertical" y "Ocultar el mismo tamaño".

Aquí está la lista de verificación y los consejos:

• Encuentre dónde los glifos están demasiado apretados o chocan cuando la función está encendida pero se ve bien sin la función.
  • Las comillas pueden chocar con mayor frecuencia, especialmente en el flujo vertical, pero a veces en el flujo horizontal también.
  • "Abierto+Open" y "Close+Close" tienen más probabilidades de chocar que otros pares.
  • Seleccione los glifos para verificar cuántas tintas desbordan las métricas del glifo.
• Pruebe los flujos horizontales y verticales volteando la casilla de verificación "vertical".

Otros controles en la prueba no son obligatorios, pero pueden ser útiles en los siguientes casos.

• Desactivar "esconder el mismo tamaño" para ver casos en los que las reglas incorporadas no aplican kernings. Suelen estar bien. En la mayoría de los casos, se deben a que faltan los glifos, no son de ancho completo o el par no debe solicitar el guión de la fuente. El archivo de prueba Contaisn Code Poitns para todos los scripts de Asia oriental, pero no todos los puntos de código deben aplicar espacios para todos los script.
• La lista del "idioma" no importa en la mayoría de los casos, excepto cuando la fuente admite múltiples locales, como Noto CJK.
• La característica de "ancho completo" puede cambiar los glifos, pero en la mayoría de los casos, si los glifos se ven bien con la función encendida, deberían estar bien con la función apagada.
• La característica "erguida" solo es válida en el flujo vertical. Puede verlo, por la misma razón que la función "Fullwidth".
• Los campos de entrada "caracteres" pueden cambiar los casos de prueba. No tiene que cambiarlos a menos que tenga necesidades específicas.

Lanzamiento

Ver https://googlefonts.github.io/python#make-a-release.