chws_tool

chws_tool

Cet outil ajoute les fonctionnalités OpenType chws , vchw , halt et vhal aux polices OpenType / TrueType lorsque l'une de ces fonctionnalités manque. Veuillez consulter l'espacement de l'Est-Asie pour plus de détails sur ces fonctionnalités.

Cet outil utilise le package d'espacement oriental comme son moteur de base et présente les avantages suivants:

• Options API et ligne de commande plus simples.
• Prend en charge les polices CJK sur Fonts.google.com dans sa configuration intégrée.

Pour ajouter de nouvelles polices à la liste des polices prises en charge, veuillez consulter la section Ajout de polices ci-dessous.

Installer

pip install chws-tool

Si vous souhaitez cloner et installer en mode modifiable avec les packages de développement:

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

Utilisation de la ligne de commande

L'exemple suivant ajoute les fonctionnalités à input.otf et l'enregistre au répertoire build . Si l'argument est un répertoire, l'outil l'étend à toutes les polices du répertoire récursivement.

add-chws input.otf

Utilisez l'option -o pour modifier le répertoire de sortie, ou l'option --help pour la liste complète des options.

add-chws input_dir -o output_dir

API

L'exemple suivant crée une police avec les fonctionnalités du répertoire " build " si les fonctionnalités sont applicables:

 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 vous préférez écraser les polices existantes, vous pouvez omettre le répertoire de sortie.

 import chws_tool

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

Si votre programme utilise 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 ())

Ajout de polices

Ce package a une liste intégrée de polices prises en charge dans sa configuration.

Les polices qui ne sont pas dans la liste connue sont toujours traitées avec la configuration par défaut, mais ce package affiche un message d'avertissement.

Lors de l'ajout de nouvelles polices à la liste des polices connues, le processus suivant est recommandé:

1. Trouvez les noms de police. L'exécution de l'option add-chws avec --print-name peut les imprimer.
2. Ajoutez-les à la configuration.
3. (Facultatif) Construisez la police et exécutez le test visuel. Cette étape est facultative car ce package évite automatiquement les collisions de glyphes en calculant les contours de glyphes.
4. (Facultatif) Ajuster la configuration si nécessaire.

Test visuel

L'objectif principal de ce processus est de trouver des espacements trop serrés ou des collisions de glyphes causées par les grains.

Cet outil a des règles heuristiques pour déterminer l'applicabilité des espacements à l'aide des métriques des glyphes, mais suppose que les glyphes de ponctuation pleine largeur ont suffisamment d'espace interne en fonction des conventions linguistiques comme dans UAX # 50 ou dans CLREQ. Malheureusement, toutes les polices ne suivent pas les conventions.

Pour exécuter le test visuel:

1. Ajoutez la police de test à la liste des polices dans le bloc <script> supérieur de tests/test.html .
2. Ouvrez-le dans votre navigateur.
3. Cochez "FullWidth", "vertical" et "Masquer les cases de même taille".

Voici la liste des chèques et les conseils:

• Trouvez où les glyphes sont trop serrés ou entrez en collision lorsque la fonctionnalité est allumée, mais semblez bien sans la fonctionnalité.
  • Les guillemets peuvent entrer en collision le plus souvent, en particulier dans l'écoulement vertical mais parfois dans le flux horizontal également.
  • "Open + Open" et "Close + Close" sont plus susceptibles de colliter que d'autres paires.
  • Sélectionnez les glyphes pour vérifier la quantité d'encres déborde des métriques des glyphes.
• Testez à la fois les flux horizontaux et verticaux en renversant la case "verticale".

Les autres contrôles du test ne sont pas obligatoires, mais ils peuvent être utiles dans les cas suivants.

• Décochez "Masquer la même taille" pour voir les cas où les grains ne sont pas appliqués par les règles intégrées. Ils sont généralement bien. Dans la plupart des cas, ils le sont parce que les glyphes sont manquants, ils ne sont pas pleine largeur ou que la paire ne doit pas s'appliquer pour le script de la police. Le fichier de test ContaSn Code Poitns pour tous les scripts d'Asie de l'Est, mais tous les points de code ne devraient pas appliquer des espacements pour tous les scripts.
• La liste "langue" n'a pas d'importance dans la plupart des cas, sauf lorsque la police prend en charge plusieurs localités, telles que NOTO CJK.
• La fonction "FullWidth" peut changer les glyphes, mais dans la plupart des cas, si les glyphes semblent bien avec la fonctionnalité, ils devraient être OK avec la fonction éteinte.
• La fonction "verticale" n'est valable que dans le flux vertical. Vous pouvez simplement le vérifier, pour la même raison que la fonction "FullWidth".
• Les champs d'entrée "caractères" peuvent modifier les cas de test. Vous n'avez pas à les changer à moins que vous ayez des besoins spécifiques.

Libération

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