.TH TEXI2HTML 1 "5 July 2024"
.AT 3
.SH "نام (NAME)"
texi2html \- مبدل Texinfo به HTML
.SH "خلاصه دستور (SYNOPSIS)"
.B texi2html [options] file
.SH "توضیحات (DESCRIPTION)"
.I Texi2html
پروندهٔ Texinfo داده‌شده را به مجموعه‌ای از پرونده‌های HTML تبدیل می‌کند. این برنامه تلاش می‌کند تا
بیشتر دستورات Texinfo را مدیریت کند. همچنین پیوندهای ابرمتنی برای ارجاع‌های متقابل،
پاورقی‌ها و... ایجاد می‌کند.
.PP
.I Texi2html
افزون بر این ممکن است از latex2html برای تولید HTML (کد یا تصاویر) برای برچسب‌های @math
و @iftex استفاده کند (گزینهٔ
.B \-\-l2h
را ببینید).
.PP
.I Texi2html
بسته به محتویات پروندهٔ Texinfo و گزینه‌های انتخاب‌شده، چندین پرونده ایجاد می‌کند (بخش «فایل‌ها» را ببینید).
.PP
پرونده‌های HTML ایجادشده توسط
.I texi2html
به‌طور کلی به TeX نزدیک‌ترند تا به Info. با استفاده از پرونده‌های init (گزینهٔ
.B \-\-init\-file
را ببینید)، می‌توان سبک‌ها یا قالب‌های خروجی دیگر را انتخاب کرد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. موارد
زیر تنها فهرستی ناقص از گزینه‌های موجود است:
.TP 12
.B \-\-help [1|2]
چاپ دستورالعمل‌های استفاده و فهرست کردن مهم‌ترین، همهٔ موارد مرتبط،
یا همهٔ گزینه‌های شناخته‌شدهٔ خط فرمان (از جمله موارد منسوخ)، و خروج.
.TP
.B \-\-split chapter|section|node
تقسیم خروجی به چندین پروندهٔ HTML (یک پرونده به ازای هر فصل/بخش اصلی یا گره).
.TP
.B \-\-ifinfo \-\-iftex \-\-ifxml \-\-ifplaintext \-\-ifhtml
بسط دادن ناحیه‌های @ifinfo، @iftex و @tex، @ifxml و @xml، @ifplaintext،
@ifhtml و @html، و بسط ندادن ناحیه‌های متناظر
@ifnot (پیش‌فرض: ifhtml).
.TP
.B \-\-no\-ifinfo \-\-no\-iftex \-\-no\-ifxml \-\-no\-ifplaintext \-\-no\-html
بسط ندادن ناحیه‌های @ifinfo، @iftex، @ifxml، @ifplaintext و بسط دادن
ناحیه‌های متناظر @ifnot.
.TP
.B \-I \fIdir\fP
افزودن \fIdir\fP به انتهای فهرست دایرکتوری‌های مورد جستجو برای پرونده‌های گنجانده‌شده.
.TP
.B \-P \fIdir\fP
افزودن \fIdir\fP به ابتدای فهرست دایرکتوری‌های مورد جستجو برای پرونده‌های گنجانده‌شده.
.TP
.B \-\-l2h
استفاده از latex2html برای محتوای برچسب‌های @math و @tex. محتوا باید چنان باشد که
هر دو ابزار latex و tex بتوانند آن را به‌درستی تبدیل کنند؛ یعنی نباید ساختارهای
مختص tex به کار روند.
.TP
.B \-\-css\-include \fIfile\fP
استفاده از پروندهٔ شیوه‌نامهٔ \fIfile\fP.
.TP
.B \-\-init\-file \fIfile\fP
بارگذاری پروندهٔ راه‌اندازی \fIfile\fP (همچنین بخش «فایل‌ها» را ببینید).
.TP
.B \-\-document\-language \fIlang\fP
استفاده از \fIlang\fP به عنوان زبان سند.
.TP
.B \-\-macro\-expand \fIfile\fP
خروجی دادن کد منبع بسط‌یافتهٔ ماکرو در \fIfile\fP.
.TP
.B \-\-no\-menu
نشان ندادن منوهای Texinfo؛ این منوها به‌طور پیش‌فرض نشان داده می‌شوند.
.TP
.B \-\-no\-number
شماره‌گذاری نکردن بخش‌ها.
.TP
.B \-\-use\-nodes
استفاده از گره‌ها برای بخش‌بندی.
.TP
.B \-\-prefix
استفاده به عنوان پیشوند پرونده‌های خروجی، به‌جای basename.
.TP
.B \-\-node\-files
تولید یک پرونده به ازای هر گره برای ارجاع‌های متقابل.
.TP
.B \-\-l2h\-l2h \fIprog\fP  
استفاده از \fIprog\fP به عنوان برنامهٔ latex2html (پیش‌فرض: \fIlatex2html\fP).
برنامه باید قابل اجرا باشد.
.TP
.B \-\-l2h\-init \fIfile\fP  
استفاده از \fIfile\fP به عنوان پروندهٔ پیکربندی اولیهٔ latex2html. از \fIfile\fP باید برای تعیین چگونگی مدیریت عبارات و فرمول‌های ریاضی توسط latex2html استفاده شود.
.TP
.B \-\-l2h\-tmp \fIdir\fP
استفاده از \fIdir\fP به عنوان دایرکتوری موقت برای latex2html. این دایرکتوری (یا مسیر آن)
نباید حاوی نقطه (یعنی ".") باشد.
.TP 
.B \-\-l2h\-clean
پاک‌سازی همهٔ پرونده‌های میانی تولیدشده توسط latex2html (از کش شدن جلوگیری می‌کند!).
.TP 
.B \-\-l2h\-skip
عدم اجرای واقعی latex2html. در عوض از پرونده‌های (نگه‌داشته‌شدهٔ) اجراهای قبلی استفاده می‌شود.
.TP
.B \-\-verbose
ارائهٔ خروجی با جزئیات کامل.
.TP
.B \-\-version
چاپ نسخه و خروج.
.PP
.SH "فایل‌ها (FILES)"
گزینه‌های راه‌اندازی ابتدا از /usr/share/texi2html/Config خوانده می‌شوند
(مکان دقیق با گزینهٔ
.RI --datadir=dir
در اسکریپت پیکربندی configure قابل تغییر است)، سپس از /usr/etc/texi2html/Config
(مکان دقیق با گزینهٔ
.RI --sysconfdir=dir
در اسکریپت پیکربندی configure قابل تغییر است)، سپس از ./Config، از
$HOME/.texi2html/Config، و از هر یک از گزینه‌های خط فرمان از جمله
گزینه‌های \-\-init\-file؛ به‌طوری که تنظیمات بعدی جایگزین تنظیمات قبلی می‌شوند.
.P
به‌طور پیش‌فرض
.I texi2html
پرونده‌های زیر را ایجاد می‌کند (foo نام پروندهٔ Texinfo است):
.TP 16
.B foo_toc.html
فهرست مطالب (در صورت وجود @contents).
.TP
.B foo.html
محتویات سند یا عنصر ریشه (Top).
.TP
.B foo_fot.html
پاورقی‌ها (در صورت وجود).
.TP
.B foo_abt.html
بخش راهنما.
.TP
.B foo_l2h_img*
تصاویر تولیدشده توسط latex2html (در صورت وجود).
.PP
هنگامی که همراه با گزینهٔ
.B \-\-split
به کار رود، چندین پرونده ایجاد می‌کند (یک پرونده به ازای هر فصل یا گره)، با نام
.B foo_n.html
(که n شاخص فصل یا گره است)، و پروندهٔ
.B foo.html
شامل عنصر ریشه (Top) خواهد بود.
.PP
در غیر این صورت فقط یک پرونده ایجاد می‌کند:
.B foo.html
.SH "نسخه (VERSION)"
این نسخهٔ 5.0 از \fItexi2html\fP در ۵ ژوئیه ۲۰۲۴ است.
.SH "نویسنده (AUTHOR)"
برنامهٔ Texi2html در ابتدا توسط Lionel Cons، از CERN IT/DIS/OSE،
به نشانی Lionel.Cons@cern.ch نوشته شد. با گذشت زمان، افراد بسیار دیگری در سراسر
شبکه در توسعهٔ این برنامه مشارکت کردند. این برنامه توسط Olaf Bachmann،
به نشانی obachman@mathematik.uni-kl.de نگهداری می‌شد و اکنون توسط Derek Price نگهداری می‌شود.
.SH "در دسترس بودن (AVAILABILITY)"
جدیدترین نسخهٔ این برنامه و همچنین پشتیبانی در قالب فهرست‌های
پستی به همراه بایگانی‌ها، ردیابی اشکالات، مستندات و سایر ابزارها را می‌توان در این نشانی یافت:
	 http://www.nongnu.org/texi2html
.SH "حق نشر (COPYRIGHT)"
Copyright \(co 1999-2005  Patrice Dumas <pertusus@free.fr>,
                        Derek Price <derek@ximbiot.com>,
                        Adrian Aichner <adrian@xemacs.org>,
                      & others.

هیچ ضمانتی وجود ندارد. شما می‌توانید این نرم‌افزار را
تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) بازتوزیع کنید.
برای اطلاعات بیشتر در مورد این موارد، پرونده‌ای به نام COPYING را ببینید.
.SH "همچنین ببینید (SEE ALSO)"
قالب مستندات GNU Texinfo
.br
http://texinfo.org
.br
World Wide Web (WWW)،
HyperText Markup Language (HTML)
.br
http://www.w3.org
.br
LaTeX2HTML
.br
http://www-dsed.llnl.gov/files/programs/unix/latex2html
.SH "اشکالات (BUGS)"
این صفحهٔ راهنما اغلب قدیمی است. راهنمای info باید به‌روزتر باشد.
.ex