نام (NAME)

texdirflatten - جمع‌آوری تمام اجزای یک فایل (La)TeX در یک دایرکتوری خروجی واحد -- یعنی مسطح‌سازی سلسله‌مراتب آن.

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

texdirflatten [-1|--onetex] [-f|--file input.tex] [-o outputdir]
[--imgexts .ext1,.ext2,...] [--debug] [-V|--version] [-?|--help]

توضیحات (DESCRIPTION)

این اسکریپت Perl یک فایل LaTeX را به صورت بازگشتی پردازش کرده، تمام فایل‌های فرزند را پویش می‌کند و مشخصات هرگونه فایل پیوست‌شده یا سایر فایل‌های داده، مانند تصاویر و فایل‌های کتاب‌شناسی BiBTeX را جمع‌آوری می‌نماید. سپس این فایل‌های جزء همگی در یک دایرکتوری واحد قرار می‌گیرند (و به این ترتیب درخت دایرکتوری سند "مسطح" می‌شود). این قابلیت هنگام توزیع دست‌نوشته‌ها بین همکاران یا ارسال آن‌ها به ژورنال‌ها مفید است.

گزینه‌ها (OPTIONS)

--file, -f input.tex

فایل ورودی (La)TeX را مشخص می‌کند.

--onetex, -1

در صورت تعیین، با بسط دادن تمامی دستورهای \input و \include در همان محل، یک فایل TeX واحد تولید می‌کند.

--output, -o outputdir

دایرکتوری برای جمع‌آوری تمام فایل‌ها. texdirflatten تک‌تک فایل‌های منبع، تصاویر و فایل‌های کتاب‌شناسی را در این دایرکتوری کپی می‌کند. در صورت عدم وجود، ایجاد خواهد شد. اگر مشخص نشود، مقدار پیش‌فرض "flat/" است.

--imgexts .ext1,.ext2[,...]

این پسوندها را به ابتدای فهرست اولویت‌بندی‌شده پسوندهای تصویر اضافه می‌کند تا هنگام یافتن تصویر برای کپی در پوشه خروجی جستجو شوند. نخستین فایلی که با پسوند پیدا شده مطابقت داشته باشد کپی شده و جستجو متوقف می‌شود. ترتیب پیش‌فرض "", ".eps", ".pdf", ".pstex" است (توجه داشته باشید که شامل فایل‌های بدون پسوند نیز می‌شود). در صورت استفاده از pdflatex، می‌توان با "--imgexts .pdf" فرمت PDF را قبل از EPS قرار داد. نقطه پیش از پسوند را فراموش نکنید!

--debug

خروجی‌های اشکال‌زدایی با جزئیات فراوان را فعال می‌کند - زمانی که مشکلی پیش می‌آید مفید است.

--version, -V

شماره نسخه فعلی و نحوه استفاده را نمایش داده و خارج می‌شود.

--help, -?

نمایش این صفحه راهنما.

مثال‌ها (EXAMPLES)

مثال زیر "manuscript.tex" را در دایرکتوری جاری بررسی کرده و آن و تمام اجزایش را در دایرکتوری "submit_01/" جمع‌آوری می‌کند:

$ texdirflatten -f manuscript.tex -o submit_01

هشدارها (CAVEATS)

لطفاً پیش از اجرای این دستور نسخه‌های پشتیبان تهیه کنید. هیچ‌گونه ضمانتی ارائه نمی‌شود.

در صورت استفاده از "pdflatex" ممکن است نیاز باشد "epstopdf" را روی فایل‌های EPS اجرا کنید:

$ for i in *.eps; do epstopdf $i; done

گزارش باگ‌ها (BUGS)

از ارسال گزارش‌های باگ و وصله‌ها استقبال می‌شود.

نویسندگان (AUTHORS)

Cengiz Gunay <cengique<AT>users.sf.net>

کپی‌رایت و تکثیر (COPYRIGHT)

Copyleft 2003-2017, Cengiz Gunay

این کتابخانه یک نرم‌افزار آزاد است؛ می‌توانید آن را تحت همان شرایط خود Perl بازتوزیع کرده و/یا تغییر دهید.