.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH LTX2UNITXT "1" "July 2025" "ltx2unitxt  " "دستورهای کاربری"
.SH "نام (NAME)"
ltx2unitxt \- تبدیل قطعه‌کد منبع LaTeX به متن ساده (یونیکد) یا HTML ساده
.SH "خلاصه دستور (SYNOPSIS)"
.B ltx2unitxt
[\fI\,-c CONFIG\/\fR] [\fI\,-o OUTPUT\/\fR] [\fI\,--html\/\fR] [...] [\fI\,INFILE\/\fR]...
.SH "توضیحات (DESCRIPTION)"
منبع LaTeX را در INFILE (یا ورودی استاندارد) با استفاده از نقاط رمزی یونیکد برای اعراب‌ها و سایر نویسه‌های خاص به متن ساده تبدیل می‌کند؛ یا در صورت تمایل، خروجی HTML را با ترجمه‌های ساده برای تغییر قلم و دستورهای url تولید می‌نماید.
.PP
توالی‌های رایج اعراب، نویسه‌های خاص و دستورهای ساده نشانه‌گذاری ترجمه می‌شوند، اما هیچ تلاشی برای جامعیت کامل صورت نگرفته است. فرمول‌های ریاضی، جدول‌ها، شکل‌ها، بخش‌بندی‌ها و غیره به هیچ وجه پردازش نمی‌شوند و عمدتاً به همان شکل TeX در خروجی باقی می‌مانند. این ترجمه‌ها معانی استاندارد LaTeX را برای نویسه‌ها و توالی‌های کنترلی در نظر می‌گیرند؛ ماکروهای موجود در ورودی لحاظ نمی‌شوند.
.PP
ورودی می‌تواند بخشی از یک متن باشد و نیازی به یک سند کامل نیست، چرا که هدف این اسکریپت رسیدگی به مدخل‌های کتاب‌شناسی و چکیده‌ها بوده است (برای اسکریپت ltx2crossrefxml که بخشی از بسته crossrefware است). از وصله‌ها برای گسترش این اسکریپت استقبال می‌شود. این ابزار از کتابخانه پرل LaTeX::ToUnicode برای تبدیل استفاده می‌کند؛ برای جزئیات به مستندات آن مراجعه کنید.
.PP
تبدیل در حال حاضر خط‌به‌خط انجام می‌شود، بنابراین ساختارهای TeX که در چندین خط امتداد یافته‌اند به‌درستی پردازش نمی‌شوند. اگر سودمند واقع شود، ممکن است در آینده تبدیل به صورت پاراگرافی انجام گیرد.
.PP
فایل پیکربندی به عنوان یک فایل منبع Perl خوانده می‌شود. این فایل می‌تواند تابعی به نام `LaTeX_ToUnicode_convert_hook()' تعریف کند که در مراحل اولیه فراخوانی خواهد شد؛ مقداری که بازمی‌گرداند (که باید یک رشته باشد) سپس مشمول تبدیل استاندارد خواهد شد.
.PP
برای مشاهده مثالی از استفاده از این اسکریپت و کدهای مربوطه، پردازش TUGboat را در نشانی زیر ببینید:
https://github.com/TeXUsersGroup/tugboat/tree/trunk/capsules/crossref
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-c\fR, \fB\-\-config\fR=\fI\,FILE\/\fR
خواندن فایل پیکربندی (Perl) برای استفاده از هوک، همان‌طور که در بالا توضیح داده شد
.TP
\fB\-e\fR, \fB\-\-entities\fR
خروجی دادن موجودیت‌های &#xNNNN; به‌جای نویسه‌های عینی
.TP
\fB\-g\fR, \fB\-\-german\fR
پشتیبانی از برخی ویژگی‌های بسته german
.TP
\fB\-h\fR, \fB\-\-html\fR
تولید خروجی ساده HTML به‌جای متن ساده
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
نوشتن خروجی در FILE به‌جای خروجی استاندارد (stdout)
.TP
\fB\-v\fR, \fB\-\-verbose\fR
حالت پرگو (نمایش جزئیات)
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.TP
\-?, \fB\-\-help\fR
نمایش این راهنما و خروج
.PP
گزینه‌ها در صورت عدم ابهام می‌توانند مخفف شوند و با \- یا \fB\-\-\fR آغاز می‌شوند.
.PP
منابع توسعه، ردیاب باگ: https://github.com/borisveytsman/bibtexperllibs
انتشارها: https://ctan.org/pkg/bibtexperllibs
.PP
ltx2unitxt (bibtexperllibs) 0.51
حق نشر (Copyright) 2023 Karl Berry.
این یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت همان شرایط خود Perl بازتوزیع کرده یا تغییر دهید.