HITEX(1)                    General Commands Manual                   HITEX(1)

نام (NAME)
       hitex - تولید خروجی HINT از TeX

خلاصه دستور (SYNOPSIS)
       hitex [options] [&format] [file|\commands]

توضیحات (DESCRIPTION)
       اجرای حروف‌چین HiTeX بر روی file، که معمولاً فایل file.hnt را ایجاد
       می‌کند.  اگر آرگومان فایل هیچ پسوندی نداشته باشد، «‎.tex» به آن افزوده
       خواهد شد.  به‌جای نام فایل، می‌توان مجموعه‌ای از دستورهای HiTeX را وارد
       کرد که نخستینِ آن‌ها باید با یک بک‌اسلش آغاز شود.  با یک آرگومان &format
       برنامه HiTeX از مجموعه متفاوتی از دستورهای از پیش کامپایل‌شده استفاده
       می‌کند که در format.fmt قرار دارند؛ معمولاً بهتر است به‌جای آن از گزینه
       -fmt format استفاده شود.

       برنامه HiTeX نسخه‌ای از TeX است که فایل‌های HINT را تولید می‌کند. قالب
       فایل HINT برای خواندن اسناد روی صفحه نمایش طراحی شده است. با استفاده از
       یک نمایشگر HINT (ببینید: https://hint.userweb.mwn.de) برای نمایش یک
       فایل HINT، محتوای آن به‌طور پویا با فضای نمایش موجود تطبیق می‌یابد.

       کاربرد معمول HiTeX با قالب‌های از پیش تولید شده است.  دستور hitex از
       معادل قالب ساده TeX استفاده می‌کند، و دستور hilatex از معادل قالب LaTeX
       استفاده می‌نماید.  برای تولید قالب‌ها، از سوییچ -ini استفاده کنید.

       مدیریت آرگومان‌های خط فرمان توسط HiTeX مشابه سایر برنامه‌های TeX در
       پیاده‌سازی web2c است.

       برنامه HiTeX در صورت استفاده به همراه سوییچ -etex افزونه‌های e-TeX را در
       خود ادغام می‌کند (ببینید: etex(1)).

       برنامه HiTeX در صورت استفاده به همراه سوییچ -ltx افزونه‌های مورد نیاز
       برای LaTeX را در خود ادغام می‌کند (ببینید: latex(1)).

گزینه‌ها (OPTIONS)
       این نسخه از HiTeX گزینه‌های خط فرمان زیر را می‌پذیرد.

       -cnf-line string
              تجزیه string به‌عنوان یک خط پیکربندی texmf.cnf.  راهنمای Kpathsea
              را ببینید.

       -compress
              فعال‌سازی فشرده‌سازی برای فایل HINT. فایل‌های فشرده‌شده کوچک‌تر هستند
              اما هنگام مشاهده به بازگشایی نیاز دارند. تنها برای فایل‌های حجیم
              و در صورتی که اندازه فایل اهمیت دارد استفاده شود.

       -empty-page
              هنگام نگارش کتاب‌ها، اغلب صفحات خالی درج می‌شوند - برای نمونه جهت
              شروع فصل‌ها در یک صفحه سمت راست. این صفحات خالی برای خواندن روی
              صفحه نمایش، که در آن صفحات چپ یا راست وجود ندارند، ناخوشایند
              هستند. این گزینه صفحات خالی را در خروجی نگه می‌دارد.

       -no-empty-page
              این گزینه تلاش می‌کند تا صفحات خالی را در خروجی حذف کند. این
              گزینه به‌صورت پیش‌فرض تنظیم شده است.

       -etex  فعال‌سازی افزونه‌های e-TeX. این گزینه تنها در ترکیب با -ini مؤثر
              است. ببینید: etex(1).

       -file-line-error
              چاپ پیام‌های خطا به‌شکل file:line:error که مشابه نحوه قالب‌بندی
              آن‌ها در بسیاری از کامپایلرها است.

       -no-file-line-error
              غیرفعال‌سازی چاپ پیام‌های خطا در قالب file:line:error.

       -fmt format
              استفاده از format به‌عنوان نام قالب مورد استفاده، به‌جای نامی که
              HiTeX با آن فراخوانی شده یا خط %&.

       -help  نمایش پیام راهنما و خروج.

       -hint-debug bitmask
              تنظیم فلگ‌های اشکال‌زدایی فایل HINT بر اساس bitmask.  برای جزئیات
              به گزینه -hint-debug-help مراجعه کنید.

       -hint-debug-help
              چاپ توضیحات مربوط به فلگ‌های اشکال‌زدایی HINT و خروج.

       -hyphenate-first-word
              TeX معمولاً تلاشی برای درج نقاط پیوندواژه در کلمه نخست یک
              پاراگراف انجام نمی‌دهد. اگر یک فایل HINT باید روی دستگاهی بسیار
              کوچک نمایش داده شود، ممکن است چنین نقاط پیوندواژه‌ای ضروری باشند.
              این گزینه به‌طور پیش‌فرض فعال است و ایجاد این نقاط پیوندواژه را
              امکان‌پذیر می‌سازد.

       -no-hyphenate-first-word
              غیرفعال‌سازی درج خودکار نقاط پیوندواژه در کلمه نخست یک پاراگراف.
              تنها در صورتی نیاز است که سازگاری کامل با TeX الزامی باشد.

       -ini   شروع در حالت INI، که برای استخراج قالب‌ها استفاده می‌شود. حالت INI
              می‌تواند برای حروف‌چینی به کار رود، اما هیچ قالبی از پیش بارگذاری
              نمی‌شود و ممکن است مقداردهی‌های اولیه اساسی مانند تنظیم catcodeها
              لازم باشد.

       -interaction mode
              تنظیم حالت تعامل. این حالت می‌تواند یکی از مقادیر batchmode،
              nonstopmode، scrollmode و errorstopmode باشد. معنای این حالت‌ها
              مشابه دستورهای متناظر با بک‌اسلش (\) است.

       -jobname name
              استفاده از name برای نام کار (job name)، به‌جای استخراج آن از روی
              نام فایل ورودی.

       -kpathsea-debug bitmask
              تنظیم فلگ‌های اشکال‌زدایی جستجوی مسیر بر اساس bitmask. برای جزئیات
              به راهنمای Kpathsea مراجعه کنید.

       -ltx   فعال‌سازی افزونه‌های LaTeX. این گزینه تنها در ترکیب با -ini مؤثر
              است. ببینید: latex(1).

       -mfmode mode
              استفاده از mode به‌عنوان حالت Metafont (mode) هنگام تولید فونت‌های
              ناموجود. برای جزئیات به mf(1) مراجعه کنید.

       -mktex fmt
              فعال‌سازی mktexfmt، که در آن fmt باید یکی از مقادیر tex، tfm، fmt
              یا pk باشد.

       -no-mktex fmt
              غیرفعال‌سازی mktexfmt، که در آن fmt باید یکی از مقادیر tex، tfm،
              fmt یا pk باشد.

       -output-directory directory
              نوشتن فایل‌های خروجی در directory به‌جای دایرکتوری جاری. فایل‌های
              ورودی نیز ابتدا در directory و سپس در طول مسیر جستجوی عادی جستجو
              می‌شوند.

       -parse-first-line
              اگر خط اول فایل ورودی اصلی با %& آغاز شود، آن را برای یافتن نام
              dump تجزیه می‌کند.

       -no-parse-first-line
              غیرفعال‌سازی تجزیه خط اول فایل ورودی اصلی.

       -progname name
              وانمود کردن به اجرای برنامه name.  این امر هم بر قالب مورد
              استفاده و هم بر مسیرهای جستجو تأثیر می‌گذارد.

       -resolution number
              هنگام استفاده از Metafont برای تولید فونت‌های ناموجود pk، استفاده
              از تفکیک‌پذیریِ number نقطه بر اینچ (DPI). برای جزئیات به mf(1)
              مراجعه کنید.

       -version
              نمایش اطلاعات نگارش و خروج.

محیط (ENVIRONMENT)
       برای جزئیات دقیق در مورد نحوه استفاده از متغیرهای محیطی، مستندات
       کتابخانه Kpathsea (مانند گره «Path specifications») را ببینید.  ابزار
       kpsewhich می‌تواند برای پرس‌وجوی مقادیر این متغیرها به کار رود.

       یک نکته مهم: در بیشتر قالب‌های HiTeX، نمی‌توانید از ~ در نام فایلی که
       مستقیماً به HiTeX می‌دهید استفاده کنید، زیرا ~ یک نویسه فعال در TeX است و
       بنابراین بسط داده می‌شود، نه اینکه به‌عنوان بخشی از نام فایل در نظر گرفته
       شود. سایر برنامه‌ها، مانند Metafont، این مشکل را ندارند.

       TEXMFOUTPUT
              به‌طور معمول، HiTeX فایل‌های خروجی خود را در دایرکتوری جاری قرار
              می‌دهد. اگر هر فایل خروجی نتواند در آنجا باز شود، تلاش می‌کند آن
              را در دایرکتوری مشخص‌شده در متغیر محیطی TEXMFOUTPUT باز کند.  هیچ
              مقدار پیش‌فرضی برای این متغیر وجود ندارد. برای مثال، اگر دستور
              hitex paper را وارد کنید و دایرکتوری جاری قابل نوشتن نباشد و
              TEXMFOUTPUT مقدار /tmp را داشته باشد، HiTeX تلاش می‌کند فایل
              /tmp/paper.log (و /tmp/paper.hnt، در صورتی که هرگونه خروجی تولید
              شود) را ایجاد کند. همچنین TEXMFOUTPUT برای فایل‌های ورودی نیز
              بررسی می‌شود، زیرا TeX غالباً فایل‌هایی را تولید می‌کند که باید
              متعاقباً خوانده شوند؛ برای ورودی، هیچ پسوندی (مانند «‎.tex») به‌طور
              پیش‌فرض افزوده نمی‌شود و نام ورودی دقیقاً همان‌گونه که داده شده
              بررسی می‌شود.

       TEXINPUTS
              مسیر جستجو برای فایل‌های \input و \openin.  این مسیر معمولاً با
              «.» آغاز می‌شود تا فایل‌های کاربری پیش از فایل‌های سیستمی پیدا
              شوند. بخش‌های خالی در مسیر با مسیرهای تعریف‌شده در فایل texmf.cnf
              جایگزین خواهند شد. برای مثال، مقدار TEXINPUTS را روی
              «.:/home/user/tex:» تنظیم کنید تا دایرکتوری جاری و
              «/home/user/tex» به ابتدای مسیر جستجوی استاندارد اضافه شوند.

       TEXFORMATS
              مسیر جستجو برای فایل‌های قالب.

       TFMFONTS
              مسیر جستجو برای فایل‌های متریک فونت (.tfm).

       SOURCE_DATE_EPOCH
              در صورت تنظیم، مقدار آن (بر حسب ثانیه‌های epoch) برای تاریخ ایجاد
              و به‌عنوان مبدأ زمانی برای دستورهای اولیه مرتبط با زمان در LaTeX
              استفاده خواهد شد. این ویژگی برای ایجاد ساخت‌های بازتولیدپذیر
              (reproducible builds) مفید است.

       FORCE_SOURCE_DATE
              اگر مقدار آن برابر با "1" تنظیم شود، دستورهای اولیه مرتبط با
              زمان در TeX (\year، \month، \day، \time) نیز از مقدار
              SOURCE_DATE_EPOCH مقداردهی اولیه می‌شوند. اگر جایگزین امکان‌پذیر
              دیگری وجود دارد، این روش توصیه نمی‌شود.

       متغیرهای محیطی بسیار دیگری نیز ممکن است در رابطه با جستجوی مسیر مورد
       استفاده قرار گیرند. راهنمای Kpathsea را ببینید.

فایل‌ها (FILES)
       محل فایل‌های ذکرشده در زیر از سیستمی به سیستم دیگر متفاوت است. برای
       یافتن محل آن‌ها از ابزار kpsewhich استفاده کنید.

       *.tfm  فایل‌های متریک برای فونت‌های HiTeX.

       *.fmt  فایل‌های قالب از پیش پردازش‌شده HiTeX.

       *.pk *.pfb
              فایل‌های فونت مورد استفاده توسط HiTeX.

نکات (NOTES)
       این صفحه راهنما جامع و کامل نیست. مستندات کامل HiTeX را می‌توان در HiTeX
       user manual یافت. اطلاعات بیشتر را می‌توان در راهنمای Kpathsea library و
       در HINT: The file format یافت که به‌صورت کتاب یا در قالب الکترونیکی از
       صفحه اصلی پروژه HINT در https://hint.userweb.mwn.de در دسترس است.

اشکالات (BUGS)
       این نسخه از HiTeX چسب‌ها (glues) و فاصله‌ها (kerns) را با عرضی که به
       \hsize یا \vsize وابسته است به‌درستی مدیریت نمی‌کند. به‌طور مشابه، زمانی
       که چیدمان مدخل‌های جدول یا فرمول‌های ریاضی به \hsize یا \vsize وابسته
       باشد، خروجی آن‌ها ممکن است دچار اعوجاج شود.

در دسترس بودن (AVAILABILITY)
       برنامه HiTeX باید روی طیف گسترده‌ای از معماری‌های سخت‌افزاری و سیستم‌های
       عامل کامپایل شود.  برنامه HiTeX بخشی از توزیع TeX Live است.

       صفحه اصلی HiTeX در https://hint.userweb.mwn.de قرار دارد. در آنجا
       نرم‌افزارهای اضافی، به‌ویژه نمایشگرهای فایل‌های HINT، و اطلاعات بیشتر را
       خواهید یافت.

همچنین ببینید (SEE ALSO)
       histretch(1), hishrink(1), latex(1), tex(1), kpsewhich(1)

نویسندگان (AUTHORS)
       نویسنده اصلی HiTeX مارتین روکرت (Martin Ruckert) است، با افزونه‌های e-
       TeX توسط پیتر برایتن‌لونر (Peter Breitenlohner)، افزونه‌های LaTeX توسط
       تیری لاروند (Thierry Laronde)، و کتابخانه kpathsearch توسط کارل بری
       (Karl Berry).

       سامانه TeX توسط دونالد ای. کنوت (Donald E. Knuth) طراحی شد، که آن را با
       استفاده از سامانه Web خود برای برنامه‌های پاسکال پیاده‌سازی کرد.

       بسیاری افراد دیگر در توسعه سامانه حروف‌چینی که امروزه با نام TeX شناخته
       می‌شود مشارکت داشته‌اند؛ بسیار فراتر از آنکه نام همه آن‌ها در اینجا ذکر
       شود.

Version 1.0                    11 November 2021                       HITEX(1)