.TH TWILL 1 "3 February 2026" "Web2C 2026"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
.if n .ds TX TeX
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.\"=====================================================================
.SH "نام (NAME)"
twill, twill-refsort \- ترجمه برنامه‌نویسی ادیبانه WEB به TeX همراه با ریزنمایه‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[B]twill\f[R] [\f[B]-x\f[R]]
\f[I]webfile\f[R][\f[B].web\f[R]]
[{\f[I]changefile\f[R][\f[B].ch\f[R]]|\f[B]-\f[R]}
[\f[I]outfile\f[R][\f[B].tex\f[R]]]]
.PD 0
.PP
\f[B]twill-refsort\f[R] <
\f[I]reffile\f[B].ref\f[R] >
\f[I]sreffile\f[B].sref\f[R]
.PD
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
برنامه
.B twill
برای ساخت یک فایل \*(TX جهت مشاهده یک برنامه ادیبانه نوشته‌شده در WEB به کار می‌رود. نام فایل خروجی \*(TX با افزودن
.I .tex
به نام ریشه فایل \*(WB تشکیل می‌شود.
.PP
\fBtwill\fP مانند
.BR weave (1)
است، اما علاوه بر آن، اطلاعات ارجاع متقابل را در قالب «ریزنمایه‌ها» برای هر دو صفحه روبه‌رو، جهت شناسه‌های استفاده‌شده در آن دو صفحه، و یک «نمایه اصلی» در انتها که به طور خودکار گردآوری می‌شود، ارائه می‌دهد.
.PP
شما باید
.B twill
را دو بار اجرا کنید؛ یک بار برای راه‌اندازی اولیه و بار دیگر برای دریافت نتایج مناسب و دقیق. علاوه بر این، باید خروجی را دو بار با \*(TX پردازش کنید.
.PP
برای یک برنامه \fIfoo.web\fP، پس از نخستین اجرای
.I tex foo
خروجی حاصل شبیه به صفحات نهایی خواهد بود، با این تفاوت که مدخل‌های ریزنمایه‌ها به ترتیب الفبایی نخواهند بود.
اولین اجرا یک فایل کمکی با نام
.IR foo.ref
تولید می‌کند.
.br
اجرای دستور
.I twill-refsort <foo.ref >foo.sref
و سپس یک اجرای دیگر
.I tex foo
خروجی مرتب‌شده بر اساس الفبا را تولید خواهد کرد.
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
برای جزئیات تجزیه خط فرمان به
.BR tex (1)
و برای گزینه‌های پذیرفته‌شده به
.BR weave (1)
مراجعه کنید.
.\"=====================================================================
.SH "محیط (ENVIRONMENT)"
متغیر محیطی WEBINPUTS برای جستجوی فایل‌های ورودی استفاده می‌شود؛ اگر تنظیم نشده باشد، از پیش‌فرض سیستم استفاده خواهد شد. برای جزئیات جستجو، راهنمای Kpathsea را در https://tug.org/kpathsea ببینید.
.\"=====================================================================
.SH "گزارش باگ‌ها (BUGS)"
فایل فهرست مطالب، \fICONTENTS.tex\fP، تولید می‌شود اما نادیده گرفته خواهد شد (مگر اینکه ماکروهای موجود در \fItwimac-web.tex\fP بازتعریف شوند).
.\"=====================================================================
.SH "فایل‌ها (FILES)"
.TP \w'@@'u+2n
.I $TEXMFMAIN/tex/plain/cweb/cwebbin/twimac-web.tex
ماکروهای \*(TX که توسط خروجی
.B twill
استفاده می‌شوند.
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
.BR tangle (1)
برای مراجع، نویسندگان، و سایر اطلاعات کلی درباره WEB.
.PP
Donald E. Knuth, Mini-indexes for literate programs,
Software\-Concepts and Tools, 15(1):2-11, 1994.
.br
https://arxiv.org/abs/cs/9401102
.PP
CTWILL program source, section 287:
.br
https://mirror.ctan.org/info/knuth-pdf/cweb/ctwill.pdf
.br
(همه ویژگی‌های شرح‌داده‌شده در آنجا در سیستم قدیمی‌تر
\fBtwill\fP
در دسترس نیستند، اما کلیت موضوع را دریافت خواهید کرد.)
.PP
فهرست بحث همگانی و گزارش باگ‌ها: https://lists.tug.org/tex-k