afmtodit(1)

الاسم
afmtodit - تكييف ملفات مقاييس خطوط أدوبي لإخراج groff بوستسكريبت وPDF

موجز
afmtodit [-ckmnqsx] [-a slant] [-d device-description-file] [-e encoding-file] [-f internal-name] [-i italic-correction-factor] [-o output-file] [-w space-width] afm-file map-file font-description-file

afmtodit --help

afmtodit -v
afmtodit --version

الوصف
يُولّد afmtodit ملف وصف خط للاستخدام مع جهازي إخراج ps وpdf التابعين لـ groff(1) من ملف مقاييس خطوط أدوبي، afm-file. يربط map-file اسم حرف عادي أو خاص في groff باسم صورة طباعية في بوستسكريبت. يُكتب الإخراج بتنسيق groff_font(5) إلى font-description-file، وهو ملف يُسمى باسم خط groff المقصود (لكن انظر الخيار -o).

يجب أن يحتوي map-file على سلسلة من الأسطر بالشكل
        ps-glyph groff-char
حيث ps-glyph هو اسم الصورة الطباعية في بوستسكريبت وgroff-char هو معرّف حرف عادي (إذا كان بطول وحدة) أو خاص (إذا كان أطول) في groff. يمكن أن يظهر نفس ps-glyph عدة مرات في الملف؛ يجب أن يظهر كل groff-char مرة واحدة على الأكثر. تُتجاهل الأسطر التي تبدأ بـ“#” والأسطر الفارغة. إذا لم يُعثر على الملف في الدليل الحالي، يُبحث عنه في الدليل الفرعي devps/generate من دليل الخطوط المبدئي.

إذا لم يُذكر شكل طباعي في بوستسكريبت في map-file، ولم يمكن استنتاج اسم حرف groff باستخدام قائمة صور أدوبي الطباعية (AGL، المضمنة في afmtodit)، فإن afmtodit يضع الصورة الطباعية في بوستسكريبت في ملف وصف خط groff كصورة طباعية غير مسماة لا يمكن الوصول إليها إلا بتسلسل الهروب “\N” في مستند roff. على وجه الخصوص، ينطبق هذا على متغيرات الصور الطباعية المسماة بالشكل “foo.bar”؛ جميع أسماء الصور الطباعية التي تحتوي على نقطة واحدة أو أكثر تُرسل إلى كيانات غير مسماة. ما لم يُحدد -e، يُستخدم الترميز المُعرّف في ملف AFM (أي الإدخالات ذات الرموز غير السالبة). راجع القسم “Using Symbols” في Groff: The GNU Implementation of troff، أو دليل groff Texinfo، أو groff_char(7،) التي تصف كيفية بناء معرّفات الأحرف في groff.

الصور الطباعية غير المرمّزة في ملف AFM (أي الإدخالات المفهرسة كـ“-1”) لا تزال متاحة في groff؛ تحصل على قيم فهرس صور طباعية أكبر من 255 (أو أكبر من أكبر رمز مستخدم في ملف AFM في الحالة غير المحتملة أن يكون أكبر من 255) في ملف وصف خط groff. فهارس الصور الطباعية غير المرمّزة ليس لها ترتيب محدد؛ من الأفضل الوصول إليها فقط عبر معرّفات الأحرف الخاصة.

إذا كان ملف الخط الفعلي (وليس مقاييسه فقط) متاحًا، فإن إدراجه في الملفين /usr/share/groff/1.24.1/font/devps/download و/usr/share/groff/1.24.1/font/devpdf/download يُتيح تضمينه في الإخراج المُنتج بواسطة grops(1) و gropdf(1) على التوالي.

إذا استُخدم الخيار -i، يُولّد afmtodit آليًا تصحيحًا مائلًا، وتصحيحًا مائلًا أيسر، وتصحيحًا سفليًا لكل صورة طباعية (أهمية هذه الأمور موضحة في groff_font(5)؛) يمكن تحديدها لصور طباعية فردية بإضافة أسطر من الشكل التالي إلى afm-file:
        italicCorrection ps-glyph n
        leftItalicCorrection ps-glyph n
        subscriptCorrection ps-glyph n
حيث ps-glyph هو اسم الصورة الطباعية في بوستسكريبت، وn هو القيمة المطلوبة للمعامل المقابل بأجزاء من ألف من وحدة em. هذه المعاملات مطلوبة عادة فقط للخطوط المائلة (أو المنحرفة).

يجب إعطاء الخيار -s إذا كان الخط “خاصًا”، مما يعني أن groff يجب أن يبحث فيه كلما لم يُعثر على صورة طباعية في الخط الحالي. لتمكين هذا البحث، يمكن إدراج font-description-file كوسيطة للتوجيه fonts في ملف DESC لجهاز الإخراج؛ بدلاً من ذلك، يمكن لمستند تعيينه باستخدام طلب special. إذا لم يكن الخط خاصًا، فلا حاجة للقيام بأي منهما، حيث أن troff(1) سيقوم بوصلها آلي عند أول استخدام.

الخيارات
يعرض --help رسالة الاستخدام، بينما يعرض -v و --version معلومات الإصدار؛ ويخرج الجميع بعد ذلك.

-a الانحدار
    استخدم الانحدار كمعامل الانحدار (“زاوية”) في ملف وصف الخط؛ يُستخدم هذا بواسطة groff في وضع العلامات التشكيلية. مبدئي، يستخدم afmtodit القيمة السالبة لـ ItalicAngle المحددة في ملف AFM؛ مع الخطوط المائلة الحقيقية، قد يكون من المرغوب أحيانًا استخدام انحدار أقل من هذا. إذا وجدت أن خطًا مائلًا يضع العلامات التشكيلية فوق الحروف الأساسية بعيدًا جدًا إلى اليمين، استخدم -a لإعطائه انحدارًا أصغر.

-c  قم بتضمين تعليقات في ملف وصف الخط لتحديد خط PostScript.

-d ملف-وصف-الجهاز
    ملف وصف الجهاز هو desc-file بدلاً من DESC المبدئي. إذا لم يُعثر عليه في الدليل الحالي، يتم البحث في الدليل الفرعي devps لدليل الخطوط المبدئي (ينطبق هذا على كل من ملف وصف الجهاز المبدئي والملف المعطى مع الخيار -d).

-e ملف-الترميز
    يجب إعادة ترميز خط PostScript لاستخدام الترميز الموصوف في enc-file. تنسيق enc-file موصوف في grops(1). إذا لم يُعثر عليه في الدليل الحالي، يتم البحث في الدليل الفرعي devps لدليل الخطوط المبدئي.

-f الاسم-الداخلي
    يتم تعيين الاسم الداخلي لخط groff إلى name.

-i عامل-تصحيح-المائل
    قم بتوليد تصحيح مائل لكل حرف بحيث يكون عرضه زائد تصحيحه المائل مساويًا لـ عامل-تصحيح-المائل جزءًا من ألف من em زائد المقدار الذي تكون به الحافة اليمنى لمربع الإحاطة للحرف إلى يمين أصله. إذا أدى هذا إلى تصحيح مائل سالب، استخدم تصحيحًا مائلاً صفريًا بدلاً من ذلك.

    قم أيضًا بتوليد تصحيح منخفض مساوٍ لحاصل ضرب ظل انحدار الخط وأربعة أخماس ارتفاع x للخط. إذا أدى هذا إلى تصحيح منخفض أكبر من التصحيح المائل، استخدم تصحيحًا منخفضًا مساويًا للتصحيح المائل بدلاً من ذلك.

    قم أيضًا بتوليد تصحيح مائل أيسر لكل حرف مساوٍ لـ عامل-تصحيح-المائل جزءًا من ألف من em زائد المقدار الذي تكون به الحافة اليسرى لمربع الإحاطة للحرف إلى يسار أصله. قد يكون التصحيح المائل الأيسر سالبًا ما لم يُعط الخيار -m.

    هذا الخيار مطلوب عادة فقط مع الخطوط المائلة (أو المائلة المزيفة). تم إنشاء ملفات وصف الخطوط الموزعة مع groff باستخدام خيار -i50 للخطوط المائلة.

-o ملف-الإخراج
    اكتب إلى ملف-المخرجات بدلاً من ملف-وصف-الخط.

-k  احذف أي بيانات تقنين من خط groff؛ استخدم فقط للخطوط أحادية المسافة (ثابتة العرض).

-m  امنع قيم تصحيح مائل يساري سالبة. ملفات وصف الخط للأنماط الرومانية الموزعة مع groff أُنشئت باستخدام “-i0 -m” لتحسين التباعد مع eqn(1).

-n  لا تُخرج أمر “ligatures” لهذا الخط؛ استخدم مع الخطوط أحادية المسافة (ثابتة العرض).

-q  اخفض تحذيرات التعيين المكرر؛ انظر القسم “التشخيصات” أدناه.

-s  أضف التوجيه “special” إلى ملف وصف الخط.

-w عرض-المسافة
    استخدم عرض-المسافة كعرض للمسافات بين الكلمات.

-x  لا تستخدم قائمة Adobe Glyph المدمجة.

حالة الخروج
يخرج afmtodit بحالة 0 عند التشغيل الناجح، وحالة 2 إذا لم يستطع البرنامج تفسير وسائط سطر الأوامر، وحالة 1 إذا واجه خطأ أثناء التشغيل.

الملفات

/usr/share/groff/1.24.1/font/devps/DESC
    يصف جهاز المخرجات ps.

/usr/share/groff/1.24.1/font/devps/F
    يصف الخط المعروف باسم F على الجهاز ps.

/usr/share/groff/1.24.1/font/devps/download
    يسرد الخطوط المتاحة للتضمين داخل مستند PostScript (أو التحميل إلى الجهاز).

/usr/share/groff/1.24.1/font/devps/generate/dingbats.map
/usr/share/groff/1.24.1/font/devps/generate/dingbats-reversed.map
/usr/share/groff/1.24.1/font/devps/generate/slanted-symbol.map
/usr/share/groff/1.24.1/font/devps/generate/symbol.map
/usr/share/groff/1.24.1/font/devps/generate/text.map
    تعيّن الأسماء في قائمة Adobe Glyph إلى معرفات الأحرف الخاصة لـ groff لخطوط Zapf Dingbats (ZD)، وZapf Dingbats المعكوس (ZDR)، والرمز المائل (SS)، والرمز (S)، والنص، على التوالي. تنتج ملفات map-file هذه ملفات وصف الخط المقدمة مع groff لمشغل المخرجات grops.

التشخيصات

اسم AGL 'x' معيّن بالفعل إلى اسم groff 'y
    '; تجاهل اسم AGL 'uniXXXX' يمكنك تجاهل هذه إذا كانت بالشكل الموضح، حيث يحتوي اسم AGL المُتجاهَل على أربعة أرقام ست عشرية XXXX. قائمة حروف أدوبي (AGL) لها أسماءها الخاصة للحروف الرسومية؛ غالبًا ما تختلف عن أسماء الأحرف الخاصة لـ groff. يقوم afmtodit ببناء تعيين من أسماء الأحرف الخاصة لـ groff إلى أسماء AGL؛ يمكن أن يكون هذا تعيينًا واحدًا لواحد أو متعددًا لواحد، لكن واحدًا لمتعدد لن يعمل، لذلك يتجاهل afmtodit التعيينات الزائدة. على سبيل المثال، إذا كان x هو Delta، و y هو *D، و XXXX هو 0394، فإن afmtodit يخبرك أن وصف خط groff الذي يكتبه لا يمكنه تعيين الحرف الخاص لـ groff \[*D] إلى حرفي AGL الرسوميين Delta و uni0394 في نفس الوقت.

    إذا تلقيت رسالة كهذه ولكنك غير راضٍ عن التعيين المُتجاهَل، فإن العلاج هو صياغة map-file بديل وإعادة تشغيل afmtodit باستخدامه.

    عند استخدام الخيار -q، يتم كبت هذه الرسائل لصالح عدد الرسائل التي كان سيتم إصدارها لو لم يكن الخيار موجودًا.

انظر أيضًا
Groff: The GNU Implementation of troff، من تأليف Trent A. Fisher و Werner Lemberg، هو دليل groff الأساسي. قد يكون القسم “استخدام الرموز” جديرًا بالملاحظة بشكل خاص. يمكنك تصفحه تفاعليًا باستخدام “info '(groff)استخدام الرموز'”.

groff(1), gropdf(1), grops(1), groff_font(5)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.