chws_tool

CHWS_TOOL

Dieses Tool fügt die OpenType -Funktionen chws , vchw , halt und vhal zu OpenType/TrueType -Schriftarten hinzu, wenn eine dieser Funktionen fehlt. Weitere Informationen zu diesen Funktionen finden Sie in Ost-Asian-Abstand.

Dieses Tool nutzt das Ost-Asian-Abstand-Paket als Kernmotor und hat folgende Vorteile:

• Einfachere API- und Befehlszeilenoptionen.
• Unterstützt CJK-Schriftarten bei frats.google.com in seiner integrierten Konfiguration.

Um der unterstützten Schriftliste neue Schriftarten hinzuzufügen, finden Sie unten im Abschnitt "Schriftarten" unten.

Installieren

pip install chws-tool

Wenn Sie mit den Entwicklungspaketen klonen und im bearbeitbaren Modus installieren möchten:

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

Befehlszeilenverbrauch

Das folgende Beispiel fügt die Funktionen in input.otf hinzu und speichert sie im build -Verzeichnis. Wenn das Argument ein Verzeichnis ist, erweitert das Tool es rekursiv auf alle Schriftarten im Verzeichnis.

add-chws input.otf

Verwenden Sie die Option -o , um das Ausgabemesterverzeichnis oder die Option --help für die vollständige Liste der Optionen zu ändern.

add-chws input_dir -o output_dir

API

Das folgende Beispiel erstellt eine Schriftart mit den Funktionen im Verzeichnis " build ", wenn die Funktionen anwendbar sind:

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

Wenn Sie es vorziehen, vorhandene Schriftarten zu überschreiben, können Sie das Ausgabeverzeichnis weglassen.

 import chws_tool

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

Wenn Ihr Programm Asyncio verwendet:

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

Schriftarten hinzufügen

Dieses Paket enthält eine integrierte Liste unterstützter Schriftarten in seiner Konfiguration.

Schriftarten, die nicht in der bekannten Liste mit der Standardkonfiguration verarbeitet werden, zeigt jedoch eine Warnmeldung.

Beim Hinzufügen neuer Schriftarten zur bekannten Schriftliste wird der folgende Vorgang empfohlen:

1. Finden Sie die Schriftnamen. Ausführen der add-chws mit --print-name Option kann sie drucken.
2. Fügen Sie sie zur Konfiguration hinzu.
3. (Optional) Erstellen Sie die Schriftart und führen Sie den visuellen Test aus. Dieser Schritt ist optional, da dieses Paket automatisch Glyph -Kollisionen durch Berechnung von Glyph -Umrissen vermeidet.
4. (Optional) Tenden Sie die Konfiguration bei Bedarf an.

Visueller Test

Der Hauptzweck dieses Prozesses besteht darin, zu enge Abstandsabschnitte oder Glyph -Kollisionen zu finden, die durch die Kernungen verursacht werden.

Dieses Instrument enthält heuristische Regeln, um die Anwendbarkeit der Abschnitte mithilfe der Glyphenmetriken zu bestimmen, geht jedoch davon aus, dass die Gesamtpunkt-Interpunktions-Glyphen mit voller Breite entsprechend sprachliche Konventionen wie in UAX#50 oder in CREQ genügend interne Bereiche haben. Leider folgen nicht alle Schriftarten den Konventionen.

Um den visuellen Test auszuführen:

1. Fügen Sie die Test -Schriftart der Schriftliste im oberen <script> -Block von tests/test.html hinzu.
2. Öffnen Sie es in Ihrem Browser.
3. Überprüfen Sie die Kontrollkästchen "Fullwidth", "Upright" und "AUSEL -Größe".

Hier ist die Checkliste und Tipps:

• Finden Sie heraus, wo Glyphen zu eng sind oder kollidieren, wenn die Funktion eingeschaltet ist, aber ohne die Funktion gut aussehen.
  • Anführungszeichen können am häufigsten kollidieren, insbesondere im vertikalen Fluss, aber manchmal auch im horizontalen Fluss.
  • "Open+Open" und "Close+Close" kollidieren eher als andere Paare.
  • Wählen Sie Glyphen aus, um zu überprüfen, wie viel Tinten die Glyphenmetriken überlaufen.
• Testen Sie sowohl horizontale als auch vertikale Flüsse, indem Sie das Kontrollkästchen "vertikal" umdrehen.

Andere Kontrollen im Test sind nicht obligatorisch, können jedoch in folgenden Fällen nützlich sein.

• Deaktivieren Sie "Verstecken Sie die gleiche Größe", um Fälle zu sehen, in denen Kern nicht nach den integrierten Regeln angewendet werden. Sie sind normalerweise in Ordnung. In den meisten Fällen liegen sie daran, dass die Glyphen fehlen, sie sind keine vollständige Breite, oder das Paar sollte sich nicht für das Skript der Schriftart bewerben. Die Testdatei contaiisn Code Poitns für alle ostasiatischen Skripte, aber nicht alle Codepunkte sollten Bereiche für alle Skript anwenden.
• Die "Sprach" -Liste spielt in den meisten Fällen keine Rolle, außer wenn die Schrift mehrere Orte wie Noto CJK unterstützt.
• Die Funktion "Fullwidth" kann die Glyphen ändern, aber in den meisten Fällen sollten sie mit der Funktion in Ordnung aussehen, sie sollten mit der Funktion in Ordnung sein.
• Die "aufrechte" Funktion ist nur im vertikalen Fluss gültig. Aus dem gleichen Grund wie die Funktion "Fullwidth" können Sie es einfach einschalten.
• Die "Zeichen" -Ingabefelder können die Testfälle ändern. Sie müssen sie nicht ändern, es sei denn, Sie haben spezifische Anforderungen.

Freigeben

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