ltximg(1) راهنمای دستورهای عمومی ltximg(1)

ltximg - تبدیل محیط‌های LaTeX به تصویر و فایل‌های مستقل (standalone)

ltximg [<options>] [--] <filename>.<tex|ltx>

دستور ltximg فرآیند استخراج و تبدیل محیط‌ها از فایل LaTeX به قالب‌های تصویری و فایل‌های standalone را با استفاده از ghostscript و poppler-utils خودکارسازی می‌کند. این ابزار فایلی تنها با محیط‌های استخراج‌شده، و فایلی دیگر شامل تمامی محیط‌های استخراج‌شده که به "\includegraphics" تبدیل شده‌اند تولید می‌کند.

به‌طور پیش‌فرض، محیط‌های استخراج‌شده عبارتند از:

preview pspicture tikzpicture pgfpicture psgraph postscript PSTexample

گزینه‌هایی که مقدار می‌پذیرند نیازمند یک فاصله (space) یا "=" بین گزینه و مقدار هستند. گزینه‌های کوتاه را می‌توان با هم ترکیب کرد، و اگر آخرین گزینه فهرستی جداشده با کاما دریافت کند، به "--" در انتهای آن نیاز است. مسیرهای نسبی یا مطلق برای دایرکتوری‌ها و فایل‌ها پشتیبانی نمی‌شوند.

در صورت استفاده بدون [<options>]، محیط‌های استخراج‌شده به قالب تصویری pdf تبدیل شده و با استفاده از "pdflatex" و بستهٔ preview در دایرکتوری "./images" ذخیره می‌شوند.

گزینه‌های عمومی اسکریپت:

نمایش راهنمای خط فرمان و خروج.
نمایش نسخهٔ کنونی و خروج.
نمایش اطلاعات کامل و باجزئیات (حالت پرگویی).
نوشتن فایل ".log" شامل اطلاعات اشکال‌زدایی (debug).
ایجاد فایل‌های ".tif" با استفاده از ghostscript.
ایجاد فایل‌های ".bmp" با استفاده از ghostscript.
ایجاد فایل‌های ".jpg" با استفاده از ghostscript.
ایجاد فایل‌های ".png" با استفاده از ghostscript.
ایجاد فایل‌های ".eps" با استفاده از pdftops.
ایجاد فایل‌های ".svg" با استفاده از pdftocairo.
ایجاد فایل‌های ".ppm" با استفاده از pdftoppm.
تبدیل تصاویر به مقیاس خاکستری با استفاده از ghostscript.
دریافت "\psset" و "\tikzset" برای استخراج.
ایجاد فایل‌های تصویری بدون بستهٔ preview.
تعیین تعداد دفعات اجرای کامپایلر روی فایل ورودی (input) برای استخراج محیط (پیش‌فرض: 1).
وضوح تصویر بر حسب نقطه در اینچ (DPI) برای تصاویر (پیش‌فرض: 150).
تعیین حاشیه‌ها بر حسب bp برای pdfcrop (پیش‌فرض: 0).
ایجاد فایل خروجی (output).
تعیین نام دایرکتوری برای ذخیرهٔ تصاویر و فایل‌ها (پیش‌فرض: images).
تعیین پیشوند (prefix) اضافه‌شونده به نام هر یک از فایل‌های تولیدشده (پیش‌فرض: fig).
افزودن "\macroname" به جستجوی verbatim درون‌خطی (پیش‌فرض: myverb).
حذف بلوک‌های متنی مشخص در فایل خروجی (output) (پیش‌فرض: doc).
فشرده‌سازی فایل‌های تولیدشده در قالب ".zip".
فشرده‌سازی فایل‌های تولیدشده در قالب ".tar.gz".
ایجاد فایل‌ها تنها با کد محیط‌ها.
ایجاد فایل‌های مستقل (standalone) برای محیط‌ها.
فعال‌سازی "\write18{SHELL COMMAND}".
استفاده از "latex>dvips>ps2pdf" برای کامپایلر ورودی (input) و "pdflatex" برای کامپایلر خروجی (output).
استفاده از "latex>dvips>ps2pdf" برای کامپایلر ورودی (input) و "latex>dvips>ps2pdf" برای کامپایلر خروجی (output).
استفاده از "dvilualatex>dvips>ps2pdf" برای کامپایلر ورودی (input) و "lualatex" برای کامپایلر خروجی (output).
استفاده از "latex>dvipdfmx" برای کامپایلر ورودی (input) و "latex>dvipdfmx" برای کامپایلر خروجی (output).
استفاده از "xelatex" برای کامپایلر ورودی (input) و خروجی (output).
استفاده از "lualatex" برای کامپایلر ورودی (input) و خروجی (output).
استفاده از "arara" برای کامپایلر ورودی (input) و خروجی (output).
استفاده از "latexmk" برای کامپایل فایل خروجی (output).
اجرای اسکریپت بدون ساخت فایل‌های تصویری.
عدم ساخت فایل‌های تصویری ".pdf".
عدم اجرای pdfcrop.
افزودن محیط‌های جدید برای استخراج.
صرف‌نظر کردن از استخراج برخی محیط‌های پیش‌فرض.
افزودن محیط‌های verbatim جدید.
افزودن محیط‌های verbatim write جدید.
حذف محیط‌ها در فایل خروجی (output).

ltximg --latex -e -p --subenv -o test-out.ltx test-in.ltx

ایجاد دایرکتوری "./images" (در صورت عدم وجود) شامل تمامی محیط‌های استخراج‌شدهٔ تبدیل‌شده به فایل‌های ".pdf"، ".eps"، ".png" و standalone، یک فایل test-in-fig-all.ltx با تمام محیط‌های استخراج‌شده و فایل test-out.ltx با تمام محیط‌های تبدیل‌شده به "\includegraphics" با استفاده از "latex>dvips>ps2pdf" و بستهٔ preview برای test-in.ltx، و "pdflatex" برای test-out.ltx.

برای دسترسی به مستندات کامل اجرا کنید:

texdoc ltximg

مخزن پروژه: https://github.com/pablgonz/ltximg

سامانه پیگیری باگ‌ها: https://github.com/pablgonz/ltximg/issues

Pablo González Luengo, pablgonz@yahoo.com.

حق نشر ۲۰۱۳-۲۰۲۱ Pablo González, pablgonz@yahoo.com.

این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) که توسط «بنیاد نرم‌افزارهای آزاد» منتشر شده است، چه نسخهٔ ۳ مجوز یا (به دلخواه خودتان) هر نسخهٔ بالاتر دیگری بازتوزیع کنید و/یا تغییر دهید.

این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت تلویحی قابلیت فروش یا تناسب برای یک هدف خاص. برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید.

gs(1), dvips(1), ps2pdf(1), pdfcrop(1), pdftops(1), pdftocairo(1), pdftoppm(1)

2021-05-21 2.1