هذا هو مستند الأوامر المجمع الذي يمكن تشغيله في موفر الاستضافة المجاني OnWorks باستخدام إحدى محطات العمل المجانية المتعددة عبر الإنترنت مثل Ubuntu Online أو Fedora Online أو محاكي Windows عبر الإنترنت أو محاكي MAC OS عبر الإنترنت
برنامج:
اسم
Bundoc - يجمع كل الملفات التي يحتاجها مستند LaTeX
موجز
وثيقة مجمعة [--الإصدار] [--مساعدة] [--[لا]مطنب] [--ملف=ملف] [--الدليل=دليل]
[--[لا]محلي فقط] [- استثناء=سلسلة] [--يشمل=filespec] [--يظهر=ملف]
[--listdeps=[نعم|لا|فقط|ريل]...] [--[لا]com.keepdirs] [- تكوين=ملف] .ديب ملف
الوصف
مجمعة هو مرحلة ما بعد المعالج ل لقطة الحزمة التي تجمع كل
الفئات والحزم والملفات اللازمة لإنشاء مستند LaTeX معين. يقرأ .ديب
ملف ذلك لقطة ينتج ويجد كل الملفات المذكورة فيه ويحزمها
في ملف أرشيف واحد (على سبيل المثال، a .tar.gz ملف)، مناسب للتنقل عبر الأنظمة،
الإرسال إلى زميل، الخ.
كأبسط مثال ممكن، فكر في ملف LaTeX يسمى، على سبيل المثال، hello.tex:
\RequirePackage{snapshot} % مطلوب بواسطة Bundledoc
\documentclass[11pt]{المادة}
\ بيغن {وثيقة}
مرحبا العالم!
\ نهاية {وثيقة}
يتسبب "\RequirePackage{snapshot}" في حدوث خطأ مرحبا.dep الملف المراد إنتاجه. متى مجمعة is
ثم يتم إعطاء "hello.dep" كوسيطة، ويقوم بتحديد موقع الملفات التابعة - snapshot.sty,
المادة.clsو size11.clo - ويجمعها في ملف أرشيف واحد، بالإضافة إلى
hello.tex و قائمة الملف (الموصوف في "الخيارات"، أدناه).
OPTIONS
وفي الوصفات التالية شيء ما يشير إلى اسم مستند LaTeX الرئيسي (رقم
تمديد).
مجمعة يتطلب اسم ملف التبعية الذي تم إنتاجه بواسطة لقطة (عادة
somefile.dep). يمكن أيضًا إعطاء الخيارات التالية:
--الإصدار
إخراج مجمعة رقم إصدار البرنامج النصي. وهذا يلغي كل ما تبقى
خيارات.
--مساعدة
إعطاء رسالة استخدام مختصرة. وهذا يتجاوز كافة الخيارات المتبقية.
--[لا]مطنب (الافتراضي: "نوفيربوز")
مجمعة عادة لا يخرج أي شيء باستثناء رسائل الخطأ. مع "-مطول"،
يقوم بإخراج رسائل الحالة الغزيرة.
--ملف=رئيسي .تكس ملف (إفتراضي: somefile.tex)
لقطةلا يسرد ملف التبعية الخاص بـ LaTeX ملف LaTeX الرئيسي (الملف الذي تم تمريره
إلى اللاتكس). من أجل مجمعة للعثور على هذا الملف وتجميعه، مجمعة يفترض ذلك
له نفس الاسم مثل لقطة ملف التبعية ولكن مع ملف .تكس امتداد. اذا هذا
ليس الأمر كذلك، فاستخدم "--texfile" لتحديد اسم الملف الصحيح.
--الدليل=أرشيف دليل (إفتراضي: شيء ما)
متى مجمعة ينشئ أرشيفًا (على سبيل المثال، a .قطران or الرمز البريدي ملف) يحتوي على
ملفات المستند، فإنه يضعها كلها في دليل لتجنب ازدحام التيار
الدليل مع الملفات. إذا تم استدعاء ملف التبعية المحدد somefile.dep ثم
سيقوم الأرشيف الناتج، افتراضيًا، بتخزين جميع الملفات التابعة في ملف شيء ما
الدليل. لتغيير اسم الدليل استخدم خيار "--directory".
--[لا]محلي فقط (الافتراضي: "nolocalonly")
بالرغم ان مجمعة يقوم عادةً بأرشفة كافة الملفات المسماة في ملف .ديب ملف
يحكي الخيار "--localonly". مجمعة لاستبعاد جميع الملفات الموجودة في دليل آخر
من .تكس دليل الملف أو أحد أدلةه الفرعية.
- استثناء=سلسلة (إفتراضي: لا شيء)
بينما يؤدي "--localonly" إلى ظهور ملفات خارج ملف .تكس شجرة دليل الملف لتكون
تم حذفه من الأرشيف، ويوفر "--exclude" تحكمًا أكثر دقة في الملفات
حذف من الأرشيف. خيار "--exclude"، والذي يمكن تحديده بشكل متكرر
سطر الأوامر، يسبب كافة الملفات التي يحتوي اسمها سلسلة ليتم حذفها من
أرشيف.
--يشمل=filespec (إفتراضي: لا شيء)
خيار "--include"، والذي يمكن تحديده بشكل متكرر في سطر الأوامر،
يرشد مجمعة لتضمين جميع الملفات المطابقة في الأرشيف filespec، حتى
إذا لم تتم الإشارة إليها في .ديب ملف.
--يظهر=واضح ملف (إفتراضي: قائمة)
بالإضافة إلى الملفات التابعة، مجمعة يتضمن في ملف الأرشيف واحدًا إضافيًا
يسمى الملف افتراضيًا ``قائمة''. قائمة هو ملف نصي يسرد
أسماء الملفات الأصلية لجميع التبعيات. لتغيير اسم الملف من ``قائمة''
لشيء آخر، استخدم خيار "--البيان". كحالة خاصة، "--البيان = """
يروي مجمعة عدم تضمين ملف البيان على الإطلاق.
--listdeps=[yes|no|only|rel]...] (الافتراضي: "no")
يقبل "--listdeps" واحدًا أو أكثر من "yes" أو "no" أو "only" أو "rel" كفاصلة مفصولة
قائمة. طالما أن كلمة "لا" لم تظهر في هذه القائمة، مجمعة مخرجات جميع الرئيسية
تبعيات ملف LaTeX. إذا كانت القائمة تحتوي على "rel"، إذن مجمعة مخرجات
قائمة التبعيات مع أسماء المسارات النسبية. إذا كانت القائمة تحتوي على "فقط"، إذن
مجمعة يخرج بعد عرض القائمة، دون إنتاج أرشيف.
--[لا]com.keepdirs (الافتراضي: "nokeepdirs")
عادة، ملف الأرشيف الذي مجمعة يحتوي على دليل واحد - و
الدلائل الفرعية، إذا كانت الوثيقة تشير إليها صراحةً - حيث يتم إدراج جميع الدلائل
الملفات التابعة تكذب. إذا تم تحديد "--keepdirs"، فسيتم تخزين كافة الملفات التابعة
بأسماء مساراتهم الأصلية. على سبيل المثال، إذا somefile.tex يعتمد على
الأرقام/somefigure.eps, المادة.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
لا يتم استخدام "--directory" عندما يكون "--keepdirs" ساري المفعول. بالإضافة إلى ذلك، لا يوجد بيان
تتم كتابة الملف إلى ملف الأرشيف لأنه يحتوي على معلومات زائدة عن الحاجة.
- تكوين=ترتيب ملف (تقصير: )
يتم استخدام خيار "--config" للإشارة مجمعة إلى التكوين المناسب
(.cfg) ملف لتوزيع TeX ونظام التشغيل الخاص بك. مجمعة يأتي مع
عدد قليل من ملفات التكوين ومن السهل كتابة المزيد. راجع "ملفات التكوين"
(أدناه) للحصول على وصف لتنسيق ملف التكوين.
CONFIGURATION FILES
شكل
تتبع ملفات التكوين تنسيقًا بسيطًا إلى حد ما. الأسطر التي تبدأ بـ "#" هي تعليقات.
يتم تجاهل الأسطر الفارغة. جميع الخطوط الأخرى هي من النموذج:
المتغير: القيمة
الإصدار الحالي من مجمعة يتعرف على المتغيرات التالية:
حزمة
الأمر الذي يجب استخدامه لتجميع مجموعة من الملفات في ملف أرشيف واحد
بالوعة
الإضافة إلى الأمر لتجاهل مخرجاته
جد
أمر البحث عن ملف داخل شجرة (أشجار) TeX.
يمكن تقسيم القيم الطويلة جدًا لسطر واحد عبر عدة أسطر باستخدام "\" كـ
رمز استمرار السطر.
هناك نوعان من متغيرات البيئة مجمعة يجعلها متاحة للاستخدام من قبل
أوامر ملف التكوين: "BDBASE"، والتي تم ضبطها على شيء ما (كما في "الخيارات")، و
"BDINPUTS"، الذي تم تعيينه على قائمة ملفات مفصولة بمسافات والتي سيتم تشغيلها بواسطة أمر
على. أي أنه عند تشغيل الأمر المرتبط بـ "الحزمة"، يحتوي "BDINPUTS".
قائمة بجميع الملفات التي سيتم أرشفتها. في المقابل، عندما الأمر
المرتبط بـ "find" قيد التشغيل، ويحتوي "BDINPUTS" على اسم الملف المطلوب البحث عنه.
أمثلة
ملف التكوين التالي يوازي مجمعةالقيم الافتراضية لمختلف
متغيرات ملف التكوين، والتي تمثل توزيعة TeX المستندة إلى kpathsea قيد التشغيل
على نظام Unix عام، والذي لا يحتوي بالضرورة على أي من أدوات GNU، مثل
GZIP أو جنو قطران:
# ملف التكوين "الافتراضي".
# بقلم سكوت باكين[البريد الإلكتروني محمي]>
الحزمة: (tar -cvf - $BDINPUTS | ضغط > $BDBASE.tar.Z)
الحوض: > /dev/null 2>&1
ابحث عن: kpsewhat -progname=latex $BDINPUTS
الأقواس الموجودة في سطر "الحزمة:" تخبر قذيفة Unix بتشغيل الأمر في ملف
قذيفة فرعية. هذا لجعل الملحق "sink:" يعمل بشكل صحيح (على سبيل المثال، بحيث لا يوجد اثنان
">" في نفس الأمر).
لاحظ كيف تتعامل الأوامر مع "BDBASE" و"BDINPUTS" مثل أي متغيرات بيئة أخرى
في غلاف Unix، باستخدام "$" للحصول على قيمتها. أنظمة التشغيل الأخرى تستخدم مختلفة
اتفاقيات للإشارة إلى متغيرات البيئة. على سبيل المثال، ملف التكوين
بالنسبة لتوزيع TeX المستند إلى Windows، سيستخدم "%BDBASE%" و"%BDINPUTS%" بدلاً من ذلك.
قيمة "sink:" خاصة بنظام التشغيل. قيمة "البحث عن:" هي
خاص بتوزيع TeX. "الحزمة:" هي المكان الذي توجد فيه أكبر فرصة للتخصيص
يكذب. يمكنك استخدام "bundle:" لتحديد تنسيق الأرشيف المفضل لديك. علي سبيل المثال انت
يمكن إنتاج ملف shar على Unix بشيء مثل:
الحزمة: (shar --archive-name = "$BDBASE" $BDINPUTS > $BDBASE.sh)
أو ملف CAB على نظام التشغيل Microsoft Windows بشيء مثل:
الحزمة: cabarc -r -p N %BDBASE%.cab %BDINPUTS%
أمثلة
افترض أن myfile.dep تم إنتاجه من myfile.tex وذلك باتباع التعليمات الموجودة في
قسم الوصف. ينتج الأمر التالي أ الرمز البريدي ملف مع MikTeX TeX
التوزيع يعمل على مايكروسوفت ويندوز:
Bundoc --config=miktex.cfg myfile.dep
(من الناحية العملية، ربما يكون من الضروري تحديد "--config" المسار الكامل إلى
مجمعة's miktex.cfg ملف الضبط.)
ما يلي يبني أ .tar.gz أرشفة مع توزيع TeX Live الذي يعمل على Unix-
مثل نظام التشغيل. مجمعة سوف تنتج مخرجات مطولة تصف عملياتها.
كافة الملفات ليست في نفس شجرة الدليل مثل myfile.tex وجميع الملفات التي تحتوي على ".fd" أو
تم حذف ".sty" في أسمائهم. ومع ذلك، كل شيء .مريلة الملفات الموجودة في الدليل الحالي سوف
يتم تضمينها في الأرشيف على الرغم من عدم الإشارة إلى أي منها myfile.dep.
أخيرًا ، لا قائمة سيتم إنتاج الملف.
Bundoc --config=texlive-unix.cfg --verbose --localonly \
--exclude=.fd --exclude=.cfg --include="*.bib" --manifest="" \
myfile.dep
استخدم Bundoc عبر الإنترنت باستخدام خدمات onworks.net