نام (NAME)

twill, twill-refsort - ترجمه برنامه‌نویسی ادیبانه WEB به TeX همراه با ریزنمایه‌ها

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

twill [-x] webfile[.web] [{changefile[.ch]|-} [outfile[.tex]]]

twill-refsort < reffile.ref > sreffile.sref

توضیحات (DESCRIPTION)

برنامه twill برای ساخت یک فایل TeX جهت مشاهده یک برنامه ادیبانه نوشته‌شده در WEB به کار می‌رود. نام فایل خروجی TeX با افزودن .tex به نام ریشه فایل تشکیل می‌شود.

twill مانند weave(1) است، اما علاوه بر آن، اطلاعات ارجاع متقابل را در قالب «ریزنمایه‌ها» برای هر دو صفحه روبه‌رو، جهت شناسه‌های استفاده‌شده در آن دو صفحه، و یک «نمایه اصلی» در انتها که به طور خودکار گردآوری می‌شود، ارائه می‌دهد.

شما باید twill را دو بار اجرا کنید؛ یک بار برای راه‌اندازی اولیه و بار دیگر برای دریافت نتایج مناسب و دقیق. علاوه بر این، باید خروجی را دو بار با TeX پردازش کنید.

برای یک برنامه foo.web، پس از نخستین اجرای tex foo خروجی حاصل شبیه به صفحات نهایی خواهد بود، با این تفاوت که مدخل‌های ریزنمایه‌ها به ترتیب الفبایی نخواهند بود. اولین اجرا یک فایل کمکی با نام foo.ref تولید می‌کند.
اجرای دستور twill-refsort <foo.ref >foo.sref و سپس یک اجرای دیگر tex foo خروجی مرتب‌شده بر اساس الفبا را تولید خواهد کرد.

گزینه‌ها (OPTIONS)

برای جزئیات تجزیه خط فرمان به tex(1) و برای گزینه‌های پذیرفته‌شده به weave(1) مراجعه کنید.

محیط (ENVIRONMENT)

متغیر محیطی WEBINPUTS برای جستجوی فایل‌های ورودی استفاده می‌شود؛ اگر تنظیم نشده باشد، از پیش‌فرض سیستم استفاده خواهد شد. برای جزئیات جستجو، راهنمای Kpathsea را در https://tug.org/kpathsea ببینید.

گزارش باگ‌ها (BUGS)

فایل فهرست مطالب، CONTENTS.tex، تولید می‌شود اما نادیده گرفته خواهد شد (مگر اینکه ماکروهای موجود در twimac-web.tex بازتعریف شوند).

فایل‌ها (FILES)

$TEXMFMAIN/tex/plain/cweb/cwebbin/twimac-web.tex

ماکروهای TeX که توسط خروجی twill استفاده می‌شوند.

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

tangle(1) برای مراجع، نویسندگان، و سایر اطلاعات کلی درباره WEB.

Donald E. Knuth, Mini-indexes for literate programs, Software-Concepts and Tools, 15(1):2-11, 1994.
https://arxiv.org/abs/cs/9401102

CTWILL program source, section 287:
https://mirror.ctan.org/info/knuth-pdf/cweb/ctwill.pdf
(همه ویژگی‌های شرح‌داده‌شده در آنجا در سیستم قدیمی‌تر twill در دسترس نیستند، اما کلیت موضوع را دریافت خواهید کرد.)

فهرست بحث همگانی و گزارش باگ‌ها: https://lists.tug.org/tex-k