.TH xtotroff 1 "2026-03-15" "groff 1.24.1"
.SH "نام (NAME)"
xtotroff \- تبدیل فونتهای X11 و BDF به فرمت فونت groff
.
.
.\" ====================================================================
.\" Legal Terms
.\" ====================================================================
.\"
.\" Copyright      2004 Free Software Foundation, Inc.
.\"           2021-2024 G. Branden Robinson
.\"
.\" 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_xtotroff_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 xtotroff
.RB [ \-d\~\c
.IR destination-directory ]
.RB [ \-r\~\c
.IR resolution ]
.RB [ \-s\~\c
.IR type-size ]
.I font-map
.YS
.
.
.P
.SY xtotroff
.B \-\-help
.YS
.
.
.P
.SY xtotroff
.B \-v
.YS
.
.SY xtotroff
.B \%\-\-version
.YS
.
.
.\" ====================================================================
.SH "توضیحات (DESCRIPTION)"
.\" ====================================================================
.
دستور
.I xtotroff
از
.I font-map
برای ایجاد فایل‌های توصیف قلم
.MR groff 1
از قلم‌های X11 استفاده می‌کند.
.
هر خط در
.I font-map
یک نام قلم
.I groff
را با یک نام قلم X به عنوان یک الگوی توصیف منطقی قلم X
(XLFD)
جفت می‌کند.
.
اجزای هر جفت با فاصله یا نویسه‌های Tab از یکدیگر جدا می‌شوند.
.
به عنوان مثال، یک فایل ورودی
.I font-map
متشکل از خط
.
.RS
.EX
TB \-adobe\-times\-bold\-r\-normal\-\-*\-*\-*\-*\-p\-*\-iso8859\-1
.EE
.RE
.
الگوی XLFD سمت راست را به نام قلم
.I groff
.BR TB ،
که به طور سنتی \[lq]Times bold\[rq] است،
نگاشت می‌کند.
.
.
.PP
دستور
.I xtotroff
یک اتصال به کارساز X در حال اجرا باز می‌کند تا کاتالوگ قلم آن را بررسی کند،
و اگر نتواند متوقف می‌شود.
.
در صورت لزوم، نویسه‌های عام (wildcard) در الگوهای XLFD با آرگومان‌های گزینه‌های
.B \-r
و
.B \-s
پر می‌شوند.
.
اگر نام یک قلم همچنان مبهم باشد،
.I xtotroff
متوقف می‌شود.
.
به ازای هر نگاشت موفق،
.I xtotroff
یک فایل توصیف قلم
.I groff
در دایرکتوری کاری فعلی
(یا دایرکتوری مشخص‌شده توسط گزینه
.BR \-d )
به نام هر قلم
.I groff
ایجاد می‌کند و نگاشت را به جریان خروجی استاندارد گزارش می‌دهد.
.
.
.\" ====================================================================
.SH "گزینه‌ها (OPTIONS)"
.\" ====================================================================
.
گزینه
.B \-\-help
پیام راهنمای استفاده را نمایش می‌دهد، در حالی که
.B \-v
و
.B \%\-\-version
اطلاعات نگارش را نمایش می‌دهند؛
پس از آن همگی خارج می‌شوند.
.
.
.TP
.BI \-d\~ destination-directory
نوشتن توصیف‌های قلم در
.I destination-directory
به جای دایرکتوری کاری فعلی.
.
.
.TP
.BI \-r\~ resolution
تنظیم تفکیک‌پذیری (resolution) برای تمامی الگوهای قلم در
.IR font-map .
.
این مقدار برای هر دو اندازه حرکت افقی و عمودی (motion quanta) استفاده می‌شود.
.
در صورت عدم تعیین، تفکیک‌پذیری 75dpi فرض می‌شود.
.
.
.TP
.BI \-s\~ type-size
تنظیم اندازه قلم بر حسب پوینت برای تمامی الگوهای قلم در
.IR font-map .
.
در صورت عدم تعیین، اندازه ۱۰ پوینت فرض می‌شود.
.
.
.\" ====================================================================
.SH "وضعیت خروج (EXIT STATUS)"
.\" ====================================================================
.
دستور
.I \%xtotroff
در صورت اجرای موفقیت‌آمیز با
.RB وضعیت\~ 0 ،
اگر برنامه نتواند آرگومان‌های خط فرمان خود را تفسیر کند با
.RB وضعیت\~ 2 ،
و در صورت مواجهه با خطا در حین اجرا با
.RB وضعیت\~ 1
خارج می‌شود.
.
.
.\" ====================================================================
.SH "فایل‌ها (FILES)"
.\" ====================================================================
.
.TP
.I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%FontMap\-X11
فایل نگاشت قلم مورد استفاده برای تولید فایل‌های توصیف قلم از‌پیش‌تولیدشده است که همراه با
.I groff
ارائه می‌شوند، مربوط به قلم‌های اصلی X11 متناظر با ۱۳ قلم پایه Type\~1 برای PostScript سطح ۱.
.
.
.\" ====================================================================
.SH "اشکالات (BUGS)"
.\" ====================================================================
.
تنها کدگذاری‌های قلم پشتیبانی‌شده
\[lq]iso8859\-1\[rq]
و
\%\[lq]adobe\-\:fontspecific\[rq]
هستند.
.
.
.\" ====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.\" ====================================================================
.
.UR https://\:www\:.x\:.org/\:releases/\:X11R7.6/\:doc/\:xorg\-docs/\:specs/\:XLFD/xlfd\:.html
\[lq]X Logical Font Description Conventions\[rq]
.UE ,
اثر Jim Flowers و Stephen Gildea.
.
.
.PP
.MR X 7 ,
.MR groff 1 ,
.MR gxditview 1 ,
.MR \%troff 1 ,
.MR groff_font 5
.
.
.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[*groff_xtotroff_1_man_C]
.do rr *groff_xtotroff_1_man_C
.
.
.\" Local Variables:
.\" fill-column: 72
.\" mode: nroff
.\" End:
.\" vim: set filetype=groff textwidth=72: