HISHRINK(1) General Commands Manual HISHRINK(1)

hishrink - تبدیل فایل‌های اسکی HINT به فایل‌های باینری

hishrink [options] [file]

کوچک‌سازی (Shrinking)، یک فایل اسکی HINT را که معمولاً دارای پسوند .hint است، به یک فایل باینری HINT با پسوند .hnt تبدیل می‌کند.

قالب فایل HINT مبتنی بر ASCII ــ که قالب «طولانی» (long) نیز نامیده می‌شود ــ برای خوانایی بهینه‌سازی شده است. این قالب را می‌توان با یک ویرایشگر متنی ویرایش کرد؛ بنابراین تغییرات ساده‌ای را ممکن می‌سازد که انجام آن‌ها در قالب باینری دشوار خواهد بود. این قالب همچنین هنگام اشکال‌زدایی بسیار سودمند است.

قالب باینری فایل HINT ــ که قالب «کوتاه» (short) نیز نامیده می‌شود ــ برای نمایش فایل‌های HINT بهینه‌سازی شده است. این قالب را می‌توان هم رو به جلو و هم رو به عقب به یک اندازه تجزیه کرد تا ناوبری و پیمایش سریع به جلو یا عقب در فایل امکان‌پذیر باشد.

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

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

تنها از نام‌های محلی‌سازی‌شده برای فایل‌های کمکی استفاده می‌کند، همان‌گونه که در بخش FILES در ادامه توضیح داده شده است.

اگر می‌دانید که فایل‌های کمکی را می‌توان با استفاده از نام‌های محلی‌سازی‌شده یافت (برای مثال پس از ایجاد آن‌ها با histretch با استفاده از گزینهٔ -a)، می‌توانید hishrink را همراه با گزینهٔ -a به کار ببرید تا جستجو برای فایل‌های کمکی محدود شود. اگر مطمئن نیستید، نباید هیچ‌یک از گزینه‌های -a یا -g را به کار ببرید. در این صورت hishrink ابتدا با استفاده از نام مسیرهای محلی‌سازی‌شده و سپس با استفاده از نام مسیرها همان‌گونه که داده شده‌اند، به جستجوی فایل‌های کمکی می‌پردازد.

استفاده از فشرده‌سازی را برای فایل HINT فعال می‌کند. فایل‌های فشرده‌شده کوچک‌تر هستند اما هنگام مشاهده نیاز به وافشردگی (decompression) دارند. تنها در صورتی از این گزینه برای فایل‌های بزرگ استفاده کنید که اندازهٔ فایل اهمیت داشته باشد.
فلگ‌های اشکال‌زدایی فایل HINT را بر اساس bitmask تنظیم می‌کند. برای جزئیات از گزینهٔ --help استفاده کنید.
از نام‌های محلی‌سازی‌شده برای فایل‌های کمکی استفاده نمی‌کند، همان‌گونه که در بخش FILES در ادامه توضیح داده شده است.

اگر می‌دانید که تمام فایل‌های کمکی در مکان‌های توصیف‌شده توسط نام مسیرهای ذخیره‌شده در فایل HINT قرار دارند، می‌توانید از این گزینه استفاده کنید. اگر مطمئن نیستید، نباید هیچ‌یک از گزینه‌های -g یا -a را به کار ببرید. در این صورت hishrink ابتدا با استفاده از نام مسیرهای محلی‌سازی‌شده و سپس با استفاده از نام مسیرها همان‌گونه که داده شده‌اند، به جستجوی فایل‌های کمکی می‌پردازد.

پیام راهنما را نمایش داده و خارج می‌شود.
خطای استاندارد را به یک فایل گزارش (log) هدایت می‌کند. نام فایل گزارش از روی نام فایل ورودی با جایگزین کردن پسوند .hint با پسوند .log به دست می‌آید.
به‌جای اشتقاق نام فایل خروجی از روی فایل ورودی، از name برای فایل خروجی استفاده می‌کند. اگر name از قبل دارای این پسوند نباشد، پسوند .hnt را به آن اضافه می‌کند.
اطلاعات نسخه را چاپ کرده و خارج می‌شود.

فایل‌های باینری HINT باید شامل تمام منابع لازم برای نمایش فایل باشند، برای مثال فایل‌های فونت و تصویر. این فایل‌ها، فایل‌های کمکی (auxiliary files) نامیده می‌شوند. فایل‌های اسکی HINT تنها شامل نام مسیر این فایل‌ها هستند.

هنگام ساخت یک فایل باینری HINT از روی یک فایل اسکی HINT، ضروری است که این فایل‌ها پیدا شده، خوانده شوند و در فایل خروجی باینری گنجانده شوند. هنگام ساخت یک فایل اسکی HINT از روی یک فایل باینری HINT، مناسب است که این فایل‌ها بتوانند استخراج شده و روی سیستم فایل نوشته شوند. برای جلوگیری از بازنویسی یا به‌هم‌ریختگی دایرکتوری‌های دلخواه با فایل‌ها هنگام استخراج فایل‌های کمکی، این امکان وجود دارد که پیش از نوشتن یا خواندن فایل‌های کمکی، نام مسیرهای ذخیره‌شده در فایل HINT به نام مسیرهای محلی‌سازی‌شده (localized) نگاشت شوند.

هنگام محاسبهٔ یک نام مسیر محلی‌سازی‌شده از روی یک نام مسیر داده‌شده، بین منابع سراسری مانند فونت‌ها (که با یک نام مسیر مطلق ارجاع داده می‌شوند) و منابع محلی مانند یک تصویر (که با یک نام مسیر نسبی ارجاع داده می‌شود) تمایز قائل می‌شود. دایرکتوری‌ای که نام مسیر محلی‌سازی‌شدهٔ منابع نخست را آغاز می‌کند دارای پسوند .abs است و برای منابع دومی از پسوند .rel استفاده می‌شود. برای نگه داشتن فایل‌های کمکی در این زیردایرکتوری‌ها حتی در صورتی که مسیر آن‌ها شامل پیوندهایی به دایرکتوری والد باشد، پیوندهای والد `..' با پیوندهای زیردایرکتوری `__' جایگزین می‌شوند.

برای مثال، به ازای فایل ورودی paper.hint، منابع سراسری در دایرکتوری paper.abs و منابع محلی در دایرکتوری paper.rel ذخیره می‌شوند. یک مسیر مطلق مانند /usr/share/fonts/ سپس به مسیر محلی‌سازی‌شدهٔ paper.abs/usr/share/fonts/ نگاشت خواهد شد و یک مسیر نسبی مانند ../image/img1.jpg به مسیر محلی‌سازی‌شدهٔ paper.rel/__/image/img1.jpg نگاشت می‌شود.

این صفحهٔ راهنما جامع و کامل نیست. مستندات کامل را می‌توانید در HINT: The file format بیابید. این سند به صورت کتاب یا در قالب الکترونیکی از صفحهٔ اصلی پروژهٔ HINT در https://hint.userweb.mwn.de در دسترس است. در آنجا نرم‌افزارهای تکمیلی، به‌ویژه نمایشگرهای فایل‌های HINT و اطلاعات بیشتر را خواهید یافت.

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

histretch(1), hitex(1)

Martin Ruckert

11 November 2021 Version 1.3