نام (NAME)

weave - تبدیل برنامه‌نویسی ادیبانه WEB به TeX

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

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

توضیحات (DESCRIPTION)

برنامه weave یک فایل TeX برای مشاهده برنامه نوشته‌شده در WEB به شیوه برنامه‌نویسی ادیبانه (literate programming) ایجاد می‌کند. این برنامه به جزئیات تایپوگرافی مانند چینش صفحه و استفاده از تورفتگی، حروف کج (ایتالیک)، حروف پررنگ (بُلد) و غیره توجه مناسبی دارد و اطلاعات نمایه‌سازی متقابل گسترده‌ای را که به‌طور خودکار گردآوری می‌کند، فراهم می‌سازد.

نام فایل خروجی TeX از افزودن .tex به ریشه نام فایل WEB یا از طریق آرگومان سوم تعیین می‌شود. در این حالت می‌توانید برای یک فایل تغییرات خالی، '-' را مشخص کنید. این آرگومان‌های خط فرمان غیرگزینه‌ای به همان شیوه tangle(1) مدیریت می‌شوند.

چندین ماکرو وجود دارد که احتمالاً باید توسط برنامه‌نویس در ابتدای فایل WEB بازتعریف شوند. مناسب است که \title روی نام برنامه تنظیم شود. برای خروجی دادن تنها از آن پودمان‌هایی که تغییر یافته‌اند، می‌توان از \let\maybe=\iffalse معمولاً به عنوان اولین تغییر در فایل تغییرات استفاده کرد.

گزینه‌ها (OPTIONS)

برای جزئیات تجزیه خط فرمان، tex(1) را ببینید.

-p: دستور استفاده از \input pwebmac.tex را می‌دهد؛ گونه‌ای از فایل پیش‌فرض webmac.tex که برای خروجی PDF مناسب‌تر است.
-x: دستور حذف صفحات نمایه، فهرست نام پودمان‌ها و فهرست مطالب را می‌دهد. (با این وجود، هنگام پردازش فایل TeX، همچنان یک فایل CONTENTS.tex نوشته خواهد شد، مگر اینکه برخی از ماکروها در webmac.tex بازتعریف شوند.)

گزینه‌های استاندارد -help و -version نیز پشتیبانی می‌شوند.

محیط (ENVIRONMENT)

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

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

فهرست مطالب در انتهای خروجی ظاهر می‌شود.

فایل‌ها (FILES)

$TEXMFMAIN/tex/plain/knuth-lib/webmac.tex: ماکروهای TeX مورد استفاده توسط خروجی weave.
$TEXMFMAIN/tex/plain/pwebmac/pwebmac.tex: ماکروهای جایگزین TeX مورد استفاده برای خروجی PDF.
CONTENTS.tex: فایل موقت ایجاد شده توسط weave برای فهرست مطالب.

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

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

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