\." Copyright (c) 2000-2007 by George Williams (gww@silcom.com).
\." Original manual page by Tom Harvey, subsequently modified by
\." George Williams. Heavily rewritten and modified to use standard
\." -man (5) macros by R.P.C. Rodgers (rodgers@nlm.nih.gov), 23 October 2002. 
\." Paul Hardy reconstructed the original man page and added output from
\." the latest FontForge release.
.TH FONTFORGE 1 "2017 Jun 18"
.SH "نام (NAME)"
fontforge \- ایجاد، ویرایش و مشاهده فایل‌های قلم
.SH "خلاصه دستور (SYNOPSIS)"
.BR fontforge
[\fB\-allglyphs\fP]
[\fB\-c\fP\ \fIstring\fP]
[\fB\-cmap\fP\ \fImaptype\fP]
[\fB\-depth\fP\ \fIpixeld\fP]
[\fB\-display\fP\ \fIstr\fP]
[\fB\-lang\fP=ff]
[\fB\-lang\fP=py]
[\fB\-help\fP]
[\fB\-keyboard\fP\ \fIktype\fP]
[\fB\-last\fP]
[\fB\-new\fP]
[\fB\-nosplash\fP]
[\fB\-quiet\fP]
[\fB\-recover\fP\ \fImode\fP]
[\fB\-script\fP\ \fIfile\fP]
[\fB\-skippyfile\fP]
[\fB\-skippyplug\fP]
[\fB\-sync\fP]
[\fB\-unique\fP]
[\fB\-usage\fP]
[\fB\-vc\fP\ \fIclass\fP]
[\fB\-version\fP]
[\fIfontfile\fP\ ...]
.SH "توضیحات (DESCRIPTION)"
برنامه
.B FontForge
قلم‌های PostScript (شامل pfa، pfb، ps و cid)، OpenType (شامل otf)،
TrueType (شامل ttf و ttc)، قلم‌های منابع Macintosh (شامل dfont، bin و hqx)،
Scaled Vector Graphics (شامل svg)، بیت‌مپ TeX (شامل pk)،
قالب Glyph Bitmap Distribution Format (شامل bdf)،
و قلم‌های بیت‌مپ X11 (شامل pcf) را می‌خواند. فایل‌های قلم
ممکن است با gzip فشرده شده باشند (برای نمونه، myfont.pcf.gz).
همچنین
.B FontForge
قالب اختصاصی خود، یعنی فایل‌های پایگاه‌داده قلم اسپیلاین (sfd) را نیز می‌خواند.
.PP
اگر در فهرست آرگومان‌ها یک یا چند نام فایل قلم مشخص شده باشد،
\fBfontforge\fP
برای هر قلم یک پنجرهٔ
\fBfontview\fP
باز می‌کند که نویسه‌های آن قلم را نمایش می‌دهد.
در صورت عدم ارائهٔ گزینه‌ها یا آرگومان‌ها، برنامه
یک پنجرهٔ انتخاب فایل باز می‌کند که به شما اجازه می‌دهد
دیسک خود را برای یافتن فایل قلم یا ایجاد یک قلم جدید مرور کنید.
.PP
این صفحه راهنما صرفاً به عنوان یک بررسی اجمالی و مقدماتی در نظر گرفته شده است؛
برای کسب اطلاعات جامع‌تر به راهنمای کاربری HTML مراجعه کنید.
.PP
اگر هیچ \fIfontfile\fP مشخص نشده باشد و گزینهٔ \fB\-new\fP نیز داده نشده باشد، و
چیزی برای بازیابی وجود نداشته باشد، آن‌گاه \fBFontForge\fP
یک کادر گفتگوی باز کردن قلم ارائه می‌دهد.
.PP
اگر یک \fIscriptfile\fP مشخص شده باشد، \fBFontForge\fP نمایشگر
X را باز نخواهد کرد و هیچ آرگومان اضافی را پردازش نمی‌کند. این برنامه
\fIscriptfile\fP را اجرا کرده و آرگومان‌های باقی‌مانده را به آن ارسال می‌نماید.
.PP
اگر اولین آرگومان یک نام فایل اجرایی باشد و اولین سطر
آن فایل شامل عبارت «fontforge» باشد، آن‌گاه به عنوان یک \fIscriptfile\fP در نظر گرفته می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP 12
.B \-new
یک قلم جدید ایجاد می‌کند.
.TP
.B \-last
آخرین فایل sfd بسته‌شده را بارگذاری می‌کند.
.TP
.B \-recover none\fR|\fPauto\fR|\fPinquire\fR|\fPclean
کنترل بازیابی از خطا.
مقدار \fBnone\fP از بازیابی پس از خرابی برنامه جلوگیری می‌کند.
مقدار \fBauto\fP در صورتی که برنامه پیش از ذخیره تغییرات دچار خرابی شده باشد،
بازیابی را به صورت خودکار انجام می‌دهد؛ این حالت پیش‌فرض است.
مقدار \fBinquire\fP درباره نحوه برخورد با فایل‌های بازیابی پس از خرابی که به صورت خودکار ذخیره شده‌اند، سؤال می‌پرسد.
مقدار \fBclean\fP اطلاعات بازیابی را حذف می‌کند.
.TP
.B \-allglyphs
تمام گلیف‌های موجود در جدول 'glyf' یک مجموعه TrueType را بارگذاری می‌کند.
.TP
.B \-nosplash
از نمایش صفحهٔ شروع (splash screen) جلوگیری می‌کند.
.TP
.B \-quiet
اطلاعات غیرضروری را در خطای استاندارد (stderr) چاپ نمی‌کند.
.TP
.B \-unique
اگر یک نسخه از fontforge در حال حاضر در حال اجرا باشد، تمام آرگومان‌ها را
در آن باز کرده و این فرایند خاتمه می‌یابد.
.TP
.B \-display \fIdisplay-name\fP
از نمایشگر X مشخص‌شده با رشتهٔ
\fIdisplay-name\fP (برای نمونه: localhost:0) استفاده می‌کند.
.TP
.B \-depth \fIpixeld\fP
تلاش می‌کند از ویژگی‌های بصری (visual) منطبق با عمق پیکسل مشخص‌شده،
\fIpixeld\fP، استفاده کند.
.TP
.B \-vc \fIval\fP
در صورت امکان، ردهٔ بصری (visual class) را تنظیم می‌کند.
.TP
.B \-cmap current\fR|\fPcopy\fR|\fPprivate
نوع جدول رنگ (color map) را تعیین می‌کند.
مقدار \fBcurrent\fP تلاش می‌کند رنگ‌ها را در جدول رنگ جاری (اشتراکی) تخصیص دهد.
احتمالاً برنامه تمام موارد مورد نیاز خود را نخواهد یافت.
مقدار \fBcopy\fP آنچه را که امکان‌پذیر است تخصیص داده،
سپس جدول رنگ جاری را رونوشت می‌کند؛ بنابراین می‌تواند
از خانه‌هایی که سایر برنامه‌ها استفاده می‌کنند بهره گیرد.
مقدار \fBprivate\fP یک جدول رنگ جدید ایجاد کرده و آن را با رنگ‌های مورد نیاز پر می‌کند.
.TP
.B \-dontopenxdevices
در صورتی که باز کردن دستگاه‌ها با شکست مواجه شود.
.TP
.B \-sync
نمایشگر را جهت اشکال‌زدایی همگام‌سازی می‌کند.
.TP
.B \-keyboard ibm\fR|\fPmac\fR|\fPsun\fR|\fPppc
کلیدهای میان‌بر مناسب را در منوها تولید می‌کند.
در رایانه‌های سازگار با IBM از \fBibm\fP استفاده کنید.
در رایانه‌های Mac با سیستم‌عامل Mac\ OS از \fBmac\fP استفاده کنید.
در ایستگاه‌های کاری Sun از \fBsun\fP استفاده کنید.
در رایانه‌های Power PC Mac با سیستم‌عامل SUSE GNU/Linux از \fBppc\fP استفاده کنید.
.TP
.B \-help
پیام راهنما را نمایش داده و خارج می‌شود.
.TP
.B \-docs
خروجی فایل راهنما را نمایش می‌دهد و سپس یک مرورگر را
با استفاده از متغیر محیطی \fBBROWSER\fP فراخوانی می‌کند.
.TP
.B \-version
نسخه fontforge را چاپ کرده و خارج می‌شود.
.TP
\fB\-lang\fP=py
استفاده از Python برای اسکریپت‌ها (می‌تواند پیش از \fB\-script\fP بیاید).
.TP
\fB\-lang\fP=ff
استفاده از زبان اسکریپت‌نویسی قدیمی fontforge.
.TP
.B \-script \fIscriptfile\fP
فایل \fIscriptfile\fP را اجرا می‌کند. باید نخستین گزینه باشد (یا پس از \fB\-lang\fP قرار گیرد).
تمام آرگومان‌های دیگر به \fIscriptfile\fP فرستاده می‌شوند.
اسکریپت به نام \fIfile\fP را اجرا می‌کند.
نمایشگر X را باز نمی‌کند.
این باید اولین آرگومان داده‌شده به \fBFontForge\fP باشد.
هر آرگومان دیگری توسط خود فایل اسکریپت رسیدگی می‌شود.
تمام آرگومان‌های دیگر خط فرمان به اسکریپت ارسال خواهند شد.
این برنامه حاوی یک مفسر فرمان است
که امکان دسترسی به بیشتر ویژگی‌های تعاملی برنامه
(و نه همهٔ آن‌ها) را فراهم می‌کند.
اگر یک فایل اسکریپت اجرایی باشد، و اگر خط اول آن
حاوی رشته "fontforge" باشد، آن‌گاه
می‌توان از آرگومان \fB\-script\fP صرف‌نظر کرد.
این بدان معناست که می‌توان از \fBFontForge\fP
به عنوان یک مفسر استفاده کرد.
.TP
.B \-dry \fIscriptfile\fP
بررسی نحو (syntax check) فایل \fIscriptfile\fP را به صورت آزمایشی انجام می‌دهد. باید نخستین گزینه باشد.
تمام آرگومان‌های دیگر به \fIscriptfile\fP فرستاده می‌شوند. این گزینه
تنها برای زبان اسکریپت‌نویسی اختصاصی fontforge قابل استفاده است، نه Python.
.TP
.B \-c \fIscript-string\fP
آرگومان را به عنوان دستورات اسکریپتی اجرا می‌کند. باید نخستین گزینه باشد.
تمام آرگومان‌های دیگر به اسکریپت فرستاده می‌شوند.
.TP
.B \-skippyfile
هنگام راه‌اندازی اولیه، اسکریپت‌های آغازین Python (init) را اجرا نمی‌کند.
.TP
.B \-skippyplug
هنگام راه‌اندازی اولیه، پلاگین‌های فعال‌شدهٔ Python را بارگذاری نمی‌کند.
.SH "مثال‌ها (EXAMPLES)"
نمونه استفاده:
.PP
.RS
fontforge myfont.ttf &
.RE
.SH "محیط (ENVIRONMENT)"
.TP
.B BROWSER
نام برنامه مرورگر را برای
بررسی مستندات آنلاین مشخص می‌کند.
.TP
.B AUTOTRACE
محل قرارگیری برنامه autotrace را مشخص می‌کند.
معمولاً FontForge می‌تواند این مورد را بدون نیاز به کمک
شناسایی کند، اما نه همیشه.
.TP
.B MF
محل قرارگیری برنامه \fBmetafont\fP را مشخص می‌کند.
.TP
.B FONTFORGE_VERBOSE
حالت پرگو (verbose) را در اسکریپت‌نویسی فعال می‌کند. هر عبارت
به محض اجرا چاپ می‌شود.
.SH "فایل‌ها (FILES)"
.TP
~/.FontForge/autosave
دایرکتوری بازیابی پس از خرابی.
.TP
/usr/share/fontforge/*.ui
ترجمه‌های مربوط به واسط‌های کاربری.
.TP
/usr/share/fontforge/doc/*.html
محل اختیاری برای مستندات آنلاین.
.TP
/usr/share/fontforge/*.cidmap
فایل‌های «کدگذاری» برای قالب‌های cid متعلق به Adobe، برگرفته از
http://fontforge.sourceforge.net/cidmaps.tgz
.SH "همچنین ببینید (SEE ALSO)"
\fBsfddiff\fP(1)
.PP
نسخه HTML راهنمای \fBFontForge\fP به صورت آنلاین در نشانی زیر در دسترس است:
http://fontforge.sourceforge.net
.SH "نکته (NOTE)"
برنامه \fBFontForge\fP پیش‌تر \fBPfaEdit\fP نامیده می‌شد.
.SH "نویسندگان (AUTHORS)"
حق نشر برنامه
.B FontForge
\(co 2000\(en2014 متعلق به George Williams است و در حال حاضر توسط
تیم توسعه FontForge نگهداری می‌شود. برای مشاهده فهرست جامع
مشارکت‌کنندگان به /usr/share/doc/fontforge/AUTHORS مراجعه کنید.
.SH "مجوز (LICENSE)"
برنامه FontForge تحت مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر
(http://gnu.org/licenses/gpl.html) منتشر شده است و بسیاری از بخش‌های آن تحت مجوز BSD
(http://fontforge.org/license.html) پوشش داده شده‌اند. لطفاً فایل LICENSE موجود
در بسته توزیعی FontForge را برای کسب جزئیات بخوانید، یا به
https://github.com/fontforge/fontforge/blob/master/LICENSE مراجعه فرمایید.
.PP
برنامه FontForge در کلیت خود تحت شرایط GNU GPL (http://www.gnu.org/copyleft/gpl.html) نسخهٔ
۳ یا هر نسخهٔ پس از آن در دسترس است.
با این حال، تقریباً تمام بخش‌های آن تحت «مجوز تجدیدنظرشده BSD» (http://www.law.yi.org/~sfllaw/talks/bsd.pdf) در دسترس هستند، چرا که بخش اعظم FontForge توسط George Williams و تحت آن مجوز نگاشته شده است.
.PP
مجوز تجدیدنظرشده BSD بسیار سهل‌گیرانه است و اجازه می‌دهد کد با کدهای تحت مجوزهای دیگر ترکیب شود.
.PP
کتابخانه‌های کاربردی فراوانی تحت مجوزهای آزاد با کپی‌لفت وجود دارند، نظیر LGPL و GPL، که FontForge از سال ۲۰۱۲ استفاده از آن‌ها را آغاز کرد.
.PP
برای نمونه، Pango و Cairo تحت مجوز LGPL در دسترس هستند.
.PP
برخی از قابلیت‌های افزوده شده از سال ۲۰۱۲ توسط توسعه‌دهندگان مستقل آن‌ها تحت GPLv3 مجوزدهی شده‌اند.
.SH "گزارش باگ‌ها (BUGS)"
به بخش پیگیری اشکالات FontForge در گیت‌هاب مراجعه فرمایید:
https://github.com/fontforge/fontforge/issues