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

برنامج:

اسم

manlifter - برنامج نصي للتحويل الشامل واختبار أداة doclifter

موجز

مناور [-د خيار] [-ه] [-و ملف القائمة] [-أهلا ماندير] [-م] [-م] [-س com.outdir]
[-ص دليل التصحيح] [-P] [-q] [-v] [-s قسم] [-X منع] الاسم

مناور [-س]

الوصف

مناور هو البرنامج النصي الذي يتسلسل com.doclifter(1) لتحويل شجرة صفحات يدوية كاملة إلى
XML-Docbook ، اختياريًا أيضًا إنشاء HTML من XML. استخدام آخر هو كملف
أداة اختبار التعذيب لل doclifter ؛ يقوم بتسجيل الأخطاء في الإخراج القياسي ويجمع التوقيت.

عند استدعائه بدون أي وسائط ملف ، يحاول manlifter تحويل جميع صفحات الدليل المؤهلة
مثبتًا على النظام ، ووضع ملفات xml الناتجة ضمن xmlman في التيار
الدليل. يتم نسخ كل صفحة مترجمة بنجاح foo.N إلى manN / foo.xml أسفل ملف
دليل الإخراج ، بغض النظر عن مصدر الدليل الذي جاء منه.

تعتبر الصفحة اليدوية غير مؤهلة لتحويل الدُفعات إذا كانت تحتوي على نص يشير
لقد تم إنشاؤه من DocBook Masters من Doxygen.

لكل ملف مصدر تم فحصه ، إذا كان الملف الوجهة موجودًا وأحدث من
المصدر ، تم تخطي التحويل ؛ وهكذا ، تدار المتزايد من مناور القيام بأقل عمل
اللازمة للحفاظ على شجرة XML الهدف محدثة. وبالمثل ، فإن ملفات HTML المشتقة في الوضع -h هي ملفات
فقط عند الضرورة.

صفحات كعب رقيق التي هي فقط .وبالتالي تتم ترجمة عمليات إعادة التوجيه إلى ارتباطات رمزية مقابلة في XML
الملفات (وملفات HTML ذات -h).

مناور يمكن أيضًا استدعاؤها باستخدام وسيطة ملف واحد ، والتي يتم تفسيرها على أنها جذع
اسم صفحة دليل محتملة. مناور ثم يبحث في جميع أقسام الدليل المختارة عن
صفحة مطابقة وتحاول تحويلها. في هذه الحالة ، نسخة من صفحة الدليل و
يتم إسقاط النسخة المحولة مباشرة خلف دليل الإخراج ، مع الأسماء
foobar.man و foobar.man.xml على التوالي. عادة ما يكون هذا الوضع ذا أهمية فقط
إلى com.doclifter مطورين لتصحيح أخطاء هذا البرنامج.

في أي من الحالات المذكورة أعلاه ، مناور سيفك ضغط الملف إذا كان يحتوي على امتداد .gz أو .bz2 أو
.Z لاحقة على الاسم.

الخيارات هي كما يلي:

-d
قم بتمرير وسيطة السلسلة إلى كل استدعاء doclifter كخيارات. كل رمز مميز مفصول بمسافة
في السلسلة يصبح وسيطة منفصلة في المكالمة.

-e
تشغيل في وضع تصفية السجل (التي تهم بشكل أساسي com.doclifter المطورين). في هذا الوضع ،
مناور يقرأ سجل الاختبار من الإدخال القياسي ويصفيه بطريقة تعتمد على
الخياران -f و -q. إذا لم يتم تقديم أي من هذه الرسائل ، فسيتم عرض الرسائل من عمليات التشغيل الناجحة
تم تجريده وتمرير الأخطاء فقط إلى الإخراج القياسي.

-f
عادة ، قم بتشغيل doclifter على الملفات المسماة بكل سطر في ملف الوسيطة. في
وضع مرشح الأخطاء يتم تفسير الوسيطة بدلاً من ذلك على أنها تصفية عادية
التعبير.

-h
قم أيضًا بإنشاء ترجمات HTML في دليل الإخراج. DocBook citerefentry markup
يتم تحويله إلى ارتباطات تشعبية في الدليل ، ويتم إنشاء قائمة بالمحتويات إلى
Index.html.

-I
حدد جذر شجرة الصفحات اليدوية. بشكل افتراضي ، هذا هو / usr / share / man.

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

-M
ارفع الملفات المحددة ، ثم افعل ما يعادل الخيار -m.

-o
قم بتعيين دليل الإخراج الذي سيتم إسقاط ترجمات XML-DocBook إليه. بواسطة
الافتراضي هذا هو xmlman تحت الدليل الحالي في وضع الدُفعات ، أو الحالي
دليل خلاف ذلك.

-p
فسر الوسيطة على أنها اسم دليل التصحيح (الاسم الافتراضي هو الإعداد المسبق
تحت الدليل الحالي). يتم تفسير كل ملف يسمى foo.N.patch على أنه تصحيح لـ
يتم تطبيقها على الصفحة اليدوية foo (N) قبل أن يترجمها doclifter.

-P
تمكين التنميط باستخدام وحدة Python hotshot ؛ هذا مفيد فقط للضبط
doclifter بحيث يعمل بشكل أسرع. تتم كتابة البيانات الخام إلى manlifter.prof ، ويتم استيعابها
يتم إلحاق التقرير بسجل الإخراج القياسي. تحذير: يمكن لملفات البيانات الأولية
تصبح ضخمة ، ويمكن أن تستغرق المعالجة اللاحقة لإنشاء التقارير وقتًا طويلاً مثل
المعالجة الفعلية (أو أطول!).

-q
عادة ، قم بتمرير الخيار -q (الهدوء) لكل مكالمة doclifter. في وضع تصفية الأخطاء ،
إرجاع قائمة الملفات التي فشلت الترجمة عليها.

-v
قم بتمرير الخيار -v (مطوّل) لكل مكالمة doclifter. يمكن تكرار هذا الخيار ل
زيادة مستوى الإسهاب.

-s
حدد قسمًا للمسح. استخدم هذا مع الحجة ؛ لا ينبغي أن يكون ضروريا عندما
القيام بتحويل الشجرة بأكملها.

-S
تجميع إحصائيات الخطأ من ملف مناور قدم ملف السجل على المدخلات القياسية. هذه
سيكون الخيار موضع اهتمام بشكل أساسي com.doclifter المطورين.

-X
في الوضع الدفعي ، استبعاد الصفحات المدرجة في ملف الوسيطة. من المفترض أن تستخدم للصفحات
المعروفة جيدًا وتستغرق وقتًا طويلاً للرفع ، من أجل خفض
حان الوقت لإجراء اختبار. (يتم رفع معظم الصفحات في أقل من نصف ثانية ، لكن القليل منها يمكن أن يستغرق
15 دقيقة أو أكثر.)

مناور ينبعث من ملف السجل إلى الإخراج القياسي. يبدأ الملف بسطر طابع زمني وملف
سطر فارغ ، وينتهي بسطر يعطي وقت التشغيل وإحصائيات متنوعة مثيرة للاهتمام.
بين هذه مقاطع ، مفصولة بأسطر فارغة ، واحد لكل ملف فيها com.doclifter
كان يركض.

يبدأ السطر الأول من كل مقطع بـ "!" ، متبوعًا باسم مسار المصدر
النداء اليدوي ، متبوعًا بـ "=" وحالة إرجاع doclifter تعمل على هذا الملف.
بعد ذلك هو الفضاء و com.doclifterوقت التشغيل بالثواني.

قد يتبع هذا السطر الأولي رسائل المعلومات وإخراج الخطأ من
تشغيل doclifter.

مناور يجب أن تجد نسخة من com.doclifter إما في الدليل الحالي أو في أحد
أدلة الأوامر في ملف PATH من أجل الجري.

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