.TH afmtodit 1 "2026-03-15" "groff 1.24.1"
.SH "نام (NAME)"
afmtodit \- تبدیل فایلهای متریک فونت ادوبی (AFM) به فرمت فونت groff
.
.
.\" ====================================================================
.\" Legal Terms
.\" ====================================================================
.\"
.\" Copyright 1989-2025 Free Software Foundation, Inc.
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of
.\" this manual under the conditions for verbatim copying, provided that
.\" the entire resulting derived work is distributed under the terms of
.\" a permission notice identical to this one.
.\"
.\" Permission is granted to copy and distribute translations of this
.\" manual into another language, under the above conditions for
.\" modified versions, except that this permission notice may be
.\" included in translations approved by the Free Software Foundation
.\" instead of in the original English.
.
.
.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr *groff_afmtodit_1_man_C \n[.cp]
.cp 0
.
.\" Define fallback for groff 1.23's MR macro if the system lacks it.
.nr do-fallback 0
.if !\n(.f           .nr do-fallback 1 \" mandoc
.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
.if \n[do-fallback]  \{\
.  de MR
.    ie \\n(.$=1 \
.      I \%\\$1
.    el \
.      IR \%\\$1 (\\$2)\\$3
.  .
.\}
.rr do-fallback
.
.
.\" ====================================================================
.SH "خلاصه دستور (SYNOPSIS)"
.\" ====================================================================
.
.SY afmtodit
.RB [ \-ckmnqsx ]
.RB [ \-a\~\c
.IR slant ]
.RB [ \-d\~\c
.IR device-description-file ]
.RB [ \-e\~\c
.IR encoding-file ]
.RB [ \-f\~\c
.IR internal-name ]
.RB [ \-i\~\c
.IR italic-correction-factor ]
.RB [ \-o\~\c
.IR output-file ]
.RB [ \-w\~\c
.IR space-width ]
.I afm-file
.I map-file
.I font-description-file
.YS
.
.
.P
.SY afmtodit
.B \-\-help
.YS
.
.
.P
.SY afmtodit
.B \-v
.YS
.
.SY afmtodit
.B \%\-\-version
.YS
.
.
.\" ====================================================================
.SH "توضیحات (DESCRIPTION)"
.\" ====================================================================
.
دستور
.I \%afmtodit
یک فایل توصیف فونت را برای استفاده در دستگاه‌های خروجی
.B ps
و
.B pdf
برنامه
.MR groff 1
از یک فایل متریک فونت ادوبی
.RI ( AFM )
به نام
.I afm-file
تولید می‌کند.
.
فایل
.I map-file
نام کاراکترهای معمولی یا ویژه
.I groff
را به نام گلیف PostScript متناظر پیوند می‌دهد.
.
خروجی در قالب
.MR groff_font 5
در
.I font-description-file
نوشته می‌شود؛ فایلی که نام آن برگرفته از نام فونت مدنظر در
.I groff
است
(البته گزینه
.B \-o
را ببینید).
.
.
.LP
فایل
.I map-file
باید شامل دنباله‌ای از خطوط با ساختار زیر باشد:
.
.RS
.EX
.I ps-glyph groff-char
.EE
.RE
.
که در آن
.I ps-glyph
نام گلیف PostScript و
.I groff-char
شناسه کاراکتر معمولی
(اگر طول آن یک واحد باشد)
یا ویژه
(اگر طولانی‌تر باشد)
در
.I groff
است.
.
یک
.I ps-glyph
یکسان می‌تواند چندین بار در فایل تکرار شود؛ اما هر
.I groff-char
باید حداکثر یک بار درج شده باشد.
.
خطوطی که با «#» شروع می‌شوند و خطوط خالی نادیده گرفته می‌شوند.
.
اگر این فایل در دایرکتوری جاری پیدا نشود، در زیردایرکتوری
.I devps/generate
از دایرکتوری پیش‌فرض فونت جستجو می‌شود.
.
.
.LP
اگر یک گلیف PostScript در
.I map-file
ذکر نشده باشد و نام کاراکتر
.I groff
نیز با استفاده از فهرست گلیف ادوبی
(AGL که درون
.I \%afmtodit
تعبیه شده است)
قابل استنتاج نباشد، آن‌گاه
.I \%afmtodit
گلیف PostScript را به عنوان یک گلیف بدون نام در فایل توصیف فونت
.I groff
قرار می‌دهد که فقط از طریق دنباله اسکیپ \[lq]\eN\[rq] در یک سند
.I roff
قابل دسترسی است.
.
به‌طور خاص، این موضوع برای گونه‌های مختلف گلیف که به صورت
.RI \[lq] foo . bar \[rq]
نام‌گذاری شده‌اند صادق است؛ تمام نام‌های گلیف که شامل یک یا چند نقطه باشند به موجودیت‌های بدون نام نگاشت می‌شوند.
.
مگر اینکه گزینه
.B \-e
مشخص شده باشد، از انکودینگ تعریف‌شده در فایل AFM
(یعنی ورودی‌هایی با کدهای غیرمنفی)
استفاده می‌شود.
.
به بخش \[lq]Using Symbols\[rq] در
.IR "Groff: The GNU Implementation of troff"
(راهنمای Texinfo برنامه
.IR groff )
یا
.MR groff_char 7
مراجعه کنید، که نحوه ساخت شناسه‌های کاراکتر
.I groff
را شرح می‌دهند.
.
.
.LP
گلیف‌هایی که در فایل AFM کدگذاری نشده‌اند
(یعنی ورودی‌هایی که با شناسه \[lq]\-1\[rq] مشخص شده‌اند)
همچنان در
.I groff
در دسترس هستند؛ این گلیف‌ها در فایل توصیف فونت
.IR groff ،
مقادیر اندیس گلیف بزرگتر از 255
(یا بزرگتر از بزرگترین کد استفاده‌شده در فایل AFM در شرایط نادری که بزرگتر از 255 باشد)
دریافت می‌کنند.
.
اندیس‌های گلیف‌های بدون کدگذاری ترتیب خاصی ندارند؛ بهتر است فقط از طریق شناسه‌های کاراکتر ویژه به آن‌ها دسترسی پیدا کنید.
.
.
.P
اگر خود فایل فونت
(و نه صرفاً متریک‌های آن)
در دسترس باشد، درج نام آن در فایل‌های
.I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:\%download
و
.I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devpdf/\:\%download
امکان جاسازی آن را به ترتیب در خروجی‌های تولیدشده توسط
.MR grops 1
و
.MR gropdf 1
فراهم می‌سازد.
.
.
.P
اگر گزینه
.B \-i
استفاده شود،
.I \%afmtodit
به‌طور خودکار یک تصحیح مورب (italic correction)، تصحیح مورب چپ (left italic correction) و یک تصحیح زیرنویس (subscript correction) برای هر گلیف ایجاد می‌کند
(اهمیت این موارد در
.MR groff_font 5
شرح داده شده است)؛
می‌توان این موارد را با افزودن خطوطی به شکل زیر به فایل
.I afm-file
برای گلیف‌های منفرد تعیین کرد:
.
.RS
.EX
.RI italicCorrection \~ps-glyph\~n
.RI leftItalicCorrection \~ps-glyph\~n
.RI subscriptCorrection \~ps-glyph\~n
.EE
.RE
.
که در آن
.I ps-glyph
نام گلیف PostScript و
.I n
مقدار مورد نظر برای پارامتر مربوطه بر حسب یک‌هزارم em است.
.
چنین پارامترهایی معمولاً فقط برای فونت‌های مورب
(یا مایل / oblique)
مورد نیاز هستند.
.
.
.P
گزینه
.B \-s
باید زمانی استفاده شود که فونت «ویژه» (special) باشد؛ یعنی هر زمان که گلیفی در فونت جاری یافت نشد،
.I groff
باید این فونت را جستجو کند.
.
برای فعال‌سازی این جستجو، می‌توان
.I font-description-file
را به عنوان یک آرگومان برای دستورالعمل
.B fonts
در فایل
.I DESC
دستگاه خروجی درج کرد؛ یا از طرف دیگر، یک سند می‌تواند آن را با درخواست
.B \%special
تعیین نماید.
.
اگر فونت ویژه نباشد نیازی به انجام هیچ‌کدام نیست، زیرا
.MR \%troff 1
در اولین باری که فونت استفاده می‌شود، آن را به‌طور خودکار سوار (mount) می‌کند.
.
.
.br
.ne 7v
.\" ====================================================================
.SH "گزینه‌ها (OPTIONS)"
.\" ====================================================================
.
گزینه
.B \-\-help
پیام راهنمای استفاده را نمایش می‌دهد، در حالی که
.B \-v
و
.B \%\-\-version
اطلاعات نسخه را نشان می‌دهند؛ هر دو پس از نمایش خارج می‌شوند.
.
.
.TP
.BI \-a\~ slant
استفاده از
.I slant
به عنوان پارامتر شیب (slant یا «زاویه») در فایل توصیف فونت؛ این پارامتر توسط
.I groff
در موقعیت‌یابی اعراب‌ها و نشانه‌ها (accents) استفاده می‌شود.
.
به‌طور پیش‌فرض،
.I \%afmtodit
از منفی مقدار
.B \%ItalicAngle
مشخص‌شده در فایل AFM استفاده می‌کند؛ در فونت‌های ایتالیک واقعی گاهی مطلوب است از شیبی کمتر از این مقدار استفاده شود.
.
اگر متوجه شدید که یک فونت ایتالیک نشانه‌ها را بیش از حد به سمت راست گلیف‌های پایه قرار می‌دهد، از
.B \-a
برای اختصاص شیب کوچکتری به آن استفاده کنید.
.
.
.TP
.B \-c
گنجاندن توضیحاتی (کامنت‌ها) در فایل توصیف فونت جهت شناسایی فونت PostScript.
.
.
.TP
.BI \-d\~ device-description-file
استفاده از فایل توصیف دستگاه
.I desc-file
به جای فایل پیش‌فرض
.IR DESC .
.
اگر در دایرکتوری جاری پیدا نشود، زیردایرکتوری
.I devps
از دایرکتوری پیش‌فرض فونت جستجو می‌شود
(این موضوع هم برای فایل پیش‌فرض توصیف دستگاه و هم برای فایل مشخص‌شده با گزینه
.BR \-d
صادق است).
.
.
.TP
.BI \-e\~ encoding-file
فونت PostScript باید برای استفاده از انکودینگ شرح داده شده در
.I enc-file
مجدداً انکود شود.
.
قالب
.I enc-file
در
.MR grops 1
توضیح داده شده است.
.
اگر در دایرکتوری جاری پیدا نشود، زیردایرکتوری
.I devps
از دایرکتوری پیش‌فرض فونت جستجو می‌شود.
.
.
.TP
.BI \-f\~ internal-name
تنظیم نام داخلی فونت
.I groff
روی
.IR name .
.
.
.TP
.BI \-i\~ italic-correction-factor
تولید یک تصحیح مورب (italic correction) برای هر گلیف به گونه‌ای که عرض آن به علاوه تصحیح موربش برابر با
.I italic-correction-factor
هزارمِ یک em، به‌علاوه مقداری باشد که لبه سمت راست کادر مرزی گلیف (bounding box) نسبت به مبدأ آن به سمت راست امتداد دارد.
.
اگر این محاسبه منجر به یک تصحیح مورب منفی شود، به جای آن تصحیح مورب صفر لحاظ می‌شود.
.
.
.IP
همچنین یک تصحیح زیرنویس (subscript correction) برابر با حاصل‌ضرب تانژانت شیب فونت در چهارپنجم x-height (ارتفاع نویسه x) فونت تولید می‌کند.
.
اگر این مقدار به یک تصحیح زیرنویس بزرگتر از تصحیح مورب منجر شود، به جای آن از تصحیح زیرنویسی برابر با تصحیح مورب استفاده می‌شود.
.
.
.IP
همچنین یک تصحیح مورب چپ (left italic correction) برای هر گلیف تولید می‌کند که برابر با
.I italic-correction-factor
هزارم یک em به‌علاوه مقداری است که لبه چپ کادر مرزی گلیف نسبت به مبدأ آن به سمت چپ امتداد دارد.
.
تصحیح مورب چپ ممکن است منفی باشد مگر اینکه گزینه
.B \-m
داده شده باشد.
.
.
.IP
این گزینه معمولاً فقط برای فونت‌های مورب
(یا مایل)
مورد نیاز است.
.
فایل‌های توصیف فونت ارائه‌شده همراه با
.I groff
برای فونت‌های ایتالیک با گزینه
.B \-i50
ساخته شده‌اند.
.
.
.TP
.BI \-o\~ output-file
نوشتن در
.I output-file
به جای
.IR font-description-file .
.
.
.TP
.B \-k
حذف داده‌های فاصله‌گذاری کاراکترها (kerning) از فونت
.IR groff ؛
فقط برای فونت‌های با عرض ثابت (monospaced) استفاده شود.
.
.
.TP
.B \-m
جلوگیری از مقادیر منفی در تصحیح مورب چپ.
.
فایل‌های توصیف فونت برای سبک‌های رومی (roman) توزیع‌شده با
.I groff
با
.RB \[lq] \-i0\~\-m \[rq]
ایجاد شده‌اند تا فاصله‌گذاری هنگام کار با
.MR \%eqn 1
بهبود یابد.
.
.
.TP
.B \-n
دستور
.RB \[lq] ligatures \[rq]
(حروف ترکیبی) را برای این فونت تولید نکن؛ برای فونت‌های با عرض ثابت (monospaced) استفاده شود.
.
.
.TP
.B \-q
بی‌صدا کردن هشدارهای نگاشت‌های تکراری؛ بخش «پیام‌های تشخیصی» در زیر را ببینید.
.
.
.TP
.B \-s
افزودن دستورالعمل
.RB \[lq] special \[rq]
به فایل توصیف فونت.
.
.
.TP
.BI \-w\~ space-width
استفاده از
.I space-width
به عنوان عرض فاصله‌های میان کلمات.
.
.
.TP
.B \-x
عدم استفاده از فهرست گلیف توکار ادوبی (Adobe Glyph List).
.
.
.\" ====================================================================
.SH "وضعیت خروج (EXIT STATUS)"
.\" ====================================================================
.
دستور
.I \%afmtodit
در صورت عملیات موفق با
.RB وضعیت\~ 0
خارج می‌شود؛ در صورتی که برنامه نتواند آرگومان‌های خط فرمان را تفسیر کند با
.RB وضعیت\~ 2
و در صورت بروز خطا در حین عملیات با
.RB وضعیت\~ 1
خارج می‌شود.
.
.
.\" ====================================================================
.SH "فایل‌ها (FILES)"
.\" ====================================================================
.
.TP
.I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:DESC
دستگاه خروجی
.B ps
را توصیف می‌کند.
.
.
.TP
.IR /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/ F
فونت شناخته‌شده با عنوان
.I F
روی دستگاه
.B ps
را توصیف می‌کند.
.
.
.TP
.I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:\%download
فهرست فونت‌های موجود برای جاسازی درون سند PostScript
(یا دانلود در دستگاه)
را نگهداری می‌کند.
.
.
.TP
.I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:\%generate/\:\%dingbats.map
.TQ
.I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:\%generate/\:\%dingbats\-reversed.map
.TQ
.I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:\%generate/\:\%slanted\-symbol.map
.TQ
.I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:\%generate/\:\%symbol.map
.TQ
.I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:\%generate/\:\%text.map
نام‌های موجود در فهرست گلیف ادوبی (AGL) را به شناسه‌های کاراکتر ویژه
.I groff
به ترتیب برای Zapf Dingbats
.RB ( ZD )،
reversed Zapf Dingbats
.RB ( ZDR )،
slanted symbol
.RB ( SS )،
symbol
.RB ( S )
و فونت‌های متنی نگاشت می‌کنند.
.
این
.IR map-file ها
فایل‌های توصیف فونت ارائه‌شده همراه با
.I groff
را برای درایور خروجی
.I \%grops
تولید می‌کنند.
.
.
.\" ====================================================================
.SH "پیام‌های تشخیصی (DIAGNOSTICS)"
.\" ====================================================================
.
.TP
.RI "AGL name \[aq]" x "\[aq] already mapped to groff name \[aq]" y\c
.RI "\[aq]; ignoring AGL name \[aq]uni" XXXX \[aq]
اگر پیام‌ها به شکل نشان داده شده باشند، که در آن نام AGL نادیده‌گرفته‌شده حاوی چهار رقم شانزده‌شانزدهی (هگزادسیمال)
.I XXXX
است، می‌توانید آن‌ها را نادیده بگیرید.
.
فهرست گلیف ادوبی (AGL) نام‌های مخصوص به خود را برای گلیف‌ها دارد؛ این نام‌ها اغلب با نام کاراکترهای ویژه در
.I groff
متفاوت هستند.
.
دستور
.I \%afmtodit
در حال ایجاد نگاشتی از نام‌های کاراکتر ویژه
.I groff
به نام‌های AGL است؛ این نگاشت می‌تواند یک‌به‌یک یا چندبه‌یک باشد، اما یک‌به‌چند کار نخواهد کرد، بنابراین
.I \%afmtodit
نگاشت‌های اضافی را کنار می‌گذارد.
.
برای مثال اگر
.I x
برابر
.BR \%Delta ،
.I y
برابر
.BR *D
و
.I XXXX
برابر
.B 0394
باشد،
.I \%afmtodit
به شما اعلام می‌کند فایل توصیف فونت
.I groff
که در حال نوشتن آن است نمی‌تواند کاراکتر ویژه
.B \[rs][*D]
در
.I groff
را هم‌زمان به هر دو گلیف AGL یعنی
.B \%Delta
و
.B uni0394
نگاشت کند.
.
.
.IP
اگر پیامی شبیه به این دریافت کردید اما از اینکه کدام نگاشت نادیده گرفته شده است رضایت ندارید، راه حل این است که یک
.I map-file
جایگزین تهیه کنید و
.I \%afmtodit
را مجدداً با استفاده از آن اجرا نمایید.
.
.
.IP
هنگامی که از گزینه
.B \-q
استفاده می‌شود، این پیام‌ها مهار شده و به جای آن‌ها تنها تعداد پیام‌هایی که در صورت نبود این گزینه صادر می‌شدند، نمایش داده می‌شود.
.
.
.\" ====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.\" ====================================================================
.
کتاب
.IR "Groff: The GNU Implementation of troff" ،
نوشته Trent A.\& Fisher و Werner Lemberg، راهنمای اصلی
.I groff
است.
.
بخش \[lq]Using Symbols\[rq] ممکن است اهمیت ویژه‌ای داشته باشد.
.
می‌توانید با دستور \[lq]info \[aq](groff)Using \%Symbols\[aq]\[rq] آن را به صورت تعاملی مرور کنید.
.
.
.LP
.MR groff 1 ,
.MR gropdf 1 ,
.MR grops 1 ,
.MR groff_font 5
.
.
.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[*groff_afmtodit_1_man_C]
.do rr *groff_afmtodit_1_man_C
.
.
.\" Local Variables:
.\" fill-column: 72
.\" mode: nroff
.\" End:
.\" vim: set filetype=groff textwidth=72: