نام (NAME)

texi2html - مبدل Texinfo به HTML

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

texi2html [options] file

توضیحات (DESCRIPTION)

Texi2html پروندهٔ Texinfo داده‌شده را به مجموعه‌ای از پرونده‌های HTML تبدیل می‌کند. این برنامه تلاش می‌کند تا بیشتر دستورات Texinfo را مدیریت کند. همچنین پیوندهای ابرمتنی برای ارجاع‌های متقابل، پاورقی‌ها و... ایجاد می‌کند.

Texi2html افزون بر این ممکن است از latex2html برای تولید HTML (کد یا تصاویر) برای برچسب‌های @math و @iftex استفاده کند (گزینهٔ --l2h را ببینید).

Texi2html بسته به محتویات پروندهٔ Texinfo و گزینه‌های انتخاب‌شده، چندین پرونده ایجاد می‌کند (بخش «فایل‌ها» را ببینید).

پرونده‌های HTML ایجادشده توسط texi2html به‌طور کلی به TeX نزدیک‌ترند تا به Info. با استفاده از پرونده‌های init (گزینهٔ --init-file را ببینید)، می‌توان سبک‌ها یا قالب‌های خروجی دیگر را انتخاب کرد.

گزینه‌ها (OPTIONS)

گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. موارد زیر تنها فهرستی ناقص از گزینه‌های موجود است:

--help [1|2]: چاپ دستورالعمل‌های استفاده و فهرست کردن مهم‌ترین، همهٔ موارد مرتبط، یا همهٔ گزینه‌های شناخته‌شدهٔ خط فرمان (از جمله موارد منسوخ)، و خروج.
--split chapter|section|node: تقسیم خروجی به چندین پروندهٔ HTML (یک پرونده به ازای هر فصل/بخش اصلی یا گره).
--ifinfo --iftex --ifxml --ifplaintext --ifhtml: بسط دادن ناحیه‌های @ifinfo، @iftex و @tex، @ifxml و @xml، @ifplaintext، @ifhtml و @html، و بسط ندادن ناحیه‌های متناظر @ifnot (پیش‌فرض: ifhtml).
--no-ifinfo --no-iftex --no-ifxml --no-ifplaintext --no-html: بسط ندادن ناحیه‌های @ifinfo، @iftex، @ifxml، @ifplaintext و بسط دادن ناحیه‌های متناظر @ifnot.
-I dir: افزودن dir به انتهای فهرست دایرکتوری‌های مورد جستجو برای پرونده‌های گنجانده‌شده.
-P dir: افزودن dir به ابتدای فهرست دایرکتوری‌های مورد جستجو برای پرونده‌های گنجانده‌شده.
--l2h: استفاده از latex2html برای محتوای برچسب‌های @math و @tex. محتوا باید چنان باشد که هر دو ابزار latex و tex بتوانند آن را به‌درستی تبدیل کنند؛ یعنی نباید ساختارهای مختص tex به کار روند.
--css-include file: استفاده از پروندهٔ شیوه‌نامهٔ file.
--init-file file: بارگذاری پروندهٔ راه‌اندازی file (همچنین بخش «فایل‌ها» را ببینید).
--document-language lang: استفاده از lang به عنوان زبان سند.
--macro-expand file: خروجی دادن کد منبع بسط‌یافتهٔ ماکرو در file.
--no-menu: نشان ندادن منوهای Texinfo؛ این منوها به‌طور پیش‌فرض نشان داده می‌شوند.
--no-number: شماره‌گذاری نکردن بخش‌ها.
--use-nodes: استفاده از گره‌ها برای بخش‌بندی.
--prefix: استفاده به عنوان پیشوند پرونده‌های خروجی، به‌جای basename.
--node-files: تولید یک پرونده به ازای هر گره برای ارجاع‌های متقابل.
--l2h-l2h prog: استفاده از prog به عنوان برنامهٔ latex2html (پیش‌فرض: latex2html). برنامه باید قابل اجرا باشد.
--l2h-init file: استفاده از file به عنوان پروندهٔ پیکربندی اولیهٔ latex2html. از file باید برای تعیین چگونگی مدیریت عبارات و فرمول‌های ریاضی توسط latex2html استفاده شود.
--l2h-tmp dir: استفاده از dir به عنوان دایرکتوری موقت برای latex2html. این دایرکتوری (یا مسیر آن) نباید حاوی نقطه (یعنی ".") باشد.
--l2h-clean: پاک‌سازی همهٔ پرونده‌های میانی تولیدشده توسط latex2html (از کش شدن جلوگیری می‌کند!).
--l2h-skip: عدم اجرای واقعی latex2html. در عوض از پرونده‌های (نگه‌داشته‌شدهٔ) اجراهای قبلی استفاده می‌شود.
--verbose: ارائهٔ خروجی با جزئیات کامل.
--version: چاپ نسخه و خروج.

فایل‌ها (FILES)

گزینه‌های راه‌اندازی ابتدا از /usr/share/texi2html/Config خوانده می‌شوند (مکان دقیق با گزینهٔ --datadir=dir در اسکریپت پیکربندی configure قابل تغییر است)، سپس از /usr/etc/texi2html/Config (مکان دقیق با گزینهٔ --sysconfdir=dir در اسکریپت پیکربندی configure قابل تغییر است)، سپس از ./Config، از $HOME/.texi2html/Config، و از هر یک از گزینه‌های خط فرمان از جمله گزینه‌های --init-file؛ به‌طوری که تنظیمات بعدی جایگزین تنظیمات قبلی می‌شوند.

به‌طور پیش‌فرض texi2html پرونده‌های زیر را ایجاد می‌کند (foo نام پروندهٔ Texinfo است):

foo_toc.html: فهرست مطالب (در صورت وجود @contents).
foo.html: محتویات سند یا عنصر ریشه (Top).
foo_fot.html: پاورقی‌ها (در صورت وجود).
foo_abt.html: بخش راهنما.
foo_l2h_img*: تصاویر تولیدشده توسط latex2html (در صورت وجود).

هنگامی که همراه با گزینهٔ --split به کار رود، چندین پرونده ایجاد می‌کند (یک پرونده به ازای هر فصل یا گره)، با نام foo_n.html (که n شاخص فصل یا گره است)، و پروندهٔ foo.html شامل عنصر ریشه (Top) خواهد بود.

در غیر این صورت فقط یک پرونده ایجاد می‌کند: foo.html

نسخه (VERSION)

این نسخهٔ 5.0 از texi2html در ۵ ژوئیه ۲۰۲۴ است.

نویسنده (AUTHOR)

برنامهٔ Texi2html در ابتدا توسط Lionel Cons، از CERN IT/DIS/OSE، به نشانی Lionel.Cons@cern.ch نوشته شد. با گذشت زمان، افراد بسیار دیگری در سراسر شبکه در توسعهٔ این برنامه مشارکت کردند. این برنامه توسط Olaf Bachmann، به نشانی obachman@mathematik.uni-kl.de نگهداری می‌شد و اکنون توسط Derek Price نگهداری می‌شود.

در دسترس بودن (AVAILABILITY)

جدیدترین نسخهٔ این برنامه و همچنین پشتیبانی در قالب فهرست‌های پستی به همراه بایگانی‌ها، ردیابی اشکالات، مستندات و سایر ابزارها را می‌توان در این نشانی یافت: http://www.nongnu.org/texi2html

حق نشر (COPYRIGHT)

هیچ ضمانتی وجود ندارد. شما می‌توانید این نرم‌افزار را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) بازتوزیع کنید. برای اطلاعات بیشتر در مورد این موارد، پرونده‌ای به نام COPYING را ببینید.

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

قالب مستندات GNU Texinfo
http://texinfo.org
World Wide Web (WWW)، HyperText Markup Language (HTML)
http://www.w3.org
LaTeX2HTML
http://www-dsed.llnl.gov/files/programs/unix/latex2html

اشکالات (BUGS)

این صفحهٔ راهنما اغلب قدیمی است. راهنمای info باید به‌روزتر باشد.