نام (NAME)

findhyph - یافتن واژه‌های خط‌تیره‌گذاری‌شده توسط TeX در یک سند

نصب (INSTALLATION)

بسته به سیستم‌عامل (OS) مورد استفاده، findhyph یا findhyph.bat را در پوشه‌ای که در PATH سیستم قرار دارد کپی کنید. مفسر Perl در سیستم‌های شبه‌یونیکس باید در "/usr/bin/" قرار داشته باشد، یا هنگام استفاده از findhyph.bat در PATH موجود باشد.

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

findhyph [options] foo.log

توضیحات (DESCRIPTION)

برای استفاده از این برنامه:

1): دستور "\tracingparagraphs=1" را در سند TeX با نام foo.tex قرار دهید و اجرا کنید:
2): tex foo.tex
3): findhyph [options] foo.log

اگر برای بهینه‌سازی پاراگراف‌ها مقدار "\looseness=<N>" را تنظیم می‌کنید، باید این اطلاعات را به‌صورت "@looseness=<N>" (در یک خط جداگانه) به فایل foo.log بفرستید. برای این منظور می‌توانید از ماکرویی مانند "\def\setlooseness#1{\looseness=#1 \immediate\write-1{@looseness=#1}}" استفاده کنید. اگر پاراگراف حاوی محتوایی در حالت ریاضی نمایشی (display math mode) باشد، باید از این ماکرو در تمامی بخش‌های تقسیم‌شده پاراگراف استفاده کنید.

گزینه‌ها (OPTIONS)

-c: نمایش واژه‌های خط‌تیره‌گذاری‌شده در سیاق متن
-f: نمایش انتخاب‌کننده‌های قلم و سایر رشته‌هایی که با نویسه بک‌اسلش آغاز می‌شوند
-v: نمایش نگارش برنامه
-p: تولید فایلی حاوی اطلاعات درباره حروف اضافه و حروف ربط تک‌حرفیِ باقی‌مانده در انتهای خط
-l=STRING: استفاده از حروف اضافه/ربط فهرست‌شده در STRING به‌جای فهرست پیش‌فرض حروف اضافه و ربط "kKsSvVzZoOuUiIA" که برای زبان‌های اسلواکی و چکی استفاده می‌شود

فایل‌های خروجی (OUTPUT FILES)

foo.hyph

فهرست واژه‌های خط‌تیره‌گذاری‌شده. تمام نویسه‌های نشانه‌گذاری، پرانتزها و دیگر نویسه‌هایی که بلافاصله قبل یا بعد از واژه‌های نمایش‌داده‌شده قرار دارند، در این فهرست گنجانده می‌شوند. ساختارهای TeX که نمایش آن‌ها بیش از حد دشوار است ("\hbox{}"، "\mark{}" و غیره) به‌صورت "[]" نشان داده می‌شوند. حالت ریاضی با علامت "$" مشخص می‌شود.

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

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

foo.prep

فهرست حروف اضافه در صورت استفاده از گزینه -p.

تاریخچه (HISTORY)

1.0 (2001-04-08)

•: انتشار عمومی

2.0 (2009-08-10)

اصلاحات در الگوریتم تشخیص شکست خط؛ پشتیبانی از گذر سوم الگوریتم شکست خط در TeX ("\emergencystretch" مثبت)؛ پشتیبانی از شکست‌های اختیاری در گذر اول
بهبود در تشخیص شماره صفحه (شناسایی شماره صفحه‌های منفی، شماره صفحه‌های مرکب هنگامی که ثبات‌های "\count1" تا "\count9" غیرصفر هستند، و قالب‌های "[nn{mapfile}]"، "[nn<picture>]" و "[nn<newline>" مورد استفاده در pdfTeX؛ تشخیص نادرست شماره صفحه باید بسیار کم‌شمارتر باشد)
فهرست قابل‌پیکربندی حروف اضافه و حروف ربط
امکان نمایش واژه‌های خط‌تیره‌گذاری‌شده در سیاق متن
پیشنهادها و آزمایش‌ها توسط Pavel Stříž

3.0 (2012-02-01)

رفع اشکالی که هنگام منفی بودن مجموع امتیاز منفی (demerits) پاراگراف رخ می‌داد
تنظیم "\looseness" اکنون در نظر گرفته می‌شود (با تشکر از Karel Horák برای شناسایی این مشکل)

3.1 (2012-11-03)

•: رفع نمایش پیوسته‌نگاشت‌های (ligatures) خط‌تیره‌گذاری‌شده (گزارش اشکال توسط Karel Horák)

3.2 (2012-11-21)

•: بهبود تعریف نمونه ماکروی "\setlooseness" (با تشکر از Karl Berry)

3.3 (2013-06-18)

•: اصلاح صفحه راهنما طبق پیشنهاد Eric S. Raymond

3.4 (2015-10-18)

رفع پردازش گزارش‌های تولیدشده با استفاده از گزینه "\lastlinefit" در ε-TeX (گزارش اشکال توسط Karel Horák)
رفع مدیریت چندسکویی شکست‌های خط در فایل ورودی

مجوز (LICENSE)

این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نگارش ۲ مجوز و چه هر نگارش بعدی آن، دوباره توزیع کرده یا تغییر دهید.

نویسنده (AUTHOR)

کپی‌رایت (c) Martin Budaj <m.b@speleo.sk> 2000, 2001, 2009, 2012, 2015