HITEX(1) General Commands Manual HITEX(1)

hitex - تولید خروجی HINT از TeX

hitex [options] [&format] [file|\commands]

اجرای حروف‌چین 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)).

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

تجزیه string به‌عنوان یک خط پیکربندی texmf.cnf. راهنمای Kpathsea را ببینید.
فعال‌سازی فشرده‌سازی برای فایل HINT. فایل‌های فشرده‌شده کوچک‌تر هستند اما هنگام مشاهده به بازگشایی نیاز دارند. تنها برای فایل‌های حجیم و در صورتی که اندازه فایل اهمیت دارد استفاده شود.
هنگام نگارش کتاب‌ها، اغلب صفحات خالی درج می‌شوند - برای نمونه جهت شروع فصل‌ها در یک صفحه سمت راست. این صفحات خالی برای خواندن روی صفحه نمایش، که در آن صفحات چپ یا راست وجود ندارند، ناخوشایند هستند. این گزینه صفحات خالی را در خروجی نگه می‌دارد.
این گزینه تلاش می‌کند تا صفحات خالی را در خروجی حذف کند. این گزینه به‌صورت پیش‌فرض تنظیم شده است.
فعال‌سازی افزونه‌های e-TeX. این گزینه تنها در ترکیب با -ini مؤثر است. ببینید: etex(1).
چاپ پیام‌های خطا به‌شکل file:line:error که مشابه نحوه قالب‌بندی آن‌ها در بسیاری از کامپایلرها است.
غیرفعال‌سازی چاپ پیام‌های خطا در قالب file:line:error.
استفاده از format به‌عنوان نام قالب مورد استفاده، به‌جای نامی که HiTeX با آن فراخوانی شده یا خط %&.
نمایش پیام راهنما و خروج.
تنظیم فلگ‌های اشکال‌زدایی فایل HINT بر اساس bitmask. برای جزئیات به گزینه -hint-debug-help مراجعه کنید.
چاپ توضیحات مربوط به فلگ‌های اشکال‌زدایی HINT و خروج.
TeX معمولاً تلاشی برای درج نقاط پیوندواژه در کلمه نخست یک پاراگراف انجام نمی‌دهد. اگر یک فایل HINT باید روی دستگاهی بسیار کوچک نمایش داده شود، ممکن است چنین نقاط پیوندواژه‌ای ضروری باشند. این گزینه به‌طور پیش‌فرض فعال است و ایجاد این نقاط پیوندواژه را امکان‌پذیر می‌سازد.
غیرفعال‌سازی درج خودکار نقاط پیوندواژه در کلمه نخست یک پاراگراف. تنها در صورتی نیاز است که سازگاری کامل با TeX الزامی باشد.
شروع در حالت INI، که برای استخراج قالب‌ها استفاده می‌شود. حالت INI می‌تواند برای حروف‌چینی به کار رود، اما هیچ قالبی از پیش بارگذاری نمی‌شود و ممکن است مقداردهی‌های اولیه اساسی مانند تنظیم catcodeها لازم باشد.
تنظیم حالت تعامل. این حالت می‌تواند یکی از مقادیر batchmode، nonstopmode، scrollmode و errorstopmode باشد. معنای این حالت‌ها مشابه دستورهای متناظر با بک‌اسلش (\) است.
استفاده از name برای نام کار (job name)، به‌جای استخراج آن از روی نام فایل ورودی.
تنظیم فلگ‌های اشکال‌زدایی جستجوی مسیر بر اساس bitmask. برای جزئیات به راهنمای Kpathsea مراجعه کنید.
فعال‌سازی افزونه‌های LaTeX. این گزینه تنها در ترکیب با -ini مؤثر است. ببینید: latex(1).
استفاده از mode به‌عنوان حالت Metafont (mode) هنگام تولید فونت‌های ناموجود. برای جزئیات به mf(1) مراجعه کنید.
فعال‌سازی mktexfmt، که در آن fmt باید یکی از مقادیر tex، tfm، fmt یا pk باشد.
غیرفعال‌سازی mktexfmt، که در آن fmt باید یکی از مقادیر tex، tfm، fmt یا pk باشد.
نوشتن فایل‌های خروجی در directory به‌جای دایرکتوری جاری. فایل‌های ورودی نیز ابتدا در directory و سپس در طول مسیر جستجوی عادی جستجو می‌شوند.
اگر خط اول فایل ورودی اصلی با %& آغاز شود، آن را برای یافتن نام dump تجزیه می‌کند.
غیرفعال‌سازی تجزیه خط اول فایل ورودی اصلی.
وانمود کردن به اجرای برنامه name. این امر هم بر قالب مورد استفاده و هم بر مسیرهای جستجو تأثیر می‌گذارد.
هنگام استفاده از Metafont برای تولید فونت‌های ناموجود pk، استفاده از تفکیک‌پذیریِ number نقطه بر اینچ (DPI). برای جزئیات به mf(1) مراجعه کنید.
نمایش اطلاعات نگارش و خروج.

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

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

به‌طور معمول، HiTeX فایل‌های خروجی خود را در دایرکتوری جاری قرار می‌دهد. اگر هر فایل خروجی نتواند در آنجا باز شود، تلاش می‌کند آن را در دایرکتوری مشخص‌شده در متغیر محیطی TEXMFOUTPUT باز کند. هیچ مقدار پیش‌فرضی برای این متغیر وجود ندارد. برای مثال، اگر دستور hitex paper را وارد کنید و دایرکتوری جاری قابل نوشتن نباشد و TEXMFOUTPUT مقدار /tmp را داشته باشد، HiTeX تلاش می‌کند فایل /tmp/paper.log (و /tmp/paper.hnt، در صورتی که هرگونه خروجی تولید شود) را ایجاد کند. همچنین TEXMFOUTPUT برای فایل‌های ورودی نیز بررسی می‌شود، زیرا TeX غالباً فایل‌هایی را تولید می‌کند که باید متعاقباً خوانده شوند؛ برای ورودی، هیچ پسوندی (مانند «‎.tex») به‌طور پیش‌فرض افزوده نمی‌شود و نام ورودی دقیقاً همان‌گونه که داده شده بررسی می‌شود.
مسیر جستجو برای فایل‌های \input و \openin. این مسیر معمولاً با «.» آغاز می‌شود تا فایل‌های کاربری پیش از فایل‌های سیستمی پیدا شوند. بخش‌های خالی در مسیر با مسیرهای تعریف‌شده در فایل texmf.cnf جایگزین خواهند شد. برای مثال، مقدار TEXINPUTS را روی «.:/home/user/tex:» تنظیم کنید تا دایرکتوری جاری و «/home/user/tex» به ابتدای مسیر جستجوی استاندارد اضافه شوند.
مسیر جستجو برای فایل‌های قالب.
مسیر جستجو برای فایل‌های متریک فونت (.tfm).
در صورت تنظیم، مقدار آن (بر حسب ثانیه‌های epoch) برای تاریخ ایجاد و به‌عنوان مبدأ زمانی برای دستورهای اولیه مرتبط با زمان در LaTeX استفاده خواهد شد. این ویژگی برای ایجاد ساخت‌های بازتولیدپذیر (reproducible builds) مفید است.
اگر مقدار آن برابر با "1" تنظیم شود، دستورهای اولیه مرتبط با زمان در TeX (\year، \month، \day، \time) نیز از مقدار SOURCE_DATE_EPOCH مقداردهی اولیه می‌شوند. اگر جایگزین امکان‌پذیر دیگری وجود دارد، این روش توصیه نمی‌شود.

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

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

*.tfm
فایل‌های متریک برای فونت‌های HiTeX.
*.fmt
فایل‌های قالب از پیش پردازش‌شده HiTeX.
*.pk *.pfb
فایل‌های فونت مورد استفاده توسط HiTeX.

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

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

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

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

histretch(1), hishrink(1), latex(1), tex(1), kpsewhich(1)

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

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

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

11 November 2021 Version 1.0