نام (NAME)

histretch - تبدیل فایل‌های باینری HINT به فایل‌های ASCII

خلاصه دستور (SYNOPSIS)

histretch [options] [file]

توضیحات (DESCRIPTION)

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

قالب باینری فایل HINT — که به آن قالب «کوتاه» (“short”) نیز گفته می‌شود — برای نمایش فایل‌های HINT بهینه‌سازی شده است. این قالب می‌تواند به خوبی و به طور یکسان هم به سمت جلو و هم به سمت عقب تجزیه شود تا پیمایش سریع به جلو یا عقب در فایل امکان‌پذیر گردد.

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

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

گزینه‌ها (OPTIONS)

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

-a

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

اگر در حال گسترش (stretch) یک فایل HINT هستید که بعداً می‌خواهید آن را دوباره به قالب باینری‌اش فشرده (shrink) کنید، از این گزینه استفاده کنید؛ مگر اینکه بدانید هم‌اکنون تمام فایل‌های کمکی موجود در آن را در اختیار دارید.

-d bitmask

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

-f

جایگزینی اجباری فایل‌های کمکی موجود. از این گزینه همراه با گزینه -g یا -a استفاده کنید تا مطمئن شوید فایل‌های کمکیِ از قبل موجود با فایل‌های کمکی موجود در فایل HINT جایگزین می‌شوند.

هشدار: این گزینه به خصوص همراه با گزینه -g یک گزینه خطرناک است. هرگز آن را برای یک فایل HINT با منبع ناشناس به کار نبرید. این گزینه ممکن است هر فایلی را در دستگاه شما که به آن دسترسی نوشتن دارید جایگزین کند. در صورت تردید، از گزینه -f استفاده نکنید.

-g

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

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

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

هشدار: این گزینه به ویژه همراه با گزینه -f خطرناک است. هرگز آن را روی یک فایل HINT با منبع ناشناس اجرا نکنید. این گزینه می‌تواند در هر فایلی در دستگاه شما که دسترسی نوشتن به آن دارید بنویسد (و آن را جایگزین کند).

--help

چاپ پیام راهنما و خروج.

-l

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

-o name

استفاده از name برای فایل خروجی به جای استخراج آن از نام فایل ورودی. اگر name از قبل این پسوند را نداشته باشد، پسوند .hint به آن افزوده می‌شود.

-u

فعال کردن استفاده از کدهای نویسه UTF8. بدون این گزینه، فایل خروجی یک فایل صرفاً ASCII خواهد بود، زیرا کدهای نویسه خارج از محدوده ASCII با استفاده از نمایش عددی‌شان نوشته می‌شوند. با این گزینه، فایل همیشه نویسه‌های قابل چاپ را با استفاده از کدهای نویسه UTF8 آن‌ها نشان می‌دهد. این امر ممکن است در صورت نمایش فایل با برنامه‌ای با پشتیبانی از UTF8، خوانایی آن را افزایش دهد؛ اما اگر با برنامه‌ای نمایش داده شود که نویسه‌های UTF8 را به درستی پردازش نمی‌کند، ممکن است خوانایی کمتری داشته باشد. همچنین گزینه -x را ببینید.

--version

چاپ اطلاعات نسخه و خروج.

-x

فعال کردن استفاده از کدهای نویسه هگزادسیمال. بدون این گزینه، نویسه‌هایی که با استفاده از کدهای نویسه خود نشان داده نمی‌شوند، با نمایش دهدهی کد نویسه نشان داده می‌شوند. با این گزینه از نمایش هگزادسیمال استفاده می‌شود. محدوده کدهای نویسه‌ای که نمایش عددی دارند شامل نویسه‌های غیرقابل‌چاپ (کدهای نویسه کوچک‌تر از ۳۲) و در صورتی که گزینه -u داده نشده باشد، کدهای نویسه با مقدار ۱۲۷ و بالاتر می‌شود.

فایل‌ها (FILES)

فایل‌های باینری HINT باید شامل تمام منابع لازم برای نمایش فایل باشند، مانند فایل‌های فونت و تصویر. به این فایل‌ها، فایل‌های کمکی گفته می‌شود. فایل‌های HINT متنی (ASCII) فقط شامل نام مسیر این فایل‌ها هستند.

هنگام ساخت یک فایل باینری HINT از یک فایل ASCII HINT، لازم است این فایل‌ها پیدا شده، خوانده شوند و در فایل خروجی باینری گنجانده شوند. هنگام ساخت یک فایل ASCII 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 نگاشت خواهد شد.

نکات (NOTES)

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

دسترس‌پذیری (AVAILABILITY)

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

همچنین ببینید (SEE ALSO)

hishrink(1), hitex(1),

نویسندگان (AUTHORS)

Martin Ruckert