هذا هو الأمر db2x_xsltproc الذي يمكن تشغيله في موفر الاستضافة المجاني OnWorks باستخدام إحدى محطات العمل المجانية المتعددة عبر الإنترنت مثل Ubuntu Online أو Fedora Online أو محاكي Windows عبر الإنترنت أو محاكي MAC OS عبر الإنترنت
برنامج:
اسم
db2x_xsltproc - غلاف استدعاء معالج XSLT
موجز
db2x_xsltproc [الخيارات] xml- المستند
الوصف
db2x_xsltproc يستدعي معالج XSLT 1.0 من أجل docbook2X.
يطبق هذا الأمر ورقة أنماط XSLT (يتم تقديمها عادةً بواسطة ملف - ورقة نمط الخيار) إلى
مستند XML في الملف xml- المستند. تتم كتابة النتيجة على الإخراج القياسي (ما لم
تغيرت مع --انتاج).
لقراءة مستند XML المصدر من الإدخال القياسي ، حدد - كمستند الإدخال.
OPTIONS
--الإصدار
قم بعرض نسخة docbook2X.
TRANSFORMATION OUTPUT OPTIONS
--انتاج ملف, -o ملف
اكتب الإخراج إلى الملف المحدد (أو URI) ، بدلاً من الإخراج القياسي.
مصدر DOCUMENT OPTIONS
- تشمل, -I
عملية X تضمين التوجيهات في المستند المصدر.
--sgml, -S
أشر إلى أن مستند الإدخال هو SGML بدلاً من XML. تحتاج هذه المجموعة هذه
الخيار إذا xml- المستند هو في الواقع ملف SGML.
يتم تنفيذ تحليل SGML عن طريق التحويل إلى XML عبر sgml2xml(1) من SP
الحزمة (أو سكس(1) من حزمة OpenSP). ستكون جميع أسماء العلامات في ملف SGML
تطبيع إلى الأحرف الصغيرة (أي -كسلوير الخيار sgml2xml(1) يستخدم). بطاقة تعريف
السمات متاحة لورقة الأنماط (أي خيار -xi). بالإضافة إلى ذلك ، أي
يتم تحويل كيانات ISO SDATA المستخدمة في مستند SGML تلقائيًا إلى ملفات
مكافئات XML Unicode. (يتم ذلك بواسطة أ عطش منقي.)
يجب تحديد ترميز مستند SGML ، إذا لم يكن us-ascii
متغيرات بيئة SP القياسية: SP_CHARSET_FIXED = 1 SP_ENCODING =ترميز.
(لاحظ أن ملفات XML تحدد تشفيرها بإعلان XML <?xml
الإصدار = "1.0" الترميز = "التشفير" ?> في الجزء العلوي من الملف.)
لا يمكن تغيير خيارات التحويل المذكورة أعلاه. إذا كنت ترغب في تحويل مختلف
خيارات ، يجب عليك استدعاء sgml2xml(1) يدويا، ومن ثم تمرير نتائج ذلك
التحويل لهذا البرنامج .
استرجاع OPTIONS
- الكتالوجات ملفات الكتالوج, -C ملفات الكتالوج
حدد كتالوجات XML إضافية لاستخدامها في حل المعرفات العامة الرسمية أو
محددات مواقع المعلومات (URIs). كتالوجات SGML غير مدعومة.
هذه الفهارس ليس تُستخدم لتحليل مستند SGML تحت امتداد --sgml الخيار.
استخدم متغير البيئة SGML_CATALOG_FILES بدلاً من ذلك لتحديد الكتالوجات لـ
تحليل مستند SGML.
--شبكة الاتصال, -N
db2x_xsltproc سترفض عادةً تحميل موارد خارجية من الشبكة ، لـ
أسباب أمنية. إذا كنت تريد التحميل من الشبكة ، فاضبط هذا الخيار.
عادةً ما تريد تثبيت ملفات DTD ذات الصلة والملفات الأخرى محليًا ، و
قم بإعداد كتالوجات لهم ، بدلاً من تحميلهم تلقائيًا من الشبكة.
ستايل OPTIONS
- ورقة نمط ملف, -s ملف
حدد اسم الملف (أو URI) الخاص بورقة الأنماط المراد استخدامها. الرجل القيم الخاصة و
يتم قبول texi كاختصارات ، لتحديد ذلك xml- المستند موجود في DocBook و
يجب تحويلها إلى صفحات man أو Texinfo (على التوالي).
- معلمة الاسم=على سبيل المثال, -p الاسم=على سبيل المثال
إضافة أو تعديل معلمة إلى ورقة الأنماط. الاسم هو اسم معلمة XSLT ، و
على سبيل المثال هو تعبير XPath يتم تقييمه إلى القيمة المطلوبة للمعامل.
(هذا يعني أنه يجب اقتباس السلاسل ، in إضافة إلى الاقتباس المعتاد من القشرة
الحجج؛ يستخدم - بارام الخيط لتجنب هذا.)
- بارام الخيط الاسم=سلسلة, -g الاسم=سلسلة
إضافة أو تعديل معلمة ذات قيمة سلسلة إلى ورقة الأنماط.
يجب ترميز السلسلة بتنسيق UTF-8 (بغض النظر عن ترميز الأحرف المحلية).
تفكيك لأي لبس التشكيل
--Debug, -d
عرض، للخطأ القياسي، سجلات ما يحدث أثناء XSL
التحول.
- حد التعشيش n, -D n
قم بتغيير الحد الأقصى لعدد المكالمات المتداخلة إلى قوالب XSL المستخدمة للكشف
الحلقات اللانهائية المحتملة. إذا لم يتم تحديده ، فسيكون الحد 500 (الافتراضي libxslt).
--الملف الشخصي, -P
عرض معلومات الملف الشخصي: العدد الإجمالي للمكالمات لكل قالب في ملف
ورقة الأنماط والوقت المستغرق لكل منها. يتم إخراج هذه المعلومات إلى المعيار
خطأ.
- معالج xslt المعالج, -X المعالج
حدد معالج XSLT الأساسي المستخدم. الخيارات الممكنة ل المعالج هي:
libxslt ، saxon ، xalan-j.
المعالج الافتراضي هو كل ما تم تعيينه عند إنشاء docbook2X. libxslt هو
موصى به (لأنه خفيف وسريع)، لكن SAXON أكثر قوة وسيفعل ذلك
يكون أكثر فائدة عند تصحيح أوراق الأنماط.
تم تمكين دعم كتالوجات XML في جميع المعالجات. (يتطلب docbook2X ذلك.)
لكن لاحظ أنه ليست كل الخيارات المذكورة أعلاه تعمل مع معالجات بخلاف libxslt
.
البيئة
XML_CATALOG_FILES
حدد كتالوجات XML. إذا لم يتم تحديد الكتالوج القياسي (/ الخ / xml / الكتالوج) هو
محملة ، إن وجدت.
DB2X_XSLT_PROCESSOR
حدد معالج XSLT المراد استخدامه. التأثير هو نفسه - معالج xslt
خيار. الاستخدام الأساسي لهذا المتغير هو السماح لك باختبار مختلف بسرعة
معالجات XSLT دون الحاجة إلى إضافة - معالج xslt إلى كل برنامج نصي أو إنشاء ملف
في نظام بناء الوثائق الخاص بك.
التوافق إلى
لغة صفحات أنماط XML – التحويلات (XSLT)، الإصدار 1.0 ⟨http://www.w3.org/TR/xslt⟩
، توصية W3C.
الملاحظات
في إصداراته السابقة (<0.8.4) ، تطلب docbook2X امتدادات XSLT للتشغيل ، و
db2x_xsltproc كان معالجًا خاصًا يستند إلى libxslt يحتوي على هذه الامتدادات المترجمة.
عندما تم إسقاط متطلبات ملحقات XSLT ، db2x_xsltproc أصبح نص برل
الذي يترجم الخيارات إلى db2x_xsltproc لتتوافق مع الشكل المعتمد من قبل
مخزون com.xsltproc(1) والذي يأتي مع libxslt.
السبب الرئيسي لوجود هذا البرنامج النصي هو التوافق مع الإصدارات السابقة مع أي
نصوص أو إنشاء ملفات تستدعي docbook2X. ومع ذلك ، أصبح من السهل أيضًا إضافته
دعم استدعاء معالجات XSLT الأخرى بواجهة سطر أوامر موحدة. بالفعل،
لا يوجد شيء مميز في هذا البرنامج النصي لـ docbook2X ، أو حتى DocBook ، وقد يكون كذلك
تستخدم لتشغيل أنواع أخرى من أوراق الأنماط إذا كنت ترغب في ذلك. بالتأكيد المؤلف يفضل
باستخدام هذا الأمر ، لأن تنسيق الاستدعاء الخاص به عقلاني وسهل الاستخدام. (على سبيل المثال لا
كتابة أسماء فئات طويلة للمعالجات المستندة إلى Java!)
استخدم db2x_xsltproc عبر الإنترنت باستخدام خدمات onworks.net