نام (NAME)

ltx2unitxt - تبدیل قطعه‌کد منبع LaTeX به متن ساده (یونیکد) یا HTML ساده

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

ltx2unitxt [-c CONFIG] [-o OUTPUT] [--html] [...] [INFILE]...

توضیحات (DESCRIPTION)

منبع LaTeX را در INFILE (یا ورودی استاندارد) با استفاده از نقاط رمزی یونیکد برای اعراب‌ها و سایر نویسه‌های خاص به متن ساده تبدیل می‌کند؛ یا در صورت تمایل، خروجی HTML را با ترجمه‌های ساده برای تغییر قلم و دستورهای url تولید می‌نماید.

توالی‌های رایج اعراب، نویسه‌های خاص و دستورهای ساده نشانه‌گذاری ترجمه می‌شوند، اما هیچ تلاشی برای جامعیت کامل صورت نگرفته است. فرمول‌های ریاضی، جدول‌ها، شکل‌ها، بخش‌بندی‌ها و غیره به هیچ وجه پردازش نمی‌شوند و عمدتاً به همان شکل TeX در خروجی باقی می‌مانند. این ترجمه‌ها معانی استاندارد LaTeX را برای نویسه‌ها و توالی‌های کنترلی در نظر می‌گیرند؛ ماکروهای موجود در ورودی لحاظ نمی‌شوند.

ورودی می‌تواند بخشی از یک متن باشد و نیازی به یک سند کامل نیست، چرا که هدف این اسکریپت رسیدگی به مدخل‌های کتاب‌شناسی و چکیده‌ها بوده است (برای اسکریپت ltx2crossrefxml که بخشی از بسته crossrefware است). از وصله‌ها برای گسترش این اسکریپت استقبال می‌شود. این ابزار از کتابخانه پرل LaTeX::ToUnicode برای تبدیل استفاده می‌کند؛ برای جزئیات به مستندات آن مراجعه کنید.

تبدیل در حال حاضر خط‌به‌خط انجام می‌شود، بنابراین ساختارهای TeX که در چندین خط امتداد یافته‌اند به‌درستی پردازش نمی‌شوند. اگر سودمند واقع شود، ممکن است در آینده تبدیل به صورت پاراگرافی انجام گیرد.

فایل پیکربندی به عنوان یک فایل منبع Perl خوانده می‌شود. این فایل می‌تواند تابعی به نام `LaTeX_ToUnicode_convert_hook()' تعریف کند که در مراحل اولیه فراخوانی خواهد شد؛ مقداری که بازمی‌گرداند (که باید یک رشته باشد) سپس مشمول تبدیل استاندارد خواهد شد.

برای مشاهده مثالی از استفاده از این اسکریپت و کدهای مربوطه، پردازش TUGboat را در نشانی زیر ببینید: https://github.com/TeXUsersGroup/tugboat/tree/trunk/capsules/crossref

گزینه‌ها (OPTIONS)

-c, --config=FILE

خواندن فایل پیکربندی (Perl) برای استفاده از هوک، همان‌طور که در بالا توضیح داده شد

-e, --entities

خروجی دادن موجودیت‌های &#xNNNN; به‌جای نویسه‌های عینی

-g, --german

پشتیبانی از برخی ویژگی‌های بسته german

-h, --html

تولید خروجی ساده HTML به‌جای متن ساده

-o, --output=FILE

نوشتن خروجی در FILE به‌جای خروجی استاندارد (stdout)

-v, --verbose

حالت پرگو (نمایش جزئیات)

-V, --version

نمایش اطلاعات نسخه و خروج

-?, --help

نمایش این راهنما و خروج

گزینه‌ها در صورت عدم ابهام می‌توانند مخفف شوند و با - یا -- آغاز می‌شوند.

منابع توسعه، ردیاب باگ: https://github.com/borisveytsman/bibtexperllibs انتشارها: https://ctan.org/pkg/bibtexperllibs

ltx2unitxt (bibtexperllibs) 0.51 حق نشر (Copyright) 2023 Karl Berry. این یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت همان شرایط خود Perl بازتوزیع کرده یا تغییر دهید.