.TH MAKEJVF 1
\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
.\" LX definition must follow TX so LX can use TX
.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
.if n .ds LX LaTeX
\"=====================================================================
.SH "نام (NAME)"
makejvf \- ساخت فایل VF ژاپنی از فایل TFM ژاپنی \*(TX
.SH "خلاصه دستور (SYNOPSIS)"
\fBmakejvf\fR [<\fIoptions\fR>] <\fI\*(TX TFM file\fR> <\fIPS font TFM\fR>
.SH "توضیحات (DESCRIPTION)"
دستور \fBmakejvf\fR ابزاری است برای تولید فایل VF ژاپنی از فایل TFM ژاپنیِ \*(TX (یا همان JFM) جهت استفاده در dvips.
.TP 5
هنگام پردازش متون ژاپنی، p\*(TX به JFM (مانند min10.tfm،‏ jis.tfm و غیره) ارجاع می‌دهد که شامل تعاریف عرض‌های مختلف نویسه‌ها و glue/kernهای متری است. برای بیشتر علائم نگارشی و علامت‌های نقل‌قول، عرض نویسه‌ها به کمتر از ۱ zw (عرض zenkaku؛ عرض نویسه‌های معمولی کانجی) کوتاه می‌شود و glue/kernهای متری به عنوان جایگزین درج می‌شوند.
.TP 5
از سوی دیگر، در فونت‌های PS ژاپنی، همهٔ علائم نگارشی و نقل‌قول‌ها دارای عرض نویسه‌ای یکسان با نویسه‌های معمولی کانجی هستند. به همین دلیل، هنگامی که dvips فایل DVI حاصل را پردازش می‌کند، این نویسه‌ها باید به اندازهٔ مقدار glue/kernهای درج‌شده به چپ منتقل (shift) شوند.
.TP 5
برای دستیابی به این هدف، فونت‌های مجازی (VF) و فایل‌های TFM مربوط به PS مورد نیاز هستند؛ هنگامی که VF حاوی دستورهای جابه‌جایی نویسه‌ها باشد، TFM فونت PS می‌تواند عرض دقیق نویسه‌های فونت‌های PS را داشته باشد.
.TP 5
برنامهٔ \fBmakejvf\fR را می‌توان برای همین منظور استفاده کرد. این برنامه یک فایل JFM مربوط به p\*(TX (که در \fBخلاصه دستور (SYNOPSIS)\fR بالا به عنوان <\fI\*(TX TFM file\fR> به آن اشاره شده) را دریافت کرده و یک فایل VF متناظر (با همان نام پایهٔ <\fI\*(TX TFM file\fR>) و یک فایل JFM برای فایل JFM فونت PS (همان <\fIPS font TFM\fR> در بالا) در خروجی تولید می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.PP
.TP 10
\fB-C\fR
حالت فشرده ("Cho-tai").
.TP 10
\fB-K\fR <\fIPS-TFM\fR>
نگاشت نویسه‌های کانا (به طور دقیق‌تر، غیر کانجی) به یک JFM دیگرِ فونت PS با نام <\fIPS-TFM\fR>.
.TP 10
\fB-b\fR <\fIinteger\fR>
میزان جابه‌جایی خط مبنا؛ مقدار \fIinteger\fR یک مقدار نسبی بر مبنای ۱۰۰۰ برای ارتفاع نویسه است.
اگر یک عدد صحیح مثبت تعیین شود، نویسه‌ها پایین آورده می‌شوند.
اگر یک عدد صحیح منفی تعیین شود، نویسه‌ها بالا برده می‌شوند.
.TP 10
\fB-m\fR
جایگزینی علامت‌های نقل‌قول تکی/دوتایی (', '') با علامت‌های نقل‌قول پریم تکی/دوتایی (به‌اصطلاح "minute") در نگارش عمودی.
این جایگزینی با تغییر گلیف‌های پریم و دابل‌پریم (JIS 0x216C و 0x216D؛ یونیکد U+2032 و U+2033) انجام می‌شود، \fIنه\fR با درج گلیف‌های واقعی که برای علامت‌های نقل‌قول طراحی شده‌اند (یونیکد U+301D و U+301E/U+301F).
.TP 10
\fB-a\fR <\fIAFMfile\fR>
نام فایل AFM ورودی که برای حالت Kana-tsume استفاده می‌شود.
این گزینه پشتیبانی نمی‌شود.
.TP 10
\fB-k\fR <\fIinteger\fR>
میزان حاشیهٔ Kana-tsume (فاصله‌های باریک‌تر میان نویسه‌های کانا)؛ مقدار \fIinteger\fR نمایانگر یک مقدار نسبی با استفاده از عرض نویسه بر پایهٔ ۱۰۰۰ است. این گزینه باید همراه با گزینهٔ \fB-a\fR استفاده شود.
این گزینه پشتیبانی نمی‌شود.
.TP 10
\fB-i\fR
شروع شناسهٔ فونت نگاشت‌شده از شمارهٔ ۰ در VF خروجی
(به‌طور پیش‌فرض، makejvf از شمارهٔ ۱ شروع می‌کند).
.TP 10
\fB-e\fR
حالت پیشرفته؛ مقدار جابه‌جایی افقی از جدول glue/kern فایل JFM ورودی تعیین می‌شود.
.TP 10
به‌طور پیش‌فرض، \fBmakejvf\fR از مقداری ثابت در کد برنامه به عنوان مقدار جابه‌جایی افقی استفاده می‌کند که (عمدتاً) برای فونت‌های ژاپنی بهینه‌سازی شده است. \
هنگامی که حالت پیشرفته (گزینهٔ \fB-e\fR) فعال باشد، مقدار جابه‌جایی از فایل ورودی p\*(TX TFM (JFM) تعیین می‌شود که به احتمال زیاد مناسب‌ترین VF را برای آن JFM خروجی خواهد داد.
.TP 10
برای بیشتر JFMهای استاندارد ژاپنی (مانند jis.tfm و مشتقات آن)، VFهای خروجی از هر دو حالت تفاوت چشمگیری نخواهند داشت. \
برای JFMهای چینی ساده‌شده/سنتی (مانند upschrm-h.tfm و uptchrm-h.tfm)، خروجی VF در حالت پیشرفته بهتر خواهد بود. \
برای min10.tfm و مشتقات آن، حالت پیشرفته \fIهرگز\fR نباید فعال شود، زیرا ویژگی‌های نویسه‌ها در min10.tfm غیراستاندارد است.
.TP 10
\fB-t\fR <\fICNFfile\fR>
استفاده از <\fICNFfile\fR> به عنوان فایل پیکربندی.
.TP 10
\fB-O\fR
صرف‌نظر کردن از مدخل‌ها در VF برای نویسه‌های دارای متریک پیش‌فرض. \
استفاده از این گزینه همراه با گزینهٔ \fB-t\fR مجاز نیست.
.TP 10
\fB-u\fR <\fICharset\fR>
حالت UCS. مجموعه‌نویسه‌های در دسترس عبارتند از: gb (GB = چینی ساده‌شده)،
cns (CNS = چینی سنتی)، ks (KS = کره‌ای)،
jis (JIS = ژاپنی)، jisq (فقط علامت نقل‌قول JIS)،
custom (مجموعه‌نویسهٔ تعریف‌شده توسط کاربر از <CNFfile>؛
بخش \fBقالب فایل پیکربندی (CONFIGURATION FILE FORMAT)\fR را ببینید).
.TP 10
گزینه‌های زیر تنها در حالت UCS مؤثر هستند:
.TP 10
\fB-J\fR <\fIPS-TFM\fR>
نگاشت نقل‌قول تکی/دوتایی به یک TFM دیگر از فونت PS با کدگذاری JIS.
.TP 10
\fB-U\fR <\fIPS-TFM\fR>
نگاشت نقل‌قول تکی/دوتایی به یک TFM دیگر از فونت PS با کدگذاری UCS.
.TP 10
\fB-3\fR
استفاده از set3، به این معنی که پشتیبانی از نویسه‌های خارج از BMP فعال شود (در حالت UCS).
به‌طور پیش‌فرض \fBmakejvf\fR نویسه‌های >=U+10000 را جهت کاهش حجم فایل و جلوگیری از بروز مشکلات در درایورهای قدیمی DVI تولید نمی‌کند. نسخه‌های جدید dvipdfmx و سایر ابزارها می‌توانند با VFهای شامل >=U+10000 (معادل set3 در زبان DVI) کار کنند، بنابراین \fB-3\fR ممکن است مفید باشد.
.TP 10
\fB-H\fR
استفاده از کاتاکانای نیمه‌عرض.
.SH "مثال‌ها (EXAMPLES)"
.TP 5
اگر می‌خواهید از min10 به عنوان Ryumin-Light-H استفاده کنید، دستور زیر را اجرا کنید:
     makejvf min10.tfm rml
.TP 5
این دستور فایلهای min10.vf و rml.tfm را تولید می‌کند. این فایل‌ها را در یک دایرکتوری مناسب در زیر درخت TEXMF قرار دهید و خط زیر را به psfonts.map بیفزایید:
     rml Ryumin-Light-H
.SH "قالب فایل پیکربندی (CONFIGURATION FILE FORMAT)"
.TP 5
با گزینهٔ \fB-t\fR، می‌توانید تنظیمات سفارشی را برای تولید VF به \fBmakejvf\fR ارائه دهید. نحو ساختار دستورها بدین صورت است:

     % comment line
     MOVE	<code>	<right>	<down>
     
     REPLACE	<code>	<new code>
     CHARSET	<code>,<code>,<code>..<code>,<code>,
     +	<code>,<code>..<code>

.TP 5
هر سطر باید با یک دستور آغاز شده و با TAB جدا شود. سطری که با % آغاز گردد یک توضیح به حساب می‌آید و سطرهای خالی نادیده گرفته می‌شوند.
.TP 5
دستور \fBMOVE\fR میزان جابه‌جایی افقی/عمودی را برای نویسهٔ تکی <\fIcode\fR> تعیین می‌کند. \
دستور \fBREPLACE\fR نویسهٔ <\fIcode\fR> را با <\fInew code\fR> جایگزین می‌کند. \
دستور \fBCHARSET\fR مجموعه‌نویسهٔ سفارشی VF خروجی را مشخص می‌سازد؛ نویسهٔ + نشان‌دهندهٔ ادامه یافتن از سطر قبلی است.
.TP 5
یک نمونه از کاربرد آن در پروژهٔ uptex-fonts موجود است. مخزن GitHub را بررسی کنید:
     <https://github.com/texjporg/uptex-fonts>
.SH "همچنین ببینید (SEE ALSO)"
توضیحات دقیق‌تر دربارهٔ \fBmakejvf\fR به زبان ژاپنی در مسیر زیر در دسترس است:
     $TEXMFDIST/doc/fonts/ptex-fonts/README_makejvf
.SH "نویسندگان (AUTHORS)"
این صفحهٔ راهنما توسط «جامعهٔ توسعهٔ \*(TX ژاپنی» (Japanese \*(TX Development Community) به نشانی <https://texjp.org> نوشته شده است. برای اطلاعات بیشتر، مخزن GitHub به نشانی <https://github.com/texjporg/ptex-fonts> را ببینید.
.TP 5
با سپاس فراوان از Atsuhito KOHDA <kohda@debian.org> جهت ارائهٔ صفحهٔ راهنمای دیگری در سیستم گنو/لینوکس دبیان.