chws_tool

chws_tool

تضيف هذه الأداة ميزات Opentype chws و vchw و halt و vhal إلى خطوط Opentype/TrueType عندما تكون أي من هذه الميزات مفقودة. يرجى الاطلاع على المساحة الشرقية الآسيوية للحصول على تفاصيل هذه الميزات.

تستخدم هذه الأداة حزمة المساحة الشرقية الآسيوية كمحرك أساسي لها ، ولها مزايا التالية:

• أبسط واجهات واجهة برمجة التطبيقات وخيارات سطر الأوامر.
• يدعم خطوط 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. (اختياري) بناء الخط وقم بتشغيل الاختبار المرئي. هذه الخطوة اختيارية لأن هذه الحزمة تتجنب تلقائيًا تصادمات الرسول الرسمية عن طريق حساب الخطوط العريضة.
4. (اختياري) تعديل التكوين إذا لزم الأمر.

اختبار بصري

الغرض الأساسي من هذه العملية هو العثور على مباريات ضيقة للغاية أو تصادمات رسومية ناتجة عن kernings.

تحتوي هذه الأداة على قواعد مجلية لتحديد قابلية تطبيق الفواصل باستخدام مقاييس Glyph ، ولكنها تفترض أن الحروف المرتبطة بعرض كامل لديها ما يكفي من الفواصل الداخلية وفقًا للاتفاقيات اللغوية كما في UAX#50 أو في CLREQ. لسوء الحظ ، لا تتبع جميع الخطوط الاتفاقيات.

لتشغيل الاختبار المرئي:

1. أضف خط الاختبار إلى قائمة الخط في الجزء العلوي <script> كتلة tests/test.html .
2. افتحه في متصفحك.
3. تحقق من "Fullwidth" و "مستقيم" و "إخفاء نفس الحجم".

فيما يلي قائمة الشيكات والنصائح:

• ابحث عن المكان الذي تكون فيه الحروف الرسومية ضيقة جدًا أو تصطدم عند تشغيل الميزة ولكن تبدو جيدة بدون الميزة.
  • يمكن أن تصطدم علامات الاقتباس في أغلب الأحيان ، خاصة في التدفق العمودي ولكن في بعض الأحيان في التدفق الأفقي أيضًا.
  • من المرجح أن تصطدم "Open+Open" و "Close+Close" أكثر من الأزواج الأخرى.
  • حدد الحروف الرسومية للتحقق من مقدار الأحبار التي تغمر مقاييس الرسول الرمزية.
• اختبار كل من التدفقات الأفقية والرأسية عن طريق التقليب مربع الاختيار "العمودي".

الضوابط الأخرى في الاختبار ليست إلزامية ، لكنها قد تكون مفيدة في الحالات التالية.

• قم بإلغاء تحديد "إخفاء نفس الحجم" لرؤية الحالات التي لا يتم فيها تطبيق kernings بواسطة القواعد المدمجة. عادة ما تكون بخير. في معظم الحالات ، فهي لأن الرسوم الحرارية مفقودة ، أو أنها ليست كاملة ، أو يجب ألا يتقدم الزوج بطلب للحصول على البرنامج النصي للخط. ملف اختبار CONTAISN CODENs لجميع البرامج النصية لشرق آسيا ، ولكن لا ينبغي أن تطبق جميع نقاط التعليمات البرمجية الفواصل على جميع البرامج النصية.
• لا تهم قائمة "اللغة" في معظم الحالات ، إلا عندما يدعم الخط أماكن متعددة ، مثل Noto CJK.
• يمكن أن تغير ميزة "FullWidth" الحروف الرسومية ، ولكن في معظم الحالات ، إذا كانت الرسوم الرسومية تبدو على ما يرام مع الميزة ، فيجب أن تكون على ما يرام مع إيقاف الميزة.
• ميزة "الاستقامة" صالحة فقط في التدفق العمودي. يمكنك فقط التحقق من ذلك ، لنفس سبب ميزة "FullWidth".
• يمكن لحقول الإدخال "الأحرف" تغيير حالات الاختبار. ليس عليك تغييرها إلا إذا كان لديك احتياجات محددة.

إطلاق

انظر https://googlefonts.github.io/python#make-a-release.