.TH WEAVE 1 "2 February 2026 "Web2C 2026"
.\"=====================================================================
.if n .ds TX TeX
.if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
.\"=====================================================================
.SH "نام (NAME)"
weave \- تبدیل برنامه‌نویسی ادیبانه WEB به TeX
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]weave\f[R] [\f[B]-p\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]]]]
.\"=====================================================================
.SH "توضیحات (DESCRIPTION)"
برنامه
.B weave
یک فایل \*(TX برای مشاهده برنامه نوشته‌شده در WEB به شیوه برنامه‌نویسی ادیبانه (literate programming) ایجاد می‌کند. این برنامه به جزئیات تایپوگرافی مانند چینش صفحه و استفاده از تورفتگی، حروف کج (ایتالیک)، حروف پررنگ (بُلد) و غیره توجه مناسبی دارد و اطلاعات نمایه‌سازی متقابل گسترده‌ای را که به‌طور خودکار گردآوری می‌کند، فراهم می‌سازد.
.PP
نام فایل خروجی \*(TX از افزودن
.B .tex
به ریشه نام فایل WEB یا از طریق آرگومان سوم تعیین می‌شود. در این حالت می‌توانید برای یک فایل تغییرات خالی، '-' را مشخص کنید. این آرگومان‌های خط فرمان غیرگزینه‌ای به همان شیوه
.BR tangle (1)
مدیریت می‌شوند.
.PP
چندین ماکرو وجود دارد که احتمالاً باید توسط برنامه‌نویس در ابتدای فایل WEB بازتعریف شوند. مناسب است که
.I \etitle
روی نام برنامه تنظیم شود.
برای خروجی دادن تنها از آن پودمان‌هایی که تغییر یافته‌اند، می‌توان از
.IR \elet\emaybe=\eiffalse
معمولاً به عنوان اولین تغییر در فایل تغییرات استفاده کرد.
.\"=====================================================================
.SH "گزینه‌ها (OPTIONS)"
برای جزئیات تجزیه خط فرمان،
.BR tex (1)
را ببینید.
.TP
.B -p
دستور استفاده از \fI\einput pwebmac.tex\fP را می‌دهد؛ گونه‌ای از فایل پیش‌فرض
\fIwebmac.tex\fP
که برای خروجی PDF مناسب‌تر است.
.TP
.B -x
دستور حذف صفحات نمایه، فهرست نام پودمان‌ها و فهرست مطالب را می‌دهد.
(با این وجود، هنگام پردازش فایل \*(TX، همچنان یک فایل
.I CONTENTS.tex
نوشته خواهد شد، مگر اینکه برخی از ماکروها در
.I webmac.tex
بازتعریف شوند.)
.PP
گزینه‌های استاندارد
.B -help
و
.B -version
نیز پشتیبانی می‌شوند.
.\"=====================================================================
.SH "محیط (ENVIRONMENT)"
این برنامه‌ها برای یافتن فایل‌های ورودی از متغیر محیطی WEBINPUTS استفاده می‌کنند. اگر این متغیر مقداردهی نشده باشد، از پیش‌فرض سیستم استفاده می‌شود. برای جزئیات جستجو، راهنمای Kpathsea را در https://tug.org/kpathsea ببینید.
.\"=====================================================================
.SH "گزارش باگ‌ها (BUGS)"
فهرست مطالب در انتهای خروجی ظاهر می‌شود.
.\"=====================================================================
.SH "فایل‌ها (FILES)"
.TP
.I $TEXMFMAIN/tex/plain/knuth-lib/webmac.tex
ماکروهای \*(TX مورد استفاده توسط خروجی
.BR weave .
.TP
.I $TEXMFMAIN/tex/plain/pwebmac/pwebmac.tex
ماکروهای جایگزین \*(TX مورد استفاده برای خروجی PDF.
.TP
.I CONTENTS.tex
فایل موقت ایجاد شده توسط \fBweave\fP برای فهرست مطالب.
.\"=====================================================================
.SH "همچنین ببینید (SEE ALSO)"
برای مراجع، نویسندگان و سایر اطلاعات،
.BR tangle (1)
را ببینید.
.PP
فهرست گفتگوی عمومی و گزارش باگ‌ها: https://lists.tug.org/tex-k