a2x - عبر الإنترنت في السحابة

برنامج:

اسم

a2x - مدير سلسلة أدوات لـ AsciiDoc (يحول الملفات النصية Asciidoc إلى ملف آخر
التنسيقات)

موجز

a2x [OPTIONS] مصدر الملف

الوصف

مدير أدوات DocBook يقوم بترجمة ملف نصي AsciiDoc مصدر الملف إلى PDF ،
EPUB أو DVI أو PS أو LaTeX أو XHTML (صفحة مفردة أو مقسمة) أو صفحة الدليل أو تعليمات HTML أو نص عادي
باستخدام التنسيقات أسكيدوك1 والتطبيقات الأخرى (انظر قسم الطلبات). مصدر الملف يمكن
يكون أيضًا ملف DocBook بامتداد .xml.

OPTIONS

-a، --ينسب=ينسب
المجموعات أسكيدوك(1) قيمة السمة (اختصار لـ - خيارات الازدواج="-أ ينسب" اختيار).
يمكن تحديد هذا الخيار أكثر من مرة.

- خيارات الازدواج=ASCIIDOC_OPTS
إضافي أسكيدوك1 والخيارات. يمكن تحديد هذا الخيار أكثر من مرة.

--conf- ملف=CONF_FILE
تحميل ملف التكوين. انظر قسم ملفات CONF.

-د، - الوجهة- دير=DESTINATION_DIR
دليل الإخراج. افتراضات إلى مصدر الملف الدليل. هذا الخيار ينطبق فقط على
تنسيقات الإخراج القائمة على HTML (مقطوع, EPUB, html help, xhtml).

-د، - doctype=DOCTYPE
نوع مستند DocBook: البند, مانباج or كتاب. نوع المستند الافتراضي هو البند
ما لم يكن التنسيق مانباج (في هذه الحالة يتم تعيينه افتراضيًا إلى مانباج).

-ب، - الخلفية=الخلفية
الخلفية هو اسم مكون إضافي للواجهة الخلفية مثبت. عندما يتم تحديد هذا الخيار a2x
محاولات تحميل اسم ملف a2x-backend.py من الخلفية دليل البرنامج المساعد ثم
يحول مصدر الملف ل الخلفية ملف الإخراج المنسق باستخدام دالة عمومية
المعرفة في a2x-backend.py تسمى إلى_الرجوع إلى الخلف.

-F، --صيغة=FORMAT
تنسيقات الإخراج: مقطوع, docbook, التقنيات, EPUB, html help, مانباج, النسخة الإلكترونية pdf (افتراضي)، ps,
تكس, نص, xhtml. أسكي دوك a2x- تنسيق تم تعيين قيمة السمة على FORMAT.

-ح ، --مساعدة
طباعة بناء جملة سطر الأوامر وخيارات البرنامج إلى stdout.

--أيقونات
استخدم صور التحذير أو رمز التنقل في مستندات الإخراج. السلوك الافتراضي هو
لاستخدام النص بدلاً من الرموز.

--يكون دير=PATH
مسار (متعلق بملفات الإخراج) يحتوي على رموز التنبيه والتنقل. الافتراضات
إلى الصور / الرموز. ال --أيقونات الخيار ضمني إذا تم استخدام هذا الخيار.

-ك، - صيانة القطع الأثرية
لا تحذف ملفات البناء المؤقتة.

--حيوان الوشق
استعمل الوشق حيوان1 لإنشاء إخراج بتنسيق النص. السلوك الافتراضي هو استخدام w3m1.

-L ، --لا xmllint
لا تتحقق من إخراج asciidoc باستخدام com.xmllint1.

- epubcheck
تحقق من إخراج EPUB باستخدام epucheck1.

-ن، --ركض جاف
لا تفعل أي شيء فقط اطبع ما كان يمكن عمله.

-r ، --الموارد=RESOURCE_SPEC
حدد موردًا. يمكن تحديد هذا الخيار أكثر من مرة. انظر الموارد
القسم لمزيد من التفاصيل.

م ، - بيان المصدر=FILE
FILE يحتوي على قائمة الموارد (واحد في كل سطر). يظهر FILE يتم تنسيق الإدخالات
تماما مثل --الموارد حجج الخيار. متغيرات البيئة والتلدا المنزل
الدلائل مسموح بها.

- ورقة نمط=ستايل
قائمة محددة بمسافة تحتوي على واحد أو أكثر من أسماء ملفات أنماط CSS المستخدمة في النمط
ناتج HTML تم إنشاؤه بواسطة DocBook XSL Stylesheets. افتراضات إلى docbook-xsl.css.
تتم معالجة صفحات الأنماط بترتيب القائمة. يجب أن توجد أوراق الأنماط في ملف صالح
موقع ملف الموارد. ينطبق على تنسيقات HTML: xhtml, EPUB, مقطوع, html help
الأشكال.

-الخامس، - الإسراف
طباعة التفاصيل التشغيلية إلى stderr. ثانية -v الخيار يطبق الخيار المطول على
أوامر toolchain.

--الإصدار
نسخة برنامج الطباعة إلى stdout.

--xsltproc- الخيارات=XSLTPROC_OPTS
إضافي com.xsltproc1 والخيارات. يمكن تحديد هذا الخيار أكثر من مرة.

- ملف xsl=XSL_FILE
تجاوز ورقة أنماط XSL المضمنة بورقة أنماط XSL المخصصة XSL_FILE.

--فوب
استخدم FOP لإنشاء ملفات PDF. السلوك الافتراضي هو استخدام dblatex1. --فوب خيار
ضمنيًا إذا تم استخدام هذا الخيار.

- خيارات إضافية=FOP_OPTS
إضافي الغندور رجل شديد التأنق1 والخيارات. إذا تم تحديد هذا الخيار ، فسيتم استخدام FOP لإنشاء ملفات PDF.
يمكن تحديد هذا الخيار أكثر من مرة.

- خيارات dblatex=DBLATX_OPTS
إضافي dblatex1 والخيارات. يمكن تحديد هذا الخيار أكثر من مرة.

- خيارات الخلفية=عودة END_OPTS
خيارات البرنامج المساعد للخلفية المحددة بواسطة - الخلفية اختيار. قد يكون هذا الخيار
محدد أكثر من مرة.

يمكن أيضًا تعيين الخيارات في ملف AsciiDoc المصدر. لو مصدر الملف يحتوي على تعليق
بداية السطر ب // a2x: ثم سيتم التعامل مع باقي السطر على أنه a2x
خيارات سطر الأوامر. على سبيل المثال:

// الخيارات الافتراضية a2x.
// a2x: -dbook --epubcheck
// قم بإلغاء سجل المراجعة في مخرجات dblatex.
// a2x: --dblatex-opts "-P latex.output.revhistory = 0"

· الخيارات التي تمتد عبر العديد من سطور التعليق هذه ستكون متسلسلة.

· يمكن أن يظهر عدد صفر أو أكثر من المسافات البيضاء بين السطور // و a2x:.

خيارات سطر الأوامر لها الأسبقية على الخيارات المحددة في الملف المصدر.

OUTPUT FILES

تتم كتابة ملفات الإخراج إلى الدليل المحدد بواسطة ملف - الوجهة- دير اختيار. إذا كان الجواب لا
- الوجهة- دير يتم كتابة الخيار هو تعيين ملفات الإخراج إلى مصدر الملف الدليل.

ملفات الإخراج لها نفس اسم ملف مصدر الملف ولكن باسم ملف مناسب
التمديد: html xhtml؛ .epub لـ EPUB؛ .hhp لـ html help؛ .pdf لـ النسخة الإلكترونية pdf؛ نص
نصو xml. للنطاق docbook. وفقًا للاتفاقية ، لا تحتوي صفحات manpages على امتداد .man (قسم صفحة الدليل
رقم فقط). تحتوي أسماء دليل HTML المقسمة على ملحق .chunked ؛ تعليمات HTML المقسمة
أسماء الدلائل لها ملحق .htmlhelp.

يتم الكتابة فوق الملفات الموجودة المسماة نفسها.

بالإضافة إلى إنشاء ملفات HTML ، فإن ملفات xhtml, EPUB, مقطوع و html help التنسيقات تضمن
يتم نسخ ملفات الموارد إلى مواقع الدليل الوجهة الصحيحة.

الموارد

الموارد هي ملفات (عادةً CSS والصور) التي تتطلبها المخرجات المستندة إلى HTML
(xhtml, EPUB, مقطوع, html help الأشكال). a2x بفحص ملفات HTML التي تم إنشاؤها وإنشاء ملف
قائمة ملفات CSS والصورة المطلوبة. يمكن تحديد ملفات موارد إضافية
صراحة باستخدام --الموارد الخيار.

a2x يبحث عن ملفات الموارد في المواقع التالية بالترتيب التالي:

1. ال مصدر الملف الدليل.

2. أدلة الموارد المحددة من قبل --الموارد خيار (بحث تكراري).

3. أدلة الموارد المحددة من قبل - بيان المصدر خيار (بحث تكراري
بالترتيب الذي تظهر به في ملف البيان).

4. الصور المخزنة وأدلة أوراق الأنماط في أسكيدوك1 ملفات التكوين
الدلائل (بحث تكراري).

5. دليل الوجهة.

عند العثور على ملف مورد ، يتم نسخه إلى دليل الوجهة النسبي الصحيح.
يتم إنشاء الدلائل الفرعية الوجهة المفقودة تلقائيًا.

توجد آليتان مختلفتان لتحديد موارد إضافية:

1. دليل الموارد الذي سيتم البحث عنه بشكل متكرر عن ملفات الموارد المفقودة.

2. ملف الموارد الذي سيتم نسخه إلى دليل وجهة الإخراج.

يتم تحديد الموارد بـ --الموارد قيم الخيار التي يمكن أن تكون واحدة مما يلي
الأشكال:


[= ]
. =

أين:


يحدد دليلاً (مطلق أو متعلق بامتداد مصدر الملف) الذي تم البحث فيه
بشكل متكرر عن ملفات الموارد المفقودة. للقضاء على الغموض اسم
يجب أن ينتهي بحرف فاصل الدليل.


يحدد ملف مورد (مطلق أو متعلق بامتداد مصدر الملف) الذي سيكون
نسخ إلى . لو غير محدد فهو
نفس .


يحدد وجهة الملف المصدر المنسوخ. ال الطريق
نسبة إلى الدليل الوجهة (المسارات المطلقة غير مسموح بها). الموقع
من دليل الوجهة يعتمد على الإخراج FORMAT (انظر OUTPUT FILES
قسم للحصول على التفاصيل):

chunked ، htmlhelp
دليل الإخراج المقسم.

EPUB
دليل OEBPS المؤرشف.

xhtml
الإخراج DESTINATION_DIR.

. =
عند إضافة موارد إلى ملفات EPUB ، يتم الاستدلال على mimetype من ملف
file> extension ، إذا كان لا يمكن تخمين نوع mimetype ، فسيحدث خطأ. ال
. = يمكن استخدام بناء جملة المورد لتعيين mimetypes بشكل صريح. يكون
ملحق اسم الملف ، هو نوع MIME المقابل.

أمثلة على خيار الموارد:

--الموارد ../الصور/
- وثيقة المصدر / README.txt = README.txt
--الموارد ~ / images / tiger.png= الصور / tiger.png
--resource .ttf = application / x-font-ttf

أمثلة

a2x -f pdf doc / source-light-filter.txt
يولد ملف doc / source-light-filter.pdf.

a2x -f xhtml -D ../doc --icons -r ../images/ team.txt
يقوم بإنشاء ملف HTML ../doc/team.html ، ويستخدم رموز التحذير ويبحث بشكل متكرر في ملف
../images/ دليل لأي موارد مفقودة.

a2x -f manpage doc / asciidoc.1.txt
توليد doc / asciidoc.1 manpage.

يتطلب

a2x يستخدم البرامج التالية:

· أسيدوك: http://asciidoc.org/

· com.xsltproc: (كل الصيغ ماعدا النص): http://xmlsoft.org/XSLT/

· دوكبوك XSL أوراق الأنماط (كل الصيغ ماعدا النص):
http://docbook.sourceforge.net/projects/xsl/

· dblatex (تنسيقات pdf و dvi و ps و tex): http://dblatex.sourceforge.net/

· FOP (تنسيق pdf - مولد ملف PDF بديل): http://xmlgraphics.apache.org/fop/

· w3m (تنسيق النص): http://w3m.sourceforge.net/index.en.html

· الوشق حيوان (تنسيق النص - مولد ملف نصي بديل): http://lynx.isc.org/

· epucheck (تنسيق epub - مدقق ملف EPUB): http://code.google.com/p/epubcheck/

راجع أيضًا أحدث ملف README.

مؤتمر FILES

يحتوي ملف التكوين على كود Python القابل للتنفيذ الذي يحل محل ملف
معلمات التكوين في a2x.py. يتم تحميل ملفات التكوين الاختيارية في ملف
الترتيب التالي:

1. a2x.conf من الدليل الذي يحتوي على ملف a2x.py تنفيذ.

2. a2x.conf من دليل التكوين العام AsciiDoc. تخطي هذه الخطوة إذا كنا كذلك
تنفيذ نسخة مثبتة محليًا (ليست على مستوى النظام).

3. a2x.conf من دليل التكوين AsciiDoc $ HOME / .asciidoc.

4. ال CONF_FILE المحدد في --conf- ملف الخيار.

فيما يلي قيم خيار ملف التكوين الافتراضي:

# تم تمرير قاموس متغير البيئة الاختياري إلى
# برامج منفذة. إذا تم التعيين على لا شيء الموجود
تم استخدام # بيئة.
ENV = لا شيء

# الملفات التنفيذية الخارجية.
ASCIIDOC = "أسكييدوك"
XSLTPROC = 'xsltproc'
DBLATEX = 'dblatex' # جيل pdf.
FOP = 'fop' # جيل pdf (- الخيار fop).
W3M = 'w3m' # إنشاء نصي.
LYNX = إنشاء نصوص 'lynx' # (إذا لم يكن هناك w3m).
XMLLINT = 'xmllint' # اضبط على '' للتعطيل.
EPUBCHECK = 'epubcheck' # اضبط على '' للتعطيل.
# الخيارات الافتراضية الخارجية القابلة للتنفيذ.
ASCIIDOC_OPTS = "
DBLATEX_OPTS = "
FOP_OPTS = "
XSLTPROC_OPTS = "

استخدم a2x عبر الإنترنت باستخدام خدمات onworks.net