.TH HISHRINK 1 "11 November 2021" "Version 1.3"
.\"=====================================================================
.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)"
hishrink \- تبدیل فایل‌های اسکی HINT به فایل‌های باینری
.SH "خلاصه دستور (SYNOPSIS)"
.B hishrink
.RI [ options ]
.RI [ file ]
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
کوچک‌سازی (Shrinking)، یک فایل اسکی HINT را که معمولاً دارای پسوند
.BR .hint
است، به یک فایل باینری HINT با پسوند
.BR .hnt
تبدیل می‌کند.
.PP
قالب فایل HINT مبتنی بر ASCII ــ که قالب «طولانی» (long) نیز نامیده می‌شود ــ برای خوانایی بهینه‌سازی شده است. این قالب را می‌توان با یک ویرایشگر متنی ویرایش کرد؛ بنابراین تغییرات ساده‌ای را ممکن می‌سازد که انجام آن‌ها در قالب باینری دشوار خواهد بود. این قالب همچنین هنگام اشکال‌زدایی بسیار سودمند است.
.PP
قالب باینری فایل HINT ــ که قالب «کوتاه» (short) نیز نامیده می‌شود ــ برای نمایش فایل‌های HINT بهینه‌سازی شده است. این قالب را می‌توان هم رو به جلو و هم رو به عقب به یک اندازه تجزیه کرد تا ناوبری و پیمایش سریع به جلو یا عقب در فایل امکان‌پذیر باشد.
.PP
قالب باینری فایل HINT برای خواندن اسناد روی صفحه نمایش طراحی شده است. با استفاده از یک نمایشگر HINT برای نمایش فایل HINT، محتوای آن به‌طور پویا با ناحیهٔ نمایشِ در دسترس تطبیق می‌یابد. برای کسب اطلاعات کامل دربارهٔ قالب فایل HINT و برنامه‌های مشاهدهٔ فایل‌های HINT، به
.BR https://hint.userweb.mwn.de
مراجعه کنید.
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
این نسخه از 
.B hishrink
گزینه‌های خط فرمان زیر را می‌پذیرد:
.TP
.B -a
تنها از نام‌های محلی‌سازی‌شده برای فایل‌های کمکی استفاده می‌کند، همان‌گونه که در بخش
.B FILES
در ادامه توضیح داده شده است.

اگر می‌دانید که فایل‌های کمکی را می‌توان با استفاده از نام‌های محلی‌سازی‌شده یافت (برای مثال پس از ایجاد آن‌ها با
.B histretch
با استفاده از گزینهٔ
.BR -a )،
می‌توانید
.B hishrink
را همراه با گزینهٔ
.B -a
به کار ببرید تا جستجو برای فایل‌های کمکی محدود شود. اگر مطمئن نیستید، نباید هیچ‌یک از گزینه‌های
.B -a
یا
.B -g
را به کار ببرید. در این صورت
.B hishrink
ابتدا با استفاده از نام مسیرهای محلی‌سازی‌شده و سپس با استفاده از نام مسیرها همان‌گونه که داده شده‌اند، به جستجوی فایل‌های کمکی می‌پردازد.
.TP
.B -c
استفاده از فشرده‌سازی را برای فایل HINT فعال می‌کند. فایل‌های فشرده‌شده کوچک‌تر هستند اما هنگام مشاهده نیاز به وافشردگی (decompression) دارند. تنها در صورتی از این گزینه برای فایل‌های بزرگ استفاده کنید که اندازهٔ فایل اهمیت داشته باشد.
.TP
.BI -d \ bitmask
فلگ‌های اشکال‌زدایی فایل HINT را بر اساس
.IR bitmask
تنظیم می‌کند. برای جزئیات از گزینهٔ
.B --help
استفاده کنید.
.TP
.B -g
از نام‌های محلی‌سازی‌شده برای فایل‌های کمکی استفاده نمی‌کند، همان‌گونه که در بخش
.B FILES
در ادامه توضیح داده شده است.

اگر می‌دانید که تمام فایل‌های کمکی در مکان‌های توصیف‌شده توسط نام مسیرهای ذخیره‌شده در فایل HINT قرار دارند، می‌توانید از این گزینه استفاده کنید. اگر مطمئن نیستید، نباید هیچ‌یک از گزینه‌های
.B -g
یا
.B -a
را به کار ببرید. در این صورت
.B hishrink
ابتدا با استفاده از نام مسیرهای محلی‌سازی‌شده و سپس با استفاده از نام مسیرها همان‌گونه که داده شده‌اند، به جستجوی فایل‌های کمکی می‌پردازد.
.TP
.B --help
پیام راهنما را نمایش داده و خارج می‌شود.
.TP
.B -l
خطای استاندارد را به یک فایل گزارش (log) هدایت می‌کند. نام فایل گزارش از روی نام فایل ورودی با جایگزین کردن پسوند
.B .hint
با پسوند
.BR .log
به دست می‌آید.
.TP
.BI -o \ name
به‌جای اشتقاق نام فایل خروجی از روی فایل ورودی، از
.I name
برای فایل خروجی استفاده می‌کند. اگر
.I name
از قبل دارای این پسوند نباشد، پسوند
.B .hnt
را به آن اضافه می‌کند.
.TP
.B --version
اطلاعات نسخه را چاپ کرده و خارج می‌شود.
.\"=====================================================================
.SH "فایل‌ها (FILES)"
فایل‌های باینری HINT باید شامل تمام منابع لازم برای نمایش فایل باشند، برای مثال فایل‌های فونت و تصویر. این فایل‌ها، فایل‌های کمکی (auxiliary files) نامیده می‌شوند. فایل‌های اسکی HINT تنها شامل نام مسیر این فایل‌ها هستند.

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

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

برای مثال،
به ازای فایل ورودی
.BR paper.hint ،
منابع سراسری در دایرکتوری
.B paper.abs
و منابع محلی در دایرکتوری
.B paper.rel
ذخیره می‌شوند. یک مسیر مطلق مانند
.B /usr/share/fonts/
سپس به مسیر محلی‌سازی‌شدهٔ
.BR paper.abs/usr/share/fonts/ 
نگاشت خواهد شد و یک مسیر نسبی مانند
.B ../image/img1.jpg
به مسیر محلی‌سازی‌شدهٔ
.BR paper.rel/__/image/img1.jpg
نگاشت می‌شود.
.\"=====================================================================
.SH "نکات (NOTES)"
این صفحهٔ راهنما جامع و کامل نیست. مستندات کامل را می‌توانید در
.IR "HINT: The file format"
بیابید. این سند به صورت کتاب یا در قالب الکترونیکی از صفحهٔ اصلی پروژهٔ HINT در
.BR https://hint.userweb.mwn.de
در دسترس است. در آنجا نرم‌افزارهای تکمیلی، به‌ویژه نمایشگرهای فایل‌های HINT و اطلاعات بیشتر را خواهید یافت.
.\"=====================================================================
.SH "در دسترس بودن (AVAILABILITY)"
.B hishrink
باید روی طیف گسترده‌ای از معماری‌های ماشین و سیستم‌های عامل کامپایل شود.
این برنامه بخشی از توزیع \*(TX Live است.
.PP
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR histretch (1),
.BR hitex (1)
.\"=====================================================================
.SH "نویسندگان (AUTHORS)"
Martin Ruckert
.\" vim: syntax=nroff