bundledoc - آنلاین در ابر

برنامه:

نام

bundledoc - تمام فایل های مورد نیاز یک سند LaTeX را بسته بندی کنید

خلاصه

باندلدوک [- نسخه] [--کمک] [--[نه]واژگان] [--تکس فایل=پرونده] [--فهرست راهنما=فهرست راهنما]
[--[نه]به صورت محلی] [-- استثناء کردن=رشته] [--عبارتند از=مشخصات فایل] [-- آشکار=پرونده]
[--listdeps=[بله|نه|فقط|ارتباط]...] [--[نه]نگهدارنده] [- پیکربندی=پرونده] .dep پرونده

شرح

bundledoc یک پس پردازشگر برای عکس فوری بسته ای که همه را با هم جمع می کند
کلاس‌ها، بسته‌ها و فایل‌های مورد نیاز برای ساخت یک سند LaTeX معین. را می خواند .dep
پرونده که عکس فوری هر یک از فایل های ذکر شده در آن را تولید کرده، پیدا کرده و آنها را بسته بندی می کند
در یک فایل آرشیو واحد (به عنوان مثال، الف .tar.gz فایل)، مناسب برای جابجایی در بین سیستم ها،
انتقال به همکار و غیره

به عنوان ساده ترین مثال ممکن، یک فایل LaTeX را در نظر بگیرید که مثلاً، سلام تکس:

\RequirePackage{snapshot} % مورد نیاز bundledoc
\documentclass[11pt]{article}

\شروع{سند}
سلام دنیا!
\پایان{سند}

"\RequirePackage{snapshot}" باعث a سلام دپ فایلی که باید تولید شود چه زمانی bundledoc is
سپس "hello.dep" به عنوان آرگومان داده می شود، فایل های وابسته را مکان یابی می کند -- snapshot.sty,
article.clsو اندازه 11. کلو -- و آنها را در یک فایل آرشیو واحد، همراه با
سلام تکس و یک MANIFEST فایل (شرح شده در "OPTIONS"، در زیر).

OPTIONS

در توضیحات زیر، چند فایل به نام سند اصلی LaTeX شما اشاره دارد (شماره
افزونه).

bundledoc نیاز به نام فایل وابستگی تولید شده توسط عکس فوری (به طور معمول
somefile.dep). گزینه های زیر نیز ممکن است داده شود:

- نسخه
خروجی bundledoc شماره نسخه اسکریپت این همه موارد باقی مانده را لغو می کند
گزینه.

--کمک
یک پیام استفاده مختصر بدهید. این همه گزینه های باقی مانده را لغو می کند.

--[نه]واژگان (پیش‌فرض: "noverbose")
bundledoc به طور معمول چیزی به جز پیام های خطا خروجی نمی دهد. با "--کلمه"،
پیام های وضعیت فراوان را خروجی می دهد.

--تکس فایل=اصلی تکس پرونده (پیش فرض: somefile.tex)
عکس فوریفایل وابستگی 's فایل LaTeX اصلی (آنی که پاس می شود) را فهرست نمی کند
به شیرابه). برای bundledoc برای پیدا کردن و بسته بندی آن فایل، bundledoc آن را فرض می کند
همان نام را دارد عکس فوری فایل وابستگی اما با a تکس افزونه. اگر این
اینطور نیست، سپس از "--texfile" برای تعیین نام فایل صحیح استفاده کنید.

--فهرست راهنما=بایگانی فهرست راهنما (پیش فرض: چند فایل)
چه زمانی bundledoc یک آرشیو ایجاد می کند (به عنوان مثال، الف .tar or وبلاگ فایل) حاوی
فایل های سند، همه آنها را در یک فهرست قرار می دهد تا از بهم ریختگی جریان جلوگیری کند
دایرکتوری با فایل ها اگر فایل وابستگی داده شده فراخوانی شود somefile.dep سپس
بایگانی به‌طور پیش‌فرض، تمام فایل‌های وابسته را در یک ذخیره می‌کند چند فایل
فهرست راهنما. برای تغییر نام دایرکتوری از گزینه "--directory" استفاده کنید.

--[نه]به صورت محلی (پیش‌فرض: "nolocalonly")
هر چند bundledoc به طور معمول تمام فایل های نامگذاری شده در را بایگانی می کند .dep فایل،
گزینه "--localonly" می گوید bundledoc برای حذف همه فایل های واقع در یک دایرکتوری دیگر
از تکس دایرکتوری فایل یا یکی از زیر شاخه های آن.

-- استثناء کردن=رشته (پیش فرض: هیچ)
در حالی که "--localonly" باعث ایجاد فایل های خارج از قسمت می شود تکس درخت دایرکتوری فایل باشد
حذف شده از بایگانی، "--exclude" کنترل دقیق تری بر روی فایل ها ارائه می کند.
از آرشیو حذف شود گزینه "--exclude" که می تواند به طور مکرر روی آن مشخص شود
خط فرمان، باعث ایجاد تمام فایل هایی می شود که نام آنها شامل می شود رشته حذف شود از
بایگانی.

--عبارتند از=مشخصات فایل (پیش فرض: هیچ)
گزینه "--include" که می تواند به طور مکرر در خط فرمان مشخص شود،
دستور می دهد bundledoc برای گنجاندن در آرشیو تمام فایل های مطابقت مشخصات فایل، حتی
اگر به آنها اشاره نشده است .dep فایل.

-- آشکار=ظاهر پرونده (پیش فرض: MANIFEST)
علاوه بر فایل های وابسته، bundledoc شامل یک فایل بایگانی اضافی است
فایلی که به طور پیش‌فرض به نام «`» نامیده می‌شودMANIFEST'' MANIFEST یک فایل متنی است که موارد را فهرست می کند
نام فایل اصلی همه وابستگی ها برای تغییر نام فایل از ``MANIFEST''
برای چیز دیگری، از گزینه "--manifest" استفاده کنید. به عنوان یک مورد خاص، "--manifest="""
می گوید bundledoc به هیچ وجه شامل فایل مانیفست نمی شود.

--listdeps=[بله|نه|فقط|ارتباط]...] (پیش‌فرض: "نه")
"--listdeps" یک یا چند مورد "بله"، "نه"، "فقط" یا "rel" را به عنوان یک کاما جدا می‌پذیرد.
فهرست تا زمانی که "نه" در این لیست ظاهر نشود، bundledoc خروجی تمام اصلی
وابستگی های فایل LaTeX اگر لیست حاوی "rel" باشد، پس bundledoc خروجی می دهد
لیستی از وابستگی ها با نام مسیر نسبی. اگر لیست حاوی "فقط" باشد، پس
bundledoc پس از نمایش لیست، بدون ایجاد آرشیو خارج می شود.

--[نه]نگهدارنده (پیش‌فرض: "nokeepdirs")
به طور معمول، فایل بایگانی که bundledoc تولید می کند شامل یک فهرست واحد -- and
دایرکتوری های فرعی، در صورتی که سند به صراحت به آنها اشاره دارد -- که در آن همه
فایل های وابسته دروغ می گویند اگر "--keepdirs" مشخص شده باشد، تمام فایل های وابسته ذخیره می شوند
با نام مسیر اصلی خود به عنوان مثال، اگر somefile.tex بستگی دارد
figures/somefigure.eps, article.clsو snapshot.sty، سپس چند فایل وصیت نامه بایگانی
معمولا حاوی فایل های زیر است:

· somefile/somefile.tex

· somefile/figures/somefigure.eps

· somefile/article.cls

· somefile/snapshot.sty

· Somefile/MANIFEST

با این حال، "--keepdirs" باعث می شود چند فایل بایگانی که شامل انواع زیر باشد
از نام فایل در عوض:

· home/me/mydocs/somefile.tex

· home/me/mydocs/figures/somefigure.eps

· usr/share/texmf/tex/latex/base/article.cls

· usr/share/texmf/tex/latex/snapshot/snapshot.sty

هنگامی که "--keepdirs" در حال اجرا است از "--directory" استفاده نمی شود. علاوه بر این، هیچ آشکار
فایل در فایل بایگانی نوشته می شود زیرا حاوی اطلاعات اضافی است.

- پیکربندی=پیکر بندی پرونده (پیش فرض: )
از گزینه "--config" برای اشاره استفاده می شود bundledoc به پیکربندی مناسب
(.cfg) فایل برای توزیع TeX و سیستم عامل شما. bundledoc همراه با یک
چند فایل پیکربندی و نوشتن بیشتر آسان است. به "فایل های پیکربندی" مراجعه کنید
(در زیر) برای توضیح فرمت فایل پیکربندی.

پیکربندی فایل ها

قالب
فایل های پیکربندی از فرمت نسبتاً ساده ای پیروی می کنند. خطوطی که با "#" شروع می شوند نظرات هستند.
خطوط خالی نادیده گرفته می شوند. تمام خطوط دیگر به این شکل هستند:

متغیر: مقدار

نسخه فعلی bundledoc متغیرهای زیر را تشخیص می دهد:

بسته
دستوری که برای بسته بندی مجموعه ای از فایل ها در یک فایل آرشیو واحد استفاده می شود

فرو رفتن
الصاق یک فرمان برای حذف خروجی آن

پیدا کردن
فرمان برای یافتن یک فایل در درخت(های) TeX.

مقادیری که برای یک خط خیلی طولانی هستند را می توان با استفاده از "\" به عنوان در چندین خط تقسیم کرد
نماد ادامه خط

دو متغیر محیطی وجود دارد که bundledoc برای استفاده در دسترس قرار می دهد
دستورات configuration-file: "BDBASE" که روی تنظیم شده است چند فایل (مانند "OPTIONS")، و
"BDINPUTS"، که به فهرستی از فایل‌های جدا شده با فاصله از یک فرمان تنظیم می‌شود
بر. یعنی زمانی که فرمان مرتبط با "bundle" در حال اجرا است، "BDINPUTS" شامل می شود
لیست تمام فایل هایی که قرار است بایگانی شوند. در مقابل، زمانی که فرمان
مرتبط با "find" در حال اجرا است، "BDINPUTS" حاوی نام فایل مورد جستجو است.

مثال ها
فایل پیکربندی زیر موازی است bundledoc's مقادیر پیش فرض از مختلف
متغیرهای پیکربندی فایل، که یک توزیع TeX مبتنی بر kpathsea در حال اجرا را نشان می‌دهد
در یک سیستم یونیکس عمومی، که لزوما هیچ یک از ابزارهای گنو را ندارد، مانند
از gzip یا گنو قیر:

# فایل پیکربندی "پیش فرض".
# نوشته اسکات پاکین[ایمیل محافظت شده]>

بسته: (tar -cvf - $BDINPUTS | فشرده > $BDBASE.tar.Z)
سینک: > /dev/null 2>&1
پیدا کنید: kpsewhich -progname=latex $BDINPUTS

پرانتز در خط "bundle:" به پوسته یونیکس می گوید که دستور را در a اجرا کند
زیر پوسته این برای این است که پسوند "sink:" به درستی کار کند (یعنی دو مورد وجود نداشته باشد
">" در همان دستور است).

توجه کنید که چگونه دستورات با "BDBASE" و "BDINPUTS" مانند سایر متغیرهای محیطی رفتار می کنند.
در یک پوسته یونیکس، با استفاده از "$" برای گرفتن مقدار آنها. سایر سیستم عامل ها از موارد متفاوتی استفاده می کنند
قراردادها برای ارجاع به متغیرهای محیطی به عنوان مثال، یک فایل پیکربندی
برای توزیع TeX مبتنی بر ویندوز، به جای آن از "%BDBASE%" و "%BDINPUTS%" استفاده می شود.

مقدار "sink:" مختص یک سیستم عامل است. مقدار "یافتن:" است
مخصوص توزیع TeX "Bundle:" جایی است که بیشترین فرصت برای سفارشی‌سازی وجود دارد
دروغ. برای تعیین فرمت آرشیو مورد علاقه خود می توانید از "Bundle:" استفاده کنید. مثلا شما
می تواند یک فایل shar در یونیکس با چیزی شبیه به:

بسته: (shar --archive-name="$BDBASE" $BDINPUTS > $BDBASE.sh)

یا یک فایل CAB در مایکروسافت ویندوز با چیزی شبیه به:

بسته: cabarc -r -p N %BDBASE%.کابین %BDINPUTS%

مثال ها

فرض کن که myfile.dep از تولید شد myfile.tex با پیروی از دستورالعمل های موجود در
بخش توضیحات دستور زیر a را تولید می کند وبلاگ فایل با MikTeX TeX
توزیع در حال اجرا در ویندوز مایکروسافت:

bundledoc --config=miktex.cfg myfile.dep

(در عمل، احتمالاً لازم است که مسیر کامل به "--config" را مشخص کنید
bundledoc's miktex.cfg فایل پیکربندی.)

زیر یک را می سازد .tar.gz بایگانی با توزیع TeX Live در حال اجرا بر روی Unix-
مانند سیستم عامل bundledoc خروجی مفصلی تولید خواهد کرد که عملیات آن را توصیف می کند.
همه فایل‌ها در همان درخت دایرکتوری نیستند myfile.tex و تمام فایل های حاوی ".fd" or
".sty" در نام آنها حذف شده است. با این حال، همه .بیب فایل های موجود در فهرست فعلی خواهد شد
در آرشیو گنجانده شود حتی اگر هیچ یک از آنها ارجاع داده نشده باشند myfile.dep.
در نهایت، نه MANIFEST فایل تولید خواهد شد

bundledoc --config=texlive-unix.cfg --verbose --localonly \
--exclude=.fd --exclude=.cfg --include="*.bib" --manifest="" \
myfile.dep

با استفاده از خدمات onworks.net از bundledoc به صورت آنلاین استفاده کنید