.TH HISTRETCH 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)"
histretch \- تبدیل فایل‌های باینری HINT به فایل‌های ASCII
.SH "خلاصه دستور (SYNOPSIS)"
.B histretch
.RI [ options ]
.RI [ file ]
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
عملیات کشش (Stretching)، یک فایل باینری HINT را که معمولاً دارای پسوند
.BR .hnt
است، به یک فایل HINT مبتنی بر ASCII با پسوند
.BR .hint
تبدیل می‌کند.
.PP
قالب باینری فایل HINT — که به آن قالب «کوتاه» (\(lqshort\(rq) نیز گفته می‌شود — برای نمایش فایل‌های HINT بهینه‌سازی شده است. این قالب می‌تواند به خوبی و به طور یکسان هم به سمت جلو و هم به سمت عقب تجزیه شود تا پیمایش سریع به جلو یا عقب در فایل امکان‌پذیر گردد.
.PP
قالب مبتنی بر ASCII فایل HINT — که به آن قالب «بلند» (\(lqlong\(rq) نیز می‌گویند — برای خوانایی بهینه‌سازی شده است. این قالب را می‌توان با یک ویرایشگر متن ویرایش کرد؛ بنابراین امکان اعمال تغییرات ساده‌ای را فراهم می‌کند که دستیابی به آن‌ها با استفاده از قالب باینری دشوار خواهد بود. این قالب همچنین هنگام اشکال‌زدایی بسیار کاربردی و مناسب است.
.PP
قالب باینری فایل HINT برای خواندن اسناد بر روی صفحه نمایش طراحی شده است. با استفاده از یک نمایشگر HINT برای نمایش یک فایل HINT، محتوای آن به صورت پویا با فضای نمایش در دسترس تطبیق می‌یابد. برای کسب اطلاعات کامل درباره قالب فایل HINT و برنامه‌های نمایش فایل‌های HINT، نشانی
.BR https://hint.userweb.mwn.de
را ببینید.
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
این نسخه از
.B histretch
گزینه‌های خط فرمان زیر را می‌پذیرد:
.TP
.B -a
نوشتن فایل‌های کمکی روی دیسک با استفاده از نام‌های مسیر محلی‌سازی‌شده، همان‌طور که در بخش
.B فایل‌ها (FILES)
در زیر توضیح داده شده است.

اگر در حال گسترش (stretch) یک فایل HINT هستید که بعداً می‌خواهید آن را دوباره به قالب باینری‌اش فشرده (shrink) کنید، از این گزینه استفاده کنید؛ مگر اینکه بدانید هم‌اکنون تمام فایل‌های کمکی موجود در آن را در اختیار دارید.
.TP
.BI -d \ bitmask
پرچم‌های اشکال‌زدایی فایل HINT را بر اساس
.IR bitmask
تنظیم می‌کند. برای جزئیات، گزینه
.B --help
را ببینید.
.TP
.B -f
جایگزینی اجباری فایل‌های کمکی موجود. از این گزینه همراه با گزینه
.B -g
یا
.B -a
استفاده کنید تا مطمئن شوید فایل‌های کمکیِ از قبل موجود با فایل‌های کمکی موجود در فایل HINT جایگزین می‌شوند.

.BR هشدار :
این گزینه به خصوص همراه با گزینه
.B -g
یک گزینه خطرناک است. هرگز آن را برای یک فایل HINT با منبع ناشناس به کار نبرید. این گزینه ممکن است هر فایلی را در دستگاه شما که به آن دسترسی نوشتن دارید جایگزین کند. در صورت تردید، از گزینه
.B -f
استفاده نکنید.
.TP
.B -g
نوشتن فایل‌های کمکی روی دیسک با استفاده از نام‌های مسیری که در فایل HINT ذخیره شده است. این گزینه جایگزینی برای گزینه
.B -a
است و در صورت تعیین شدن، اولویت دارد. در صورت تردید، از گزینه
.B -g
استفاده نکنید. اگر فقط می‌خواهید فایل HINT را گسترش دهید، سپس آن را ویرایش کنید و پس از آن مجدداً به قالب باینری فشرده سازید، باید از گزینه
.B -a
استفاده کنید.

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

اگر در حال گسترش یک فایل HINT روی یک دستگاه هستید در حالی که فایل روی دستگاه متفاوتی ایجاد شده است،
.B histretch
تلاش خواهد کرد تا یک فایل کمکی را در همان دایرکتوری‌ای کپی کند که هنگام ایجاد فایل HINT استفاده شده بود، به شرطی که دسترسی نوشتن لازم را داشته باشید. با فرض اینکه هر دو دستگاه ساختار دایرکتوری یکسانی دارند، این احتمالاً همان جایی است که می‌خواهید فایل کمکی در آن قرار گیرد.

.BR هشدار :
این گزینه به ویژه همراه با گزینه
.B -f
خطرناک است. هرگز آن را روی یک فایل HINT با منبع ناشناس اجرا نکنید. این گزینه می‌تواند در هر فایلی در دستگاه شما که دسترسی نوشتن به آن دارید بنویسد (و آن را جایگزین کند).
.TP
.B --help
چاپ پیام راهنما و خروج.
.TP
.B -l
هدایت خطای استاندارد به یک فایل گزارش (log). نام فایل گزارش از نام فایل ورودی با جایگزینی پسوند
.B .hnt
با پسوند
.BR .log
به دست می‌آید.
.TP
.BI -o \ name
استفاده از
.I name
برای فایل خروجی به جای استخراج آن از نام فایل ورودی. اگر
.I name
از قبل این پسوند را نداشته باشد، پسوند
.B .hint
به آن افزوده می‌شود.
.TP
.B -u
فعال کردن استفاده از کدهای نویسه UTF8. بدون این گزینه، فایل خروجی یک فایل صرفاً ASCII خواهد بود، زیرا کدهای نویسه خارج از محدوده ASCII با استفاده از نمایش عددی‌شان نوشته می‌شوند. با این گزینه، فایل همیشه نویسه‌های قابل چاپ را با استفاده از کدهای نویسه UTF8 آن‌ها نشان می‌دهد. این امر ممکن است در صورت نمایش فایل با برنامه‌ای با پشتیبانی از UTF8، خوانایی آن را افزایش دهد؛ اما اگر با برنامه‌ای نمایش داده شود که نویسه‌های UTF8 را به درستی پردازش نمی‌کند، ممکن است خوانایی کمتری داشته باشد. همچنین گزینه
.B -x
را ببینید.
.TP
.B --version
چاپ اطلاعات نسخه و خروج.
.TP
.B -x
فعال کردن استفاده از کدهای نویسه هگزادسیمال. بدون این گزینه، نویسه‌هایی که با استفاده از کدهای نویسه خود نشان داده نمی‌شوند، با نمایش دهدهی کد نویسه نشان داده می‌شوند. با این گزینه از نمایش هگزادسیمال استفاده می‌شود. محدوده کدهای نویسه‌ای که نمایش عددی دارند شامل نویسه‌های غیرقابل‌چاپ (کدهای نویسه کوچک‌تر از ۳۲) و در صورتی که گزینه
.B -u
داده نشده باشد، کدهای نویسه با مقدار ۱۲۷ و بالاتر می‌شود.
.\"=====================================================================
.SH "فایل‌ها (FILES)"
فایل‌های باینری HINT باید شامل تمام منابع لازم برای نمایش فایل باشند، مانند فایل‌های فونت و تصویر. به این فایل‌ها، فایل‌های کمکی گفته می‌شود. فایل‌های HINT متنی (ASCII) فقط شامل نام مسیر این فایل‌ها هستند.

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

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

برای نمونه، با در نظر گرفتن فایل ورودی
.BR paper.hint ،
منابع سراسری در دایرکتوری
.B paper.abs
و منابع محلی در
.BR 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 histretch
باید روی طیف گسترده‌ای از معماری‌های سخت‌افزاری و سیستم‌عامل‌ها کامپایل شود. این برنامه بخشی از توزیع \*(TX Live است.
.PP
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR hishrink (1),
.BR hitex (1),
.\"=====================================================================
.SH "نویسندگان (AUTHORS)"
Martin Ruckert
.\" vim: syntax=nroff