.TH HITEX 1 "11 November 2021" "Version 1.0"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
.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
.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP
.el .ds OX TeX
.\" BX definition must follow TX so BX can use TX
.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
.if n .ds BX BibTeX
.\" 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
.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX
.if n .ds AX AmSTeX
.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX
.if n .ds AY AmSLaTeX
.if n .ds WB Web
.if t .ds WB W\s-2EB\s0
.\"=====================================================================
.SH "نام (NAME)"
hitex \- تولید خروجی HINT از TeX
.SH "خلاصه دستور (SYNOPSIS)"
.B hitex
.RI [ options ]
.RI [ \fB&\fPformat ]
.RI [ file | \fB\e\fPcommands ]
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
اجرای حروف‌چین Hi\*(TX بر روی
.IR file ،
که معمولاً فایل
.IR file.hnt
را ایجاد می‌کند.
اگر آرگومان فایل هیچ پسوندی نداشته باشد، «‎.tex» به آن افزوده خواهد شد.
به‌جای نام فایل، می‌توان مجموعه‌ای از دستورهای Hi\*(TX را وارد کرد که نخستینِ آن‌ها باید با یک بک‌اسلش آغاز شود.
با یک آرگومان
.BI & format
برنامه Hi\*(TX از مجموعه متفاوتی از دستورهای از پیش کامپایل‌شده استفاده می‌کند که در
.IR format\fB.fmt\fP
قرار دارند؛
معمولاً بهتر است به‌جای آن از گزینه
.B -fmt
.I format
استفاده شود.
.PP
برنامه Hi\*(TX نسخه‌ای از \*(TX است که فایل‌های HINT را تولید می‌کند. قالب فایل HINT برای خواندن اسناد روی صفحه نمایش طراحی شده است. با استفاده از یک نمایشگر HINT (ببینید:
.BR https://hint.userweb.mwn.de )
برای نمایش یک فایل HINT، محتوای آن به‌طور پویا با فضای نمایش موجود تطبیق می‌یابد.
.PP
کاربرد معمول Hi\*(TX با قالب‌های از پیش تولید شده است.
دستور
.B hitex
از معادل قالب ساده \*(TX استفاده می‌کند، و دستور
.B hilatex
از معادل قالب \*(LX استفاده می‌نماید.
برای تولید قالب‌ها، از سوییچ
.B -ini
استفاده کنید.
.PP
مدیریت آرگومان‌های خط فرمان توسط Hi\*(TX مشابه سایر برنامه‌های \*(TX در پیاده‌سازی
.I web2c
است.
.PP
برنامه Hi\*(TX در صورت استفاده به همراه سوییچ
.B -etex
افزونه‌های e-\*(TX را در خود ادغام می‌کند (ببینید:
.BR etex (1)).
.PP
برنامه Hi\*(TX در صورت استفاده به همراه سوییچ
.B -ltx
افزونه‌های مورد نیاز برای \*(LX را در خود ادغام می‌کند (ببینید:
.BR latex (1)).
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
این نسخه از Hi\*(TX گزینه‌های خط فرمان زیر را می‌پذیرد.
.TP
.BI -cnf-line \ string
تجزیه
.I string
به‌عنوان یک خط پیکربندی
.IR texmf.cnf .
راهنمای Kpathsea را ببینید.
.TP
.B -compress
فعال‌سازی فشرده‌سازی برای فایل HINT. فایل‌های فشرده‌شده کوچک‌تر هستند اما هنگام مشاهده به بازگشایی نیاز دارند. تنها برای فایل‌های حجیم و در صورتی که اندازه فایل اهمیت دارد استفاده شود.
.TP
.B -empty-page
هنگام نگارش کتاب‌ها، اغلب صفحات خالی درج می‌شوند - برای نمونه جهت شروع فصل‌ها در یک صفحه سمت راست. این صفحات خالی برای خواندن روی صفحه نمایش، که در آن صفحات چپ یا راست وجود ندارند، ناخوشایند هستند. این گزینه صفحات خالی را در خروجی نگه می‌دارد.
.TP
.B -no-empty-page
این گزینه تلاش می‌کند تا صفحات خالی را در خروجی حذف کند. این گزینه به‌صورت پیش‌فرض تنظیم شده است.
.TP
.B -etex
فعال‌سازی افزونه‌های e-\*(TX. این گزینه تنها در ترکیب با
.B -ini
مؤثر است. ببینید:
.BR etex (1).
.TP
.B -file-line-error
چاپ پیام‌های خطا به‌شکل
.I file:line:error
که مشابه نحوه قالب‌بندی آن‌ها در بسیاری از کامپایلرها است.
.TP
.B -no-file-line-error
غیرفعال‌سازی چاپ پیام‌های خطا در قالب
.IR file:line:error .
.TP
.BI -fmt \ format
استفاده از
.I format
به‌عنوان نام قالب مورد استفاده، به‌جای نامی که Hi\*(TX با آن فراخوانی شده یا خط
.IR %& .
.TP
.B -help
نمایش پیام راهنما و خروج.
.TP
.BI -hint-debug \ bitmask
تنظیم فلگ‌های اشکال‌زدایی فایل HINT بر اساس
.IR bitmask .
برای جزئیات به گزینه
.B -hint-debug-help
مراجعه کنید.
.TP
.B -hint-debug-help
چاپ توضیحات مربوط به فلگ‌های اشکال‌زدایی HINT و خروج.
.TP
.B -hyphenate-first-word
\*(TX معمولاً تلاشی برای درج نقاط پیوندواژه در کلمه نخست یک پاراگراف انجام نمی‌دهد. اگر یک فایل HINT باید روی دستگاهی بسیار کوچک نمایش داده شود، ممکن است چنین نقاط پیوندواژه‌ای ضروری باشند. این گزینه به‌طور پیش‌فرض فعال است و ایجاد این نقاط پیوندواژه را امکان‌پذیر می‌سازد.
.TP
.B -no-hyphenate-first-word
غیرفعال‌سازی درج خودکار نقاط پیوندواژه در کلمه نخست یک پاراگراف. تنها در صورتی نیاز است که سازگاری کامل با \*(TX الزامی باشد.
.TP
.B -ini
شروع در حالت
.IR INI ،
که برای استخراج قالب‌ها استفاده می‌شود. حالت
.I INI
می‌تواند برای حروف‌چینی به کار رود، اما هیچ قالبی از پیش بارگذاری نمی‌شود و ممکن است مقداردهی‌های اولیه اساسی مانند تنظیم catcodeها لازم باشد.
.TP
.BI -interaction \ mode
تنظیم حالت تعامل. این حالت می‌تواند یکی از مقادیر
.IR batchmode ،
.IR nonstopmode ،
.IR scrollmode
و
.I errorstopmode
باشد. معنای این حالت‌ها مشابه دستورهای متناظر با بک‌اسلش (\e) است.
.TP
.BI -jobname \ name
استفاده از
.I name
برای نام کار (job name)، به‌جای استخراج آن از روی نام فایل ورودی.
.TP
.BI -kpathsea-debug \ bitmask
تنظیم فلگ‌های اشکال‌زدایی جستجوی مسیر بر اساس bitmask. برای جزئیات به راهنمای
.I Kpathsea
مراجعه کنید.
.TP
.B -ltx
فعال‌سازی افزونه‌های \*(LX. این گزینه تنها در ترکیب با
.B -ini
مؤثر است. ببینید:
.BR latex (1).
.TP
.BI -mfmode \ mode
استفاده از
.I mode
به‌عنوان حالت \*(MF
.RI ( mode )
هنگام تولید فونت‌های ناموجود. برای جزئیات به
.BR mf (1)
مراجعه کنید.
.TP
.BI -mktex \ fmt
فعال‌سازی
.RI mktex fmt ،
که در آن
.I fmt
باید یکی از مقادیر
.IR tex ،
.IR tfm ،
.IR fmt
یا
.I pk
باشد.
.TP
.BI -no-mktex \ fmt
غیرفعال‌سازی
.RI mktex fmt ،
که در آن
.I fmt
باید یکی از مقادیر
.IR tex ،
.IR tfm ،
.IR fmt
یا
.I pk
باشد.
.TP
.BI -output-directory \ directory
نوشتن فایل‌های خروجی در
.I directory
به‌جای دایرکتوری جاری. فایل‌های ورودی نیز ابتدا در
.I directory
و سپس در طول مسیر جستجوی عادی جستجو می‌شوند.
.TP
.B -parse-first-line
اگر خط اول فایل ورودی اصلی با
.I %&
آغاز شود، آن را برای یافتن نام dump تجزیه می‌کند.
.TP
.B -no-parse-first-line
غیرفعال‌سازی تجزیه خط اول فایل ورودی اصلی.
.TP
.BI -progname \ name
وانمود کردن به اجرای برنامه
.IR name .
این امر هم بر قالب مورد استفاده و هم بر مسیرهای جستجو تأثیر می‌گذارد.
.TP
.BI -resolution \ number
هنگام استفاده از \*(MF برای تولید فونت‌های ناموجود pk، استفاده از تفکیک‌پذیریِ
.I number
نقطه بر اینچ (DPI). برای جزئیات به
.BR mf (1)
مراجعه کنید.
.TP
.B -version
نمایش اطلاعات نگارش و خروج.
.\"=====================================================================
.SH "محیط (ENVIRONMENT)"
برای جزئیات دقیق در مورد نحوه استفاده از متغیرهای محیطی، مستندات کتابخانه Kpathsea (مانند گره «Path specifications») را ببینید.
ابزار
.B kpsewhich
می‌تواند برای پرس‌وجوی مقادیر این متغیرها به کار رود.
.PP
یک نکته مهم: در بیشتر قالب‌های Hi\*(TX، نمی‌توانید از ~ در نام فایلی که مستقیماً به Hi\*(TX می‌دهید استفاده کنید، زیرا ~ یک نویسه فعال در \*(TX است و بنابراین بسط داده می‌شود، نه اینکه به‌عنوان بخشی از نام فایل در نظر گرفته شود. سایر برنامه‌ها، مانند \*(MF، این مشکل را ندارند.
.PP
.TP
.B TEXMFOUTPUT
به‌طور معمول، Hi\*(TX فایل‌های خروجی خود را در دایرکتوری جاری قرار می‌دهد. اگر هر فایل خروجی نتواند در آنجا باز شود، تلاش می‌کند آن را در دایرکتوری مشخص‌شده در متغیر محیطی TEXMFOUTPUT باز کند.
هیچ مقدار پیش‌فرضی برای این متغیر وجود ندارد. برای مثال، اگر دستور
.I hitex paper
را وارد کنید و دایرکتوری جاری قابل نوشتن نباشد و TEXMFOUTPUT مقدار
.I /tmp
را داشته باشد، Hi\*(TX تلاش می‌کند فایل
.I /tmp/paper.log
(و
.IR /tmp/paper.hnt ،
در صورتی که هرگونه خروجی تولید شود) را ایجاد کند. همچنین TEXMFOUTPUT برای فایل‌های ورودی نیز بررسی می‌شود، زیرا \*(TX غالباً فایل‌هایی را تولید می‌کند که باید متعاقباً خوانده شوند؛ برای ورودی، هیچ پسوندی (مانند «‎.tex») به‌طور پیش‌فرض افزوده نمی‌شود و نام ورودی دقیقاً همان‌گونه که داده شده بررسی می‌شود.
.TP
.B TEXINPUTS
مسیر جستجو برای فایل‌های
.I \einput
و
.IR \eopenin .
این مسیر معمولاً با «.» آغاز می‌شود تا فایل‌های کاربری پیش از فایل‌های سیستمی پیدا شوند. بخش‌های خالی در مسیر با مسیرهای تعریف‌شده در فایل
.I texmf.cnf
جایگزین خواهند شد. برای مثال، مقدار TEXINPUTS را روی «.:/home/user/tex:» تنظیم کنید تا دایرکتوری جاری و «/home/user/tex» به ابتدای مسیر جستجوی استاندارد اضافه شوند.
.TP
.B TEXFORMATS
مسیر جستجو برای فایل‌های قالب.
.TP
.B TFMFONTS
مسیر جستجو برای فایل‌های متریک فونت
.RI ( .tfm ).
.TP
.B SOURCE_DATE_EPOCH
در صورت تنظیم، مقدار آن (بر حسب ثانیه‌های epoch) برای تاریخ ایجاد و به‌عنوان مبدأ زمانی برای دستورهای اولیه مرتبط با زمان در \*(LX استفاده خواهد شد. این ویژگی برای ایجاد ساخت‌های بازتولیدپذیر (reproducible builds) مفید است.
.TP
.B FORCE_SOURCE_DATE
اگر مقدار آن برابر با "1" تنظیم شود، دستورهای اولیه مرتبط با زمان در \*(TX
.RI ( \eyear ،
.IR \emonth ،
.IR \eday ،
.IR \etime )
نیز از مقدار SOURCE_DATE_EPOCH مقداردهی اولیه می‌شوند. اگر جایگزین امکان‌پذیر دیگری وجود دارد، این روش توصیه نمی‌شود.
.PP
متغیرهای محیطی بسیار دیگری نیز ممکن است در رابطه با جستجوی مسیر مورد استفاده قرار گیرند. راهنمای Kpathsea را ببینید.
.\"=====================================================================
.SH "فایل‌ها (FILES)"
محل فایل‌های ذکرشده در زیر از سیستمی به سیستم دیگر متفاوت است. برای یافتن محل آن‌ها از ابزار
.B kpsewhich
استفاده کنید.
.TP
.I *.tfm
فایل‌های متریک برای فونت‌های Hi\*(TX.
.TP
.I *.fmt
فایل‌های قالب از پیش پردازش‌شده Hi\*(TX.
.TP
.I *.pk *.pfb
فایل‌های فونت مورد استفاده توسط Hi\*(TX.
.\"=====================================================================
.SH "نکات (NOTES)"
این صفحه راهنما جامع و کامل نیست. مستندات کامل Hi\*(TX را می‌توان در
.I "Hi\*(TX user manual"
یافت. اطلاعات بیشتر را می‌توان در راهنمای
.I "Kpathsea library"
و در
.I "HINT: The file format"
یافت که به‌صورت کتاب یا در قالب الکترونیکی از صفحه اصلی پروژه HINT در
.BR https://hint.userweb.mwn.de
در دسترس است.
.\"=====================================================================
.SH "اشکالات (BUGS)"
این نسخه از Hi\*(TX چسب‌ها (glues) و فاصله‌ها (kerns) را با عرضی که به \ehsize یا \evsize وابسته است به‌درستی مدیریت نمی‌کند. به‌طور مشابه، زمانی که چیدمان مدخل‌های جدول یا فرمول‌های ریاضی به \ehsize یا \evsize وابسته باشد، خروجی آن‌ها ممکن است دچار اعوجاج شود.
.\"=====================================================================
.SH "در دسترس بودن (AVAILABILITY)"
برنامه Hi\*(TX باید روی طیف گسترده‌ای از معماری‌های سخت‌افزاری و سیستم‌های عامل کامپایل شود.
برنامه Hi\*(TX بخشی از توزیع \*(TX Live است.
.PP
صفحه اصلی Hi\*(TX در
.BR https://hint.userweb.mwn.de
قرار دارد. در آنجا نرم‌افزارهای اضافی، به‌ویژه نمایشگرهای فایل‌های HINT، و اطلاعات بیشتر را خواهید یافت.
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR histretch (1),
.BR hishrink (1),
.BR latex (1),
.BR tex (1),
.BR kpsewhich (1)
.\"=====================================================================
.SH "نویسندگان (AUTHORS)"
نویسنده اصلی Hi\*(TX مارتین روکرت (Martin Ruckert) است،
با افزونه‌های e-\*(TX توسط پیتر برایتن‌لونر (Peter Breitenlohner)،
افزونه‌های \*(LX توسط تیری لاروند (Thierry Laronde)، و
کتابخانه kpathsearch توسط کارل بری (Karl Berry).
.PP
سامانه \*(TX توسط دونالد ای. کنوت (Donald E. Knuth) طراحی شد،
که آن را با استفاده از سامانه \*(WB خود برای برنامه‌های پاسکال پیاده‌سازی کرد.
.PP
بسیاری افراد دیگر در توسعه سامانه حروف‌چینی که امروزه با نام \*(TX شناخته می‌شود مشارکت داشته‌اند؛
بسیار فراتر از آنکه نام همه آن‌ها در اینجا ذکر شود.
.\" vim: syntax=nroff