chws_tool

chws_tool

Alat ini menambahkan fitur OpenType chws , vchw , halt , dan vhal ke font OpenType/Truetype ketika salah satu fitur ini hilang. Silakan lihat ruang East-Asia untuk detail fitur-fitur ini.

Alat ini menggunakan paket spasi-Asia Timur sebagai mesin intinya, dan memiliki keunggulan berikut:

• Opsi API dan Command Line yang lebih sederhana.
• Mendukung font CJK di fonts.google.com dalam konfigurasi bawaannya.

Untuk menambahkan font baru ke daftar font yang didukung, silakan lihat bagian Penambahan Font di bawah ini.

Memasang

pip install chws-tool

Jika Anda ingin mengkloning dan menginstal dalam mode yang dapat diedit dengan paket pengembangan:

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

Penggunaan baris perintah

Contoh berikut menambahkan fitur ke input.otf dan menyimpannya ke direktori build . Jika argumennya adalah direktori, alat ini memperluasnya ke semua font di direktori secara rekursif.

add-chws input.otf

Gunakan opsi -o untuk mengubah direktori output, atau opsi --help untuk daftar lengkap opsi.

add-chws input_dir -o output_dir

API

Contoh berikut menciptakan font dengan fitur di direktori " build " jika fiturnya berlaku:

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

Jika Anda lebih suka menimpa font yang ada, Anda dapat menghilangkan direktori output.

 import chws_tool

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

Jika program Anda menggunakan 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 ())

Menambahkan font

Paket ini memiliki daftar font yang didukung secara bawaan di konfigurasi.

Font yang tidak dalam daftar yang diketahui masih diproses dengan konfigurasi default, tetapi paket ini menunjukkan pesan peringatan.

Saat menambahkan font baru ke daftar font yang diketahui, proses berikut direkomendasikan:

1. Temukan nama font. Menjalankan add-chws dengan opsi --print-name dapat mencetaknya.
2. Tambahkan ke konfigurasi.
3. (Opsional) Bangun font dan jalankan tes visual. Langkah ini opsional karena paket ini secara otomatis menghindari tabrakan mesin terbang dengan menghitung garis mesin mesin.
4. (Opsional) Tweak konfigurasi jika diperlukan.

Tes visual

Tujuan utama dari proses ini adalah untuk menemukan jarak yang terlalu ketat atau tabrakan mesin terbang yang disebabkan oleh kerning.

Alat ini memiliki aturan heuristik untuk menentukan penerapan jarak menggunakan metrik mesin terbang, tetapi mengasumsikan bahwa mesin terbang tanda baca lebar penuh memiliki jarak internal yang cukup sesuai dengan konvensi linguistik seperti di UAX#50 atau di Clreq. Sayangnya, tidak semua font mengikuti konvensi.

Untuk menjalankan tes visual:

1. Tambahkan font uji ke daftar font di blok <script> tests/test.html atas.
2. Buka di browser Anda.
3. Periksa "fullwidth", "tegak", dan "sembunyikan ukuran yang sama" kotak centang.

Berikut adalah daftar periksa dan tips:

• Temukan di mana mesin terbang terlalu ketat atau bertabrakan saat fitur aktif tetapi terlihat baik tanpa fitur.
  • Tanda kutipan dapat bertabrakan paling sering, terutama dalam aliran vertikal tetapi kadang -kadang dalam aliran horizontal juga.
  • "Open+Open" dan "Close+Close" lebih cenderung bertabrakan daripada pasangan lainnya.
  • Pilih mesin terbang untuk memeriksa berapa banyak tinta meluap metrik mesin terbang.
• Uji aliran horizontal dan vertikal dengan membalik kotak centang "vertikal".

Kontrol lain dalam tes tidak wajib, tetapi mungkin berguna dalam kasus berikut.

• Hapus centang "Sembunyikan ukuran yang sama" untuk melihat kasus-kasus di mana kerning tidak diterapkan oleh aturan bawaan. Mereka biasanya baik -baik saja. Dalam kebanyakan kasus, mereka karena mesin terbang hilang, mereka tidak penuh lebar, atau pasangan tidak boleh berlaku untuk skrip font. File uji Contaisn Code Poitns untuk semua skrip Asia Timur, tetapi tidak semua poin kode harus menerapkan jarak untuk semua skrip.
• Daftar "Bahasa" tidak masalah dalam banyak kasus, kecuali ketika font mendukung banyak lokal, seperti Noto CJK.
• Fitur "Fullwidth" dapat mengubah mesin terbang, tetapi dalam kebanyakan kasus, jika mesin terbang terlihat baik -baik saja dengan fitur, mereka harus baik -baik saja dengan fitur OFF.
• Fitur "tegak" hanya valid dalam aliran vertikal. Anda bisa memeriksanya, untuk alasan yang sama dengan fitur "Fullwidth".
• Bidang input "karakter" dapat mengubah kasus uji. Anda tidak perlu mengubahnya kecuali Anda memiliki kebutuhan khusus.

Melepaskan

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