afdko
4.0.2
AFDKO عبارة عن مجموعة من الأدوات لإنشاء ملفات خطوط OpenType من بيانات خطوط PostScript وTrueType.
يحتوي هذا المستودع على ملفات البيانات، ونصوص بايثون، ومصادر برامج سطر الأوامر التي تتكون منها AFDKO. يستخدم المشروع ترخيص Apache 2.0 مفتوح المصدر. يرجى ملاحظة أن AFDKO يستخدم العديد من التبعيات، المدرجة في ملف require.txt، والتي سيتم تثبيتها تلقائيًا إذا قمت بتثبيت AFDKO باستخدام pip . معظم هذه التبعيات هي ترخيص BSD أو MIT، باستثناء tqdm وهو MPL 2.0.
يرجى الرجوع إلى نظرة عامة على AFDKO للحصول على وصف أكثر تفصيلاً لما تتضمنه الحزمة.
يرجى مراجعة الويكي للحصول على معلومات إضافية، مثل الروابط إلى المواد المرجعية والمشاريع ذات الصلة.
تمت (إعادة) دمج منفذ Python الخاص بـ psautohint في مستودع AFDKO باسم "otfautohint"
يمكن العثور على مزيد من المعلومات في docs/otfautohint_Notes.md
يتطلب AFDKO إصدار Python 3.9 أو إصدار أحدث. يجب أن تعمل مع أي إصدار من Python> 3.9، ولكن في بعض الأحيان لا تواكب مكونات سلسلة الأدوات والتبعيات إصدارات Python الرئيسية، لذلك قد يكون هناك بعض التأخير أثناء اللحاق بالركب.
الإصدارات متاحة على Python Package Index (PyPI) ويمكن تثبيتها باستخدام النقطة.
ملاحظة لمستخدمي macOS: نوصي بعدم استخدام نظام Python. من بين أسباب أخرى، تأتي بعض إصدارات macOS مع Python 2 وأحدث إصدار من AFDKO متاح فقط لـ Python 3. يمكنك العثور على تعليمات حول استخدام Brew لتثبيت Python 3 على macOS هنا: تثبيت Python 3 على Mac OS X. أيضًا : pyenv هي أداة رائعة لتثبيت إصدارات Python المتعددة وإدارتها على نظام التشغيل macOS.
ملاحظة لجميع المستخدمين: نوصي بشدة باستخدام بيئة Python الافتراضية ( venv ) واستخدام python -m pip install <package> لتثبيت جميع الحزم (وليس فقط AFDKO). يمكن أن يؤدي استدعاء pip install مباشرة إلى استدعاء pip الخاطئة وهبوط الحزمة في الموقع الخطأ. يساعد الجمع بين استخدام venv + python -m pip install على ضمان وصول الحزم المُدارة بواسطة النقطة إلى المكان المناسب.
ملاحظة لمستخدمي Linux (ومستخدمي الأنظمة الأساسية الأخرى التي ليست macOS أو Windows): عندما لا تكون هناك "عجلة" معدة مسبقًا لنظامك الأساسي، ستحاول pip إنشاء أجزاء C وC++ من الحزمة من المصدر. لن تنجح هذه العملية إلا إذا تم تثبيت أدوات تطوير C وC++ وlibuuid. انظر البناء من المصدر أدناه.
الخيار 1 (موصى به)
إنشاء بيئة افتراضية:
python -m venv afdko_envتفعيل البيئة الافتراضية:
ماك ولينكس
source afdko_env/bin/activateويندوز
afdko_env S cripts a ctivate.batتثبيت أفدكو:
python -m pip install afdkoيؤدي تثبيت afdko داخل بيئة افتراضية إلى منع حدوث تعارضات بين تبعياته والوحدات النمطية الأخرى المثبتة عالميًا.
الخيار 2 (لا ينصح به إلا إذا كان هناك صراع عالمي)
تثبيت المستخدم المحلي afdko (معلومات):
python -m pip install --user afdko
استخدم الخيار -U (أو --upgrade ) لتحديث afdko (وتوابعه) إلى أحدث إصدار مستقر:
python -m pip install -U afdko
للحصول على إصدارات ما قبل النشر وقيد التطوير، استخدم علامة --pre :
python -m pip install -U afdko --pre
لإزالة الحزمة afdko استخدم الأمر:
python -m pip uninstall afdko
يجب عليك أولاً تثبيت أدوات التطوير لنظامك الأساسي.
على نظام التشغيل macOS، قم بتثبيت هذه العناصر باستخدام:
xcode-select --install
على Linux (Ubuntu 17.10 LTS أو أحدث)، قم بتثبيت هذه العناصر باستخدام:
apt-get -y install python3.9
apt-get -y install python-pip
apt-get -y install python-dev
apt-get -y install uuid-dev
في أنظمة التشغيل الأخرى المشابهة لـ POSIX، قد يكون libuuid وملفات الرأس الخاصة به موجودة في حزمة تسمى libuuid-devel أو util-linux-libs . يتم الاحتفاظ بالكود المصدري لـ libuuid في مستودع util-linux.
على نظام التشغيل Windows، تحتاج إلى Visual Studio 2017 أو إصدار أحدث.
لإنشاء afdko من المصدر، انسخ مستودع afdko GitHub، وتأكد من تثبيت وحدة wheel ( python -m pip install wheel )، ثم cd إلى دليل المستوى الأعلى لـ afdko، وقم بتشغيل:
python -m pip install .
إذا كنت ترغب في تطوير وتصحيح AFDKO باستخدام Xcode، فقم بتشغيل:
CMake -G Xcode .
لمزيد من المعلومات حول البناء من المصدر، راجع docs/FDK_Build_Notes.md.
ملحوظة
ليس من الممكن تثبيت afdko في وضع التحرير/التطوير باستخدام python -m pip install -e . ; وذلك لأن مجموعة الأدوات تشتمل على ملفات C الثنائية القابلة للتنفيذ والتي يحاول setup.py تثبيتها في المجلد bin/ (أو Scripts/)، ومع ذلك، كان المقصود من هذه العملية فقط استخدامها مع البرامج النصية المستندة إلى النص (إما مكتوبة بلغة Python أو برمجية Shell لغة). للتغلب على هذه المشكلة (والتي تؤثر فقط على عدد قليل من مطوري afdko الأساسيين الذين يحتاجون إلى الحصول على تعليقات مباشرة أثناء قيامهم بتعديل الملفات المصدر)، يمكنك استخدام طرق بديلة مثل تصدير PYTHONPATH، باستخدام ملف .pth أو عمليات اختراق مماثلة. لمزيد من التفاصيل اقرأ هذا التعليق.
تمت إعادة هيكلة AFDKO بحيث يمكن تثبيته كحزمة Python. وهو يعتمد الآن على مترجم Python الخاص بالمستخدم، ولم يعد يحتوي على مترجم Python الخاص به.
تم إسقاط برنامجين، IS و checkoutlines، لأن كود المصدر الخاص بهما لا يمكن أن يكون مفتوح المصدر. تتوفر هذه الأدوات في الإصدار 2.5.65322 والإصدارات الأقدم.
ملحوظة
إذا قمت بتثبيت AFDKO القديم بالإضافة إلى حزمة PyPI afdko الجديدة، فستكون للأدوات من الإصدار الأحدث الأسبقية على الإصدار الأقدم. يحدث هذا لأن النقطة تضيف مسار حزمة afdko في بداية متغير بيئة PATH الخاص بالنظام، بينما يضيفه المثبت القديم في النهاية؛ لا يتم التراجع عن هذا التعديل على PATH بواسطة برنامج إلغاء التثبيت. إذا كنت تريد إزالة المسار إلى الإصدار الأحدث بالكامل، فسيتعين عليك تعديل المسار. على نظام التشغيل Mac، يعني هذا تحرير السطر الموجود في ملف تسجيل الدخول الخاص بك والذي يقوم بتعيين متغير PATH. في نظام التشغيل Windows، يعني هذا تحرير متغير بيئة PATH في لوحة التحكم بالنظام.
