.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "FINDHYPH 1" .TH FINDHYPH 1 "2015-10-18" "perl v5.20.2" "" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" findhyph \- یافتن واژه‌های خط‌تیره‌گذاری‌شده توسط TeX در یک سند .SH "نصب (INSTALLATION)" .IX Header "INSTALLATION" بسته به سیستم‌عامل (\s-1OS\s0) مورد استفاده، \fBfindhyph\fR یا \fBfindhyph.bat\fR را در پوشه‌ای که در \s-1PATH\s0 سیستم قرار دارد کپی کنید. مفسر Perl در سیستم‌های شبه‌یونیکس باید در \&\f(CW\*(C`/usr/bin/\*(C'\fR قرار داشته باشد، یا هنگام استفاده از \fBfindhyph.bat\fR در \s-1PATH\s0 موجود باشد. .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBfindhyph [options]\fR \fIfoo.log\fR .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" برای استفاده از این برنامه: .IP "1)" 4 .IX Item "1)" دستور \f(CW\*(C`\etracingparagraphs=1\*(C'\fR را در سند TeX با نام \fIfoo.tex\fR قرار دهید و اجرا کنید: .IP "2)" 4 .IX Item "2)" \&\fBtex\fR \fIfoo.tex\fR .IP "3)" 4 .IX Item "3)" \&\fBfindhyph [options]\fR \fIfoo.log\fR .PP اگر برای بهینه‌سازی پاراگراف‌ها مقدار \f(CW\*(C`\elooseness=\*(C'\fR را تنظیم می‌کنید، باید این اطلاعات را به‌صورت \f(CW\*(C`@looseness=\*(C'\fR (در یک خط جداگانه) به فایل \fIfoo.log\fR بفرستید. برای این منظور می‌توانید از ماکرویی مانند \&\f(CW\*(C`\edef\esetlooseness#1{\elooseness=#1 \eimmediate\ewrite\-1{@looseness=#1}}\*(C'\fR استفاده کنید. اگر پاراگراف حاوی محتوایی در حالت ریاضی نمایشی (display math mode) باشد، باید از این ماکرو در تمامی بخش‌های تقسیم‌شده پاراگراف استفاده کنید. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-c\fR" 4 .IX Item "-c" نمایش واژه‌های خط‌تیره‌گذاری‌شده در سیاق متن .IP "\fB\-f\fR" 4 .IX Item "-f" نمایش انتخاب‌کننده‌های قلم و سایر رشته‌هایی که با نویسه بک‌اسلش آغاز می‌شوند .IP "\fB\-v\fR" 4 .IX Item "-v" نمایش نگارش برنامه .IP "\fB\-p\fR" 4 .IX Item "-p" تولید فایلی حاوی اطلاعات درباره حروف اضافه و حروف ربط تک‌حرفیِ باقی‌مانده در انتهای خط .IP "\fB\-l=STRING\fR" 4 .IX Item "-l=STRING" استفاده از حروف اضافه/ربط فهرست‌شده در \s-1STRING\s0 به‌جای فهرست پیش‌فرض حروف اضافه و ربط \f(CW\*(C`kKsSvVzZoOuUiIA\*(C'\fR که برای زبان‌های اسلواکی و چکی استفاده می‌شود .SH "فایل‌های خروجی (OUTPUT FILES)" .IX Header "OUTPUT FILES" .IP "\fIfoo.hyph\fR" 4 .IX Item "foo.hyph" فهرست واژه‌های خط‌تیره‌گذاری‌شده. تمام نویسه‌های نشانه‌گذاری، پرانتزها و دیگر نویسه‌هایی که بلافاصله قبل یا بعد از واژه‌های نمایش‌داده‌شده قرار دارند، در این فهرست گنجانده می‌شوند. ساختارهای TeX که نمایش آن‌ها بیش از حد دشوار است (\f(CW\*(C`\ehbox{}\*(C'\fR، \&\f(CW\*(C`\emark{}\*(C'\fR و غیره) به‌صورت \f(CW\*(C`[]\*(C'\fR نشان داده می‌شوند. حالت ریاضی با علامت \f(CW\*(C`$\*(C'\fR مشخص می‌شود. .Sp شماره‌های صفحه داخل قلاب‌ها به فایل \s-1LOG\s0 اشاره دارند و ممکن است گاهی با سند حروف‌چینی‌شده متفاوت باشند. دلیل آن این است که ممکن است TeX برای یافتن محل شکست صفحه، نیاز به شکستن پاراگراف‌های بیشتری نسبت به آنچه که در نهایت در صفحه جا می‌شود داشته باشد. .Sp واژه‌های خط‌تیره‌گذاری‌شده در پانویس‌ها، قبل از واژه‌های خط‌تیره‌گذاری‌شده در پاراگرافی که پانویس در آن ارجاع داده شده، فهرست می‌شوند. .IP "\fIfoo.prep\fR" 4 .IX Item "foo.prep" فهرست حروف اضافه در صورت استفاده از گزینه \fB\-p\fR. .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" 1.0 (2001\-04\-08) .IX Subsection "1.0 (2001-04-08)" .IP "\(bu" 4 انتشار عمومی .PP 2.0 (2009\-08\-10) .IX Subsection "2.0 (2009-08-10)" .IP "\(bu" 4 اصلاحات در الگوریتم تشخیص شکست خط؛ پشتیبانی از گذر سوم الگوریتم شکست خط در TeX (\f(CW\*(C`\eemergencystretch\*(C'\fR مثبت)؛ پشتیبانی از شکست‌های اختیاری در گذر اول .IP "\(bu" 4 بهبود در تشخیص شماره صفحه (شناسایی شماره صفحه‌های منفی، شماره صفحه‌های مرکب هنگامی که ثبات‌های \f(CW\*(C`\ecount1\*(C'\fR تا \f(CW\*(C`\ecount9\*(C'\fR غیرصفر هستند، و قالب‌های \f(CW\*(C`[nn{mapfile}]\*(C'\fR، \f(CW\*(C`[nn]\*(C'\fR و \f(CW\*(C`[nn\*(C'\fR مورد استفاده در pdfTeX؛ تشخیص نادرست شماره صفحه باید بسیار کم‌شمارتر باشد) .IP "\(bu" 4 فهرست قابل‌پیکربندی حروف اضافه و حروف ربط .IP "\(bu" 4 امکان نمایش واژه‌های خط‌تیره‌گذاری‌شده در سیاق متن .IP "\(bu" 4 پیشنهادها و آزمایش‌ها توسط Pavel Stříž .PP 3.0 (2012\-02\-01) .IX Subsection "3.0 (2012-02-01)" .IP "\(bu" 4 رفع اشکالی که هنگام منفی بودن مجموع امتیاز منفی (demerits) پاراگراف رخ می‌داد .IP "\(bu" 4 تنظیم \f(CW\*(C`\elooseness\*(C'\fR اکنون در نظر گرفته می‌شود (با تشکر از Karel Horák برای شناسایی این مشکل) .PP 3.1 (2012\-11\-03) .IX Subsection "3.1 (2012-11-03)" .IP "\(bu" 4 رفع نمایش پیوسته‌نگاشت‌های (ligatures) خط‌تیره‌گذاری‌شده (گزارش اشکال توسط Karel Horák) .PP 3.2 (2012\-11\-21) .IX Subsection "3.2 (2012-11-21)" .IP "\(bu" 4 بهبود تعریف نمونه ماکروی \f(CW\*(C`\esetlooseness\*(C'\fR (با تشکر از Karl Berry) .PP 3.3 (2013\-06\-18) .IX Subsection "3.3 (2013-06-18)" .IP "\(bu" 4 اصلاح صفحه راهنما طبق پیشنهاد Eric S. Raymond .PP 3.4 (2015\-10\-18) .IX Subsection "3.4 (2015-10-18)" .IP "\(bu" 4 رفع پردازش گزارش‌های تولیدشده با استفاده از گزینه \f(CW\*(C`\elastlinefit\*(C'\fR در ε\-TeX (گزارش اشکال توسط Karel Horák) .IP "\(bu" 4 رفع مدیریت چندسکویی شکست‌های خط در فایل ورودی .SH "مجوز (LICENSE)" .IX Header "LICENSE" این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (\s-1GNU\s0 General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نگارش ۲ مجوز و چه هر نگارش بعدی آن، دوباره توزیع کرده یا تغییر دهید. .SH "نویسنده (AUTHOR)" .IX Header "AUTHOR" کپی‌رایت (c) Martin Budaj 2000, 2001, 2009, 2012, 2015