الصفحة الرئيسية>موارد بناء الموقع>تحميل الخط
تنزيل

fontist

مكتبة بسيطة للعثور على الخطوط وتنزيلها لنظام التشغيل Windows و Linux و Mac.

تثبيت

تثبيته مباشرة على النحو التالي: 

gem install fontist

أو استخدمه كجزء من حزمةك عن طريق إضافة هذا الخط إلى Gemfile في التطبيق الخاص بك: 

 gem "fontist"

ثم تنفذ: 

bundle install

جلب الصيغ

بعد التثبيت ، يرجى إحضار الصيغ عبر أمر fontist : 

fontist update

التبعيات

يعتمد على ثنائي FFI-Libarchive الذي لديه المتطلبات التالية:

  • زلب

  • المغترب

  • OpenSSL (لـ Linux فقط)

هذه التبعيات موجودة بشكل عام على جميع الأنظمة.

باستخدام واجهة سطر الأوامر (CLI)

أمر fontist

هذه الأوامر تجعل العمل مع الخطوط عبر سطر الأوامر.

يدعم CLI حالة الخروج بشكل صحيح ، لذلك في حالة الخطأ ، يقوم بإرجاع رمز الحالة أعلى أو متساوي من 1 .

عمليات البحث غير حساسة لسهولة الاستخدام.

تدعم جميع الأوامر الخيارات العالمية التالية:

--preferred-family

ابحث باستخدام اسم "العائلة المفضلة" للخط. (بدلاً من اسم "العائلة الافتراضية" ، الافتراضي قبل fontist v1.10.)

ملحوظة
 انظر إلى v1.10+ للاطلاع على الاختلافات بين "الأسرة المفضلة" و "العائلة الافتراضية".
-q, --quiet

قم بطباعة أقل قدر ممكن من المعلومات ، ومعظمهم من الأخطاء الحرجة.

-v, --verbose

تعيين مستوى السجل لتصحيح. يطبع الصيغ المستبعدة أثناء التثبيت والمعلومات لمطوري Fontist.

-c, --no-cache

تفضل التنزيل المباشر حتى عندما يتم تخزين ملف بالفعل في نظام ما.

تثبيت الخطوط: fontist install

يتحقق Fontist ما إذا كان هذا الخط مثبتًا بالفعل ، وإذا لم يكن الأمر كذلك ، فإنه يقوم بتثبيت الخط ويعيد مساراته المثبتة.

اسم الخط هو الوسيطة الوحيدة التي يتم توفيرها. 

$ fontist install " segoe ui "
These fonts are found or installed:
- /Users/user/.fontist/fonts/SEGOEUI.TTF
- /Users/user/.fontist/fonts/SEGOEUIB.TTF
- /Users/user/.fontist/fonts/SEGOEUII.TTF
- /Users/user/.fontist/fonts/SEGOEUIZ.TTF

بشكل افتراضي ، يتم تثبيت جميع أنماط المطابقة (وفقًا لاسم "الأسرة الافتراضية" للخط).

ملحوظة
 قبل V1.10 ، يتم استخدام اسم "الأسرة المفضلة" للخط لمطابقة الأنماط للبحث. انظر إلى v1.10+ للحصول على تفاصيل هذا التغيير.

لتثبيت جميع الخطوط المحددة في صيغة fontist ، استخدم خيار -F, --formula . 

$ fontist install --formula ' courier_prime '
Downloading font ...
Installing font " courier_prime " .
Fonts installed at:
- /Users/user/.fontist/fonts/Courier Prime Bold Italic.ttf
- /Users/user/.fontist/fonts/Courier Prime Bold.ttf
- /Users/user/.fontist/fonts/Courier Prime Italic.ttf
- /Users/user/.fontist/fonts/Courier Prime.ttf

هنا ، courier_prime هو اسم ملف الصيغة الموجودة في مستودع Fontist Formula العام ( courier_prime.yml ).

يمكنك أيضًا تحديد الاسم القابل للقراءة البشرية للصيغة. هذا الاسم مشتق من اسم الملف ، مع استبدال السطح بمسافات. إنها ليست حساسة للحالة ، مما يعني أنه يمكنك استخدام الحروف الرأسمالية إذا كنت تفضل ذلك. 

$ fontist install --formula " Courier Prime "
$ fontist install --formula " Google/Noto Sans "

يدعم التثبيت بواسطة اسم الصيغة الاقتراحات في CLI عندما يكون الإدخال جزئيًا: 

$ fontist install --formula ' noto s '
Formula ' noto s ' not found. Did you mean ?
[0] Google/Noto Sans
[1] Google/Noto Serif
Please type number or press ENTER to skip installation:
ملحوظة
 تحديد اسم ملف الخط لم يتم دعمه بعد.

إذا كان هناك العديد من الصيغ ذات الخط المطلوب ، فإن fontist يبحث عن أحدث إصدار من الخط بين الصيغ ذات الحجم أقل من الحد (300 ميجابايت). يمكن تغيير هذا السلوك مع الخيارات.

ملحوظة
 إذا تم نشر أنماط الخط بين العديد من الصيغ ، فسيتم تثبيت جميع الأنماط المتاحة من جميع الصيغ.
ملحوظة
 قد تحتوي بعض الصيغ على سمة min_fontist ، والتي تحدد الحد الأدنى من الإصدار من fontist التي يمكن تثبيتها من خلالها. إذا كان fontist من إصدار أقدم ، فسيتم تجنب الصيغة لاستخدامها. من أجل معرفة الصيغ التي تم استبعادها من البحث ، يمكن تحديد خيار -v, --verbose .

الخيارات المدعومة:

-f, [--force]

تثبيت حتى لو تم تثبيته بالفعل في النظام

-F, [--formula]

تثبيت صيغة كاملة بدلاً من الخط

-a, [--accept-all-licenses]

قبول جميع اتفاقيات الترخيص

-h, [--hide-licenses]

إخفاء نصوص الترخيص

-p, [--no-progress]

إخفاء التنزيل التقدم

-V, [--version=VERSION]

تثبيت نسخة معينة من الخط

-s, [--smallest]

تثبيت أصغر خط حسب حجم الملف إذا عدة

-n, [--newest]

قم بتثبيت أحدث إصدار من الخط إذا عدة

-S, [--size-limit=N]

حدد الحد الأعلى لحجم ملف الصيغة المراد تثبيتها (الافتراضي هو 300 ميغابايت)

-u, [--update-fontconfig]

تحديث fontconfig

ملحوظة
 يشبه أمر install مكالمة مكتبة Font.install .

قم بإلغاء تثبيت الخطوط: fontist uninstall

قم بإلغاء تثبيت أي خط يدعمه Fontist.

إرجاع مسارات خط غير مثبت ، أو يطبع خطأ يخبره أن الخط غير مثبت أو لا يمكن العثور عليه في صيغ fontist. المستعار كما remove . 

$ fontist uninstall " segoe ui "
These fonts are removed:
/Users/user/.fontist/fonts/SEGOEUII.TTF
/Users/user/.fontist/fonts/SEGOEUIZ.TTF
/Users/user/.fontist/fonts/SEGOEUIB.TTF
/Users/user/.fontist/fonts/SEGOEUI.TTF

الحالة: fontist status

مطبوعات مثبتة مسارات الخط مع صيغة مقابلة. 

$ fontist status " segoe ui "
Fonts found at:
- /Users/user/.fontist/fonts/SEGOEUII.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUIZ.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUIB.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUI.TTF (from segoe_ui formula)

القائمة: fontist list

يسرد حالة التثبيت للخطوط التي يدعمها Fontist. 

$ fontist list " segoe ui "
segoe_ui
 Segoe UI
  Regular (installed)
  Bold (installed)
  Italic (installed)
  Bold Italic (installed)
$ fontist list " roboto mono "
google/roboto_mono
 Roboto Mono
  Regular (not installed)
  Italic (not installed)

قائمة مسارات الخطوط المثبتة: fontist manifest-locations

إرجاع مواقع الخطوط المحددة في ملف yaml كمدخل. 

$ fontist manifest-locations MANIFEST_FILE

MANIFEST_FILE هو موقع ملف واضح يحتوي على مواصفات لخط أو أنماط خط وخط متعددة.

يمكن أن يبدو manifest.yml ملف واضح. 

 Segoe UI :
- Regular
- Bold
Roboto Mono :
- Regular

سيقوم الأمر التالي بإرجاع إخراج YAML التالي: 

$ fontist manifest-locations manifest.yml
---
Segoe UI :
  Regular :
    full_name : Segoe UI
    paths :
    - " /Users/user/.fontist/fonts/SEGOEUI.TTF "
  Bold :
    full_name : Segoe UI Bold
    paths :
    - " /Users/user/.fontist/fonts/SEGOEUIB.TTF "
Roboto Mono :
  Regular :
    full_name : Roboto Mono Regular
    paths :
    - " /Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf "

إذا كان أحد الخطوط المطلوبة أو أكثر من الخطوط المطلوبة ، فسيتم إرجاع رمز الخطأ "3" ، وطباعة رسالة: 

$ fontist manifest-locations manifest.yml
' Roboto Mono ' ' Regular ' font is missing, please run ` fontist install ' Roboto Mono ' ` to download the font.
$ echo $?
3

تثبيت الخطوط من fontist manifest-install :

تثبيت خطوط من بيان Fontist Yaml: 

$ fontist manifest-install --confirm-license manifest.yml

حيث manifest.yaml هو: 

---
Segoe UI :
  Regular :
    full_name : Segoe UI
    paths :
    - " /Users/user/.fontist/fonts/SEGOEUI.TTF "
  Bold :
    full_name : Segoe UI Bold
    paths :
    - " /Users/user/.fontist/fonts/SEGOEUIB.TTF "
Roboto Mono :
  Regular :
    full_name : Roboto Mono Regular
    paths :
    - " /Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf "

العمل مع تكوين fontist: fontist config

يدعم Fontist إعدادات على مستوى النظام للمعلمات التالية:

fonts_path

يضبط المسار عند تثبيت الخطوط (الافتراضي: ~/.fontist/fonts )

open_timeout

يحدد المهلة لفتح اتصال أثناء التنزيل (افتراضي: 10 )

read_timeout

يحدد مهلة لقراءة الاتصال المفتوح أثناء التنزيل (الافتراضي: 10 )

إظهار السمات الحالية في التكوين: 

$ fontist config show
Current config:
read_timeout: 5

تعيين قيمة إلى سمة: 

$ fontist config set read_timeout 60

استعادة قيمة افتراضية للسمات: 

$ fontist config delete read_timeout

العمل مع FontConfig: fontist fontconfig

FontConfig هو برنامج مصمم لتوفير خطوط لبرامج أخرى. يتم استخدامه عادة على Linux ، ولكنه متوفر أيضًا على MacOs و Windows. يتم استخدام FontConfig بواسطة libreoffice و gimp والعديد من البرامج الأخرى.

من أجل العثور على خطوط fontist ، يجب تحديث FontConfig لتشمل مسارات fontist. يمكن القيام به مع خيار --update-fontconfig لأمر install ، أو عن طريق استدعاء واحد خاص: 

$ fontist fontconfig update

من شأنه أن ينشئ تكوينًا في ~/.config/fontconfig/conf.d/10-fontist.conf .

لإزالته ، يرجى استخدام: 

$ fontist fontconfig remove

العمل مع ذاكرة التخزين المؤقت 

$ fontist cache clear

سيقوم الأمر أعلاه بمسح ذاكرة التخزين المؤقت لـ Fontist's Download

مساعدة: fontist help

يمكن رؤية قائمة جميع الأوامر من خلال: 

fontist help

التكوين مع متغيرات البيئة

بشكل افتراضي ، يستخدم Fontist دليل ~/.fontist لتخزين الخطوط وملفاته. يمكن تغييره مع متغير بيئة FONTIST_PATH . 

FONTIST_PATH= ~ /.fontist_new fontist update

باستخدام مكتبة روبي

Fontist::Font

Fontist::Font هو مكانك للتعامل مع أي خط باستخدام Fontist.

تتيح لك هذه الواجهة العثور على خط أو تثبيت خط.

العثور على خط

يمكن استخدام واجهة Fontist::Font.find خطًا في نظامك.

سوف يبحث في أدلة الخطوط الخاصة بنظام التشغيل ، وكذلك دليل Fontist محدد ~/.fontist . 

 Fontist :: Font . find ( name )

  • إذا وجد Fontist خطًا ، فسوف يعيد المسارات.

  • خلاف ذلك ، فإنه إما أن يرفع خطأ الخط غير المدعوم ، أو تشغيل عرض تعليمات التثبيت لهذا الخط المحدد.

تثبيت خط

يمكن استخدام واجهة Fontist::Font.install لتثبيت أي خط مدعوم.

تتحقق هذه الواجهة أولاً إذا كان لديك بالفعل هذا الخط مثبتًا أم لا ، وإذا قمت بذلك ، فسيتم إرجاع المسارات.

إذا لم يكن لديك خط ولكن هذا الخط مدعوم من قبل Fontist ، فسيقوم بتنزيل الخط ونسخه إلى دليل ~/.fontist وأيضًا إرجاع المسارات. 

 Fontist :: Font . install ( name , confirmation : "no" )

إذا كانت هناك مشكلات تم اكتشافها مع الخط المقدم ، مثل الخط غير مدعوم ، فسيتم رفع هذه الأخطاء.

قائمة جميع الخطوط

تعرض واجهة Fontist::Font واجهة لسرد جميع الخطوط المدعومة.

قد يكون هذا مفيدًا إذا أردت معرفة اسم الخط أو الأنماط المتاحة. يمكنك القيام بذلك باستخدام: 

 Fontist :: Font . all

قيم الإرجاع هي كائنات OpenStruct ، بحيث يمكنك بسهولة القيام بأي عملية أخرى ستقوم بها في أي كائن روبي.

Fontist::Formula

تستخدم جوهرة fontist داخليًا واجهة Fontist::Formula للعثور على صيغة مسجلة أو خطوط مدعومة بأي صيغة. ما لم تكن بحاجة إلى فعل أي شيء مع ذلك يجب ألا تحتاج إلى العمل مع هذه الواجهة مباشرة. ولكن إذا فعلت ذلك ، فهذه هي الواجهة العامة التي تقدمها.

ابحث عن صيغة

تتيح لك واجهة Fontist::Formula.find العثور على أي من الصيغة المسجلة. تأخذ هذه الواجهة اسم الخط كوسيطة وتبحث من خلال كل من الصيغة المسجلة التي توفر هذا التثبيت الخط. الاستخدامات: 

 Fontist :: Formula . find ( "Calibri" )

ستقوم هذه الطريقة بالبحث وإرجاع صيغة fontist للكلمة الرئيسية المقدمة والتي تسمح بمزيد من المعالجة ، مثل فحص الترخيص أو المتابعة مع تثبيت الخط في نظامك.

قائمة أنماط الخطوط التي تدعمها صيغة

عادة ، يمكن أن يرتبط كل اسم خط مع أنماط أو مجموعة متعددة ، على سبيل المثال قد يحتوي خط Calibri على خطوط regular أو bold أو italic ، وإذا كنت تريد واجهة يمكنها إرجاع القائمة الكاملة ، فهذه هي صديقك.

يمكنك استخدامه على النحو التالي: 

 Fontist :: Formula . find_fonts ( "Calibri" )

قائمة جميع الصيغ

تعرض واجهة Fontist::Formula واجهة لسرد جميع صيغة الخط المسجلة. قد يكون هذا مفيدًا إذا أردت معرفة اسم الصيغة أو ما هي خطوط النوع التي يمكن تثبيتها باستخدام تلك الصيغة. الاستخدامات: 

 Fontist :: Formula . all

قيم الإرجاع هي كائنات OpenStruct ، بحيث يمكنك بسهولة القيام بأي عملية أخرى ستقوم بها في أي كائن روبي.

Fontist::Manifest

الخيارات العالمية

يمكن تبديل fontist لاستخدام أسماء العائلة المفضلة. تم استخدام هذا التنسيق قبل V1.10. 

 Fontist . preferred_family = true

Fontist::Manifest::Locations

يتيح لك Fontist العثور على مواقع الخطوط من تجزئة واضح محدد بالتنسيق التالي: 

 {
  "Segoe UI" => [ "Regular" , "Bold" ] ,
  "Roboto Mono" => [ "Regular" ]
}

إن استدعاء الكود التالي يعيد تجزئة متداخلة مع مسارات الخط والأسماء. اسم الخط مفيد لاختيار خط معين في ملف مجموعة الخط (TTC). 

 Fontist :: Manifest :: Locations . from_hash ( manifest ) 
 {
  "Segoe UI" => {
    "Regular" => {
      "full_name" => "Segoe UI" ,
      "paths" => [ "/Users/user/.fontist/fonts/SEGOEUI.TTF" ]
    } ,
    "Bold" => {
      "full_name" => "Segoe UI Bold" ,
      "paths" => [ "/Users/user/.fontist/fonts/SEGOEUIB.TTF" ]
    }
  } ,
  "Roboto Mono" => {
    "Regular" => {
      "full_name" => nil ,
      "paths" => [ ]
    }
  }
}

Fontist::Manifest::Install

لا يتيح لك Fontist الحصول على مواقع الخطوط فحسب ، بل أيضًا لتثبيت الخطوط من البيان: 

 Fontist :: Manifest :: Install . from_hash ( manifest , confirmation : "yes" )

سيتم تثبيت الخطوط وإعادة مواقعها: 

 {
  "Segoe UI" => {
    "Regular" => {
      "full_name" => "Segoe UI" ,
      "paths" => [ "/Users/user/.fontist/fonts/SEGOEUI.TTF" ] } ,
    "Bold" => {
      "full_name" => "Segoe UI Bold" ,
      "paths" => [ "/Users/user/.fontist/fonts/SEGOEUIB.TTF" ]
    }
  } ,
  "Roboto Mono" => {
    "Regular" => {
      "full_name" => "Roboto Mono Regular" ,
      "paths" => [ "/Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf" ]
    }
  }
}

دعم تنسيق Yaml

يدعم كلا الأوامر ملف yaml كمدخل باستخدام طريقة from_file . على سبيل المثال ، إذا كان هناك ملف manifest.yml . 

---
Segoe UI :
- Regular
- Bold
Roboto Mono :
- Regular

ثم ستعيد المكالمات التالية أسماء الخطوط والمسارات ، كما هو الحال من طريقة from_hash (انظر Fontist::Manifest::Install and Fontist::Manifest::Locations ). 

 Fontist :: Manifest :: Locations . from_file ( "manifest.yml" )
Fontist :: Manifest :: Install . from_file ( "manifest.yml" , confirmation : "yes" )

Fontist::Fontconfig

يدعم Fontist العمل مع FontConfig عبر واجهة Ruby: 

 Fontist :: Fontconfig . update              # let detect fontist fonts
Fontist :: Fontconfig . remove              # disable detection
Fontist :: Fontconfig . remove ( force : true ) # do not fail if no config exists

ميزات خاصة منصة

MacOS محددة الخطوط الإضافية

توفر الإصدارات الأحدث من MacOS منشآت عند الطلب لمجموعة واسعة من الخطوط المرخصة. يمكن تثبيت خطوط الوظائف الإضافية الخاصة بـ MacOS عبر Fontist.

يتمثل الاستخدام النموذجي لتثبيت خطوط MACOS الإضافية في السماح بوظائف CI على بيئات MACOS باستخدام هذه الخطوط المرخصة خصيصًا غير متوفرة على منصات أخرى.

يصف منشور المدونة هذا كيف يعمل هذا:

  • مدونة Fontist: تثبيت خطوط الإضافة الخاصة بـ MacOS

على سبيل المثال ، خط "Canela" هو خط تجاري يأتي مجانًا مع MacOS.

قم بتشغيل هذا الأمر لتثبيت Canela على MacOS. 

$ fontist install Canela

يمكن العثور على القائمة الكاملة للخطوط المتاحة على مختلف إصدارات MacOS على موقع دعم Apple:

  • الخطوط في Macos 13 Ventura

  • الخطوط في Macos 12 Monteray

  • الخطوط في MacOS 11 Big Sur

تحذير
 لا يسمح Fontist بتثبيت الخطوط الخاصة بـ MacOS على منصات غير MACOS بسبب قيود ترخيص الخط في تلك الخطوط.

الخطوط الإشكالية المعروفة

  • NISC18030.TTF (GB18030 BITMAP) - MacOS ، مزيد من المعلومات في عدد NISC18030

القائمة الكاملة للخطوط الإشكالية المعروفة:

  • قائمة الخطوط المستبعدة من الاستخدام

استخدام متقدم

باستخدام خوادم الوكيل

يستخدم Fontist git داخليًا لجلب الصيغ والخطوط.

من أجل استخدام وظائف GIT وراء الوكيل ، تحتاج إلى تحديث تكوين GIT الخاص بك عبر الأمر git config أو ملف تفضيل ~/.gitconfig .

هناك العديد من الطرق لتكوين تثبيت GIT المحلي لاستخدام الوكلاء.

أبسط طريقة عالمية لوضع وكيل لـ GIT هي ما يلي.

  • ل HTTP 

    git config --global http.proxy http://{user}:{pass}@{proxyhost}:{port}

  • بالنسبة إلى HTTPS ، قد تحتاج إلى التعامل مع أخطاء التحقق من SSL/TLS بعد تعيين الوكيل نظرًا لأن نهاية التشفير موجودة في نقطة نهاية الوكيل HTTPS: 

    git config --global http.proxy https://{user}:{pass}@{proxyhost}:{port}
git config --global https.proxy https://{user}:{pass}@{proxyhost}:{port}

  • للجوارب ، ستحتاج إلى اتخاذ قرار في بروتوكول الجوارب 

    git config --global http.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} '
git config --global https.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} '

    على سبيل المثال، 

    git config --global http.proxy ' socks5h://user:[email protected] '
git config --global https.proxy ' socks5h://user:[email protected] '

قائمة بروتوكولات الجوارب المدعومة لحقل {protocol} :

  • socks:// : للجوارب أدناه v5

  • socks5:// : for Socks V5

  • socks5h:// : للجوارب أدناه V5 + دقة المضيف عبر الجوارب

يمكنك في الواقع تعيين سلوك مختلف للوكالة لمستودعات GIT الفردية - يرجى الاطلاع على هذا الدليل الرائع حول كيفية استخدام الوكلاء GIT (بفضل مستخدم Github Evantoli).

مستودعات fontist المخصصة

عام

مستودع Fontist هو ريبو بالجيت يحتوي على ملفات صيغة YAML. يمكن إنشاء صيغ Fontist يدويًا داخل مستودع Fontist (انظر الأمثلة) ، أو تم إنشاؤه تلقائيًا من أرشيف الخط.

يمكن الوصول إلى مستودع fontist إما من خلال HTTPS أو SSH. في حالة SSH ، يجب إعداد مفتاح SSH المقابل مع ssh-agent من أجل الوصول إلى هذا المستودع المخصص.

تسجيل مستودع fontist

يجلب أمر fontist repo setup صيغ مستودع مخصص ، ويخزن اسم المستودع وعنوان URL لاستخدامه لاحقًا.

يستخدم أمر fontist repo setup بناء الجملة التالي. 

fontist repo setup NAME URL

داخليًا ، يتم تخزين جميع معلومات مستودع Fontist المخصصة في ~/.fontist/formulas/Formulas/private .

على سبيل المثال ، بالنظر إلى مستودع Fontist يسمى "ACME" يمكن الوصول إليه عبر عنوان URL أو عنوان SSH: 

fontist repo setup acme https://example.com/acme/formulas.git
# or
fontist repo setup acme [email protected]:acme/formulas.git

إدراج مستودعات الخطوط المخصصة 

fontist repo list

تثبيت الخطوط من مستودع Fontist

بمجرد إعداد مستودع Fontist المخصص ، يمكن للمرء تثبيت خطوط من الريبو من خلال صيغه: 

fontist install " custom font "

تحديث مستودع خطوط مسجل

إذا تم تحديث مستودع Fontist Formula المخصص ، فسيتم استخدام أمر repo update لسحب أحدث التغييرات: 

fontist repo update NAME

على سبيل المثال ، بالنظر إلى مستودع Fontist يسمى "ACME" ، يتم استخدام الأمر التالي. 

fontist repo update acme

إزالة مستودع fontist مسجل

إذا كانت هناك حاجة لإزالة مستودع fontist مسجل ، يمكن إزالة الريبو مع: 

fontist repo remove acme

وصول خاص

يمكن جعل صيغ Fontist المخصصة ومستودعات Fontist خاصة لتتطلب المصادقة.

لمستودعات Fontist HTTPS و SSH GIT

المصادقة للصيغ الخاصة أو مستودعات الصيغة الخاصة

يمكن تنفيذ ترخيص المحفوظات الخاصة في الصيغ الخاصة بالرؤوس.

فيما يلي مثال يعمل مع إصدارات GitHub: 

 resources :
  fonts.zip :
    urls :
    - url : https://example.com/repos/acme/formulas/releases/assets/38777461
      headers :
        Accept : application/octet-stream
        Authorization : token ghp_1234567890abcdefghi

إذا كان مستودع Fontist Formula عبارة عن ريبو GitHub ، فيمكن الحصول على رمز رمز على صفحة إعدادات GitHub> الرموز. يجب أن يكون لهذا الرمز على الأقل نطاق repo للوصول إلى هذه الأصول.

إنشاء صيغ fontist

عام

يمكن أن تكون صيغ fontist بسهولة مصنوعة يدويًا في Yaml. ومع ذلك ، يوصى باستخدام طريقة التوليد التلقائي لدقة البيانات وراحةها.

تلقائيا تلقائيا صيغة fontist من أرشيف الخط

يمكن إنشاء صيغة من أرشيف الخطوط.

يتيح أمر fontist create-formula اكتشاف جميع ملفات الخطوط من أرشيف الخط في العديد من التنسيقات (تلك المدعومة من الحفر ، بما في ذلك Zip ، 7z ، Gzip ، Tar ، Cab ، Exe).

يدعم أمر fontist create-formula المحفوظات الموجودة في عناوين URL عن بعد أو مسارات الملفات المحلية.

لمسارات الملفات ، حدد مسار الملف كوسيطة: 

wget https://www.latofonts.com/files/Lato2OFL.zip
fontist create-formula lato.zip

بالنسبة لعناوين URL ، ببساطة حدد عنوان URL كوسيطة: 

fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
# > file created at lato.yml because the file downloaded is lato.zip

لاختبار الصيغة التي تم إنشاؤها ، يمكن للمرء نسخ الصيغة إلى موقع مستودع صيغة المستخدم الخاص للمستخدم. 

fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
cp lato.yml ~ /.fontist/formulas/Formulas/

بيانات بيانات الوفيات الغالبة في صيغ fontist

يقوم أمر fontist create-formula بإنشاء صيغ خط باستخدام معلومات مضمنة في قسم بيانات التعريف OTF.

ومع ذلك ، غالبًا ما تحتوي بعض الخطوط (مثل الخطوط الأقدم) على معلومات البيانات الوصفية غير المتسقة أو غير المكتملة. تطبق بعض الخطوط على سبيل المثال قيم Family OTF مختلفة لأنماط الخطوط المختلفة. سيؤدي ذلك إلى عدم تسجيل جميع أنماط الخطوط في نفس العائلة.

يمكن للمؤلفين Fontist Formula تصحيح هذا الموقف باستخدام override: Key ، والذي يسمح للصيغة بتجاوز معلومات البيانات الوصفية التي تم الحصول عليها من البيانات الوصفية للخط.

ملحوظة
 لا يتسبب مفتاح override في أي تغيير في ملفات الخطوط ، فهو فقط لتحديث المعلومات التي يستخدمها Fontist داخليًا.

يوجد مفتاح override تحت تعريف أنماط الخطوط الفردية: 

 resources :
  ...
fonts :
- name : Original font name
  styles :
    - family_name : Original family name
      type : Original style
      override :
        family_name : Overridden family name
        type : Overridden style
        preferred_family_name : Overridden preferred family name

على سبيل المثال ، تستخدم خطوط "Frutiger" التي نشرتها Adobe في عام 1994 أرقام لتمثيل أنماط الخطوط الفردية ، وتضمين تلك الأسماء في مجال Family OTF ، مثل "Frutiger 45 Light". لا تستخدم هذه الخطوط أيضًا مجال Preferred Family لـ OTF ، وهو إضافة أحدث إلى OTF ، بسبب عمرها.

فيما يلي كيف يمكن لخاصية override أن تنفذ جميع الأساليب ذات الصلة المراد تسجيلها تحت اسم العائلة نفسه (عن طريق تجاوز قيمة preferred_family_name ): 

...
resources :
  ...
fonts :
- name : Frutiger 45 Light
  styles :
  - family_name : Frutiger 45 Light
    type : Regular
    full_name : Frutiger-Light
    post_script_name : Frutiger-Light
    override :
      preferred_family_name : Frutiger
  - ...

ستسمح هذه الشظية أعلاه Fontist بإنشاء فهارس صحيحة والسماح بتركيب جميع خطوط Frutiger بأمر واحد: 

$ fontist install " Frutiger " --preferred-family

ترقية fontist

إلى v1.10+

تستخدم إصدارات fontist وراء V1.10 تنسيق صيغة جديدة. بعد الترقية ، يرجى تشغيل fontist update لجلب أحدث الصيغ.

بدءًا من v1.10 ، يستخدم Fontist "العائلة الافتراضية" بدلاً من "الأسرة المفضلة" عند التجميع.

على سبيل المثال ، سيعود طلب خط "Lato" قبل V1.10 جميع الأنماط: "Black" ، "Black Mitalic" ، "Bold" ، و 15 أنماطًا أخرى.

من V1.10 فصاعدًا ، لن يعيد Fontist سوى الأنماط الافتراضية الأربعة: "العادية" ، "المائل" ، "Bold" و "Bold Italic".

من أجل جلب أنماط أخرى ، يجب عليك تحديد الخط "الفئة الفرعية" الدقيقة ، مثل "Lato Black" ، أو "Lato Heavy" ، أو استخدام خيار --preferred-family مع CLI و Fontist.preferred_family = true مع مكتبة الياقوت.

ملحوظة
 قبل V1.10 ، كان هناك خطأ مع صيغة الخط "Courier" ، والتي سمحت بتثبيت الخط عند طلب اسم الخط "Courier" ، ولكن لم يتمكن موقع الخط الخاص به فقط باستخدام اسم الخط "Courier الجديد" الكامل. من v1.10 فصاعدًا ، تم التوصل إلى السلوك ثابتًا - يجب استخدام اسم "Courier الجديد الجديد" فقط.

إلى V1.16+

تعامل إصدارات fontist بما يتجاوز الإصدار 1.16 وسيطة font لأمر install بشكل مختلف. بعد الترقية ، يرجى -F, --formula من تحديد جميع الخطوط المطلوبة عند استخدام fontist install ، أو fontist manifest-install ( Font.install واجهة Ruby المقابلة Manifest::Install

بدءًا من v1.16 ، يقوم Fontist بتثبيت الخطوط المطلوبة فقط بدلاً من صيغة كاملة ، ما لم يتم تحديدها بشكل صريح. تغير الآن.

على سبيل المثال ، سيقوم طلب التثبيت للخط "Arial" قبل V1.16 بإعداد جميع الخطوط الموجودة في صيغة "MS_TRUETYPE": "Arial" و "Trebuchet MS" و "Verdana" و "Times New Roman".

من V1.16 فصاعدًا ، سيقوم Fontist بتثبيت خط "Arial" المطلوب فقط .

لتثبيت جميع الخطوط من صيغة ، يمكن استخدام خيار -F, --formula : 

$ fontist install --formula ms_truetype

الصيانة (لمحافظة Fontist فقط!)

تحذير
 هذا القسم مخصص فقط لمحافظة الخطوط.

النسخة الصيغ

لإضافة سمة جديدة ، قم بتغيير كيفية معاملة الصيغة أو استبدال الهيكل بالكامل ، هناك طريقتان لتغيير تنسيق الصيغة:

  1. استخدم سمة min_fontist في صيغة. إنه يضع متطلبات لـ Fontist لتثبيت الصيغة فقط إذا كان نسخته متساوية أو أكثر من إصدار محدد.

  2. استخدم فرعًا جديدًا في الصيغ repo ، على سبيل المثال "V2" ، "V3" ، "V4" ، إلخ. بعد إنشاء فرع جديد ، يجب تعريفه في Fontist.formulas_version

ملحوظة
 سيتطلب استخدام فرع جديد من جميع المستخدمين إعادة تنزيل الصيغ بأكملها. نظرًا لأن هذه الطريقة لها أهمية كبيرة ، فيجب استخدام الشخص السابق ( min_fontist ) كلما أمكن ذلك.

استيراد الصيغ من خطوط Google

توفر Google Fonts على الأرجح أكبر مجموعة من الخطوط المرخصة بحرية الاستخدام ، بحرية وصراحة.

تتضمن مكتبة Fontist's Formula الدعم لجميع الخطوط المرخصة علنا المقدمة من خلال خطوط Google ، وتحافظ على صيغ Fontist لجميع هذه الخطوط.

يتحقق سير عمل GHA للخطوط المحدثة على Fonts Google Daily. في حالة العثور على تحديث ، تمت إضافته إلى الريبو بواسطة سير العمل.

استيراد الصيغ من الصمت ديناميكيًا

SIL International هي منظمة غير ربحية معترف بها دوليًا وتقرّم بها مجتمعات اللغة في جميع أنحاء العالم.

يوفر SIL عددًا من الخطوط الفريدة التي تدعم المجتمعات اللغوية الأصغر التي لا يتم دعمها (حتى الآن) مع رمز Unicode (حتى الآن).

يهدف Fontist إلى دعم جميع خطوط SIL ويوفر صيغها في مستودع Fontist Formula الافتراضي.

يمكن تحديثها بـ: 

fontist import sil
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/sil
git commit -m " SIL fonts update "
git push

استيراد الصيغ من MacOS بشكل ديناميكي

يوفر MacOS خطوطًا يمكن تنزيلها يدويًا باستخدام Font Book.app .

لتحديث صيغ MacOS: 

fontist import macos
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/macos
git commit -m " Update macOS formulas "
git push

تطوير

يثبت

استنساخ المستودع. 

git clone https://github.com/fontist/fontist

قم بإعداد بيئتك. 

bin/setup

قم بتشغيل مجموعة الاختبار 

bin/rspec

تخزين الصيغة

يتم الاحتفاظ بجميع صيغ الخطوط الرسمية في مستودع الصيغ.

إذا كنت ترغب في إضافة مستودع Formula جديد أو تغيير الإعدادات لآخر ، فيرجى الرجوع إلى وثائقه.

إطلاق

يتم الإطلاق تلقائيًا مع إجراءات github. مجرد عثرة وعلامة مع gem-release .

لإصدار التصحيح (0.0.x) استخدم: 

gem bump --version patch --tag --push

لإصدار بسيط (0.x.0) الاستخدام: 

gem bump --version minor --tag --push

المساهمة

أولا ، شكرا لك على المساهمة! نحن نحب طلبات السحب من الجميع. من خلال المشاركة في هذا المشروع ، يمكنك منح Ribose هذا الحق في منح أو نقل عدد غير محدود من التراخيص غير الحصرية أو الترخيص الفرعي إلى أطراف ثالثة ، تحت حقوق الطبع والنشر التي تغطي المساهمة لاستخدام المساهمة بكل الوسائل.

نحن نتابع قواعد Sandi Metz لهذه الأحجار الكريمة ، يمكنك قراءة وصف القواعد هنا. يجب أن تتبع جميع الكود الجديد هذه القواعد. إذا قمت بإجراء تغييرات في ملف موجود مسبقًا ينتهك هذه القواعد ، فيجب عليك إصلاح الانتهاكات كجزء من مساهمتك.

فيما يلي بعض الإرشادات الفنية التي يجب اتباعها:

  1. افتح مشكلة لمناقشة ميزة جديدة.

  2. اكتب اختبارات لدعم ميزةك الجديدة.

  3. تأكد من أن جناح الاختبار بأكمله يمر محليًا وعلى CI.

  4. افتح طلب سحب.

  5. Quash الخاص بك بعد تلقي التعليقات.

  6. حزب!

ائتمان

تم تطوير هذه الأحجار الكريمة وصيانتها وتمويلها بواسطة ريبوز.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل