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

برنامج:

اسم

- pod2text - تحويل بيانات POD إلى نص ASCII منسق

موجز

نص بود2 [-اكلوستو] [--الشفرة] [- أخطاء=نمط] [-i المسافة البادئة]
[-q يقتبس] [- نورلز] [- ستدير] [-w عرض]
[إدخال [الناتج ...]]

pod2text -h

الوصف

pod2text هي واجهة أمامية لـ Pod :: Text وفئاته الفرعية. يستخدمها لتوليد
نص ASCII منسق من مصدر POD. يمكن اختياريا استخدام إما متواليات termcap أو
تسلسلات هروب الألوان ANSI لتنسيق النص.

إدخال هو الملف المراد قراءته لمصدر POD (يمكن تضمين POD في التعليمات البرمجية). لو إدخال
لم يتم تقديمه ، يتم تعيينه افتراضيًا على "STDIN". الناتج، إذا تم توفيره ، هو الملف المراد كتابة ملف
إخراج منسق. لو الناتج لم يتم إعطاء الإخراج المنسق مكتوبًا على "STDOUT".
يمكن معالجة عدة ملفات POD في نفس الوقت pod2text الدعاء (حفظ تحميل الوحدة و
تجميع مرات) من خلال توفير أزواج متعددة من إدخال و الناتج الملفات في سطر الأوامر.

OPTIONS

-a, - بديل
استخدم تنسيق إخراج بديل يستخدم ، من بين أشياء أخرى ، عنوانًا مختلفًا
النمط ويضع علامة على إدخالات "= عنصر" بنقطتين في الهامش الأيسر.

--الشفرة
قم بتضمين أي نص غير POD من ملف الإدخال في الإخراج أيضًا. مفيد ل
رمز العرض الموثق بكتل POD مع تقديم POD والشفرة اليسرى
سليم.

-c, --اللون
تنسيق الإخراج مع تسلسل هروب اللون ANSI. استخدام هذا الخيار يتطلب ذلك
المصطلح :: يتم تثبيت ANSIColor على نظامك.

-i المسافة البادئة, - المسافة =المسافة البادئة
عيّن عدد المسافات لوضع مسافة بادئة للنص العادي ، والمسافة البادئة الافتراضية لـ
"= أكثر من" من الكتل. افتراضيات 4 مسافات إذا لم يتم توفير هذا الخيار.

-الخطأ=نمط
اضبط أسلوب معالجة الخطأ. يقول "die" لطرح استثناء على أي تنسيق POD
خطأ. يقول "stderr" للإبلاغ عن الأخطاء في الخطأ المعياري ، ولكن ليس لرمي
استثناء. تقول "pod" لتضمين قسم POD ERRORS في الوثائق الناتجة
تلخيص الأخطاء. "لا شيء" يتجاهل أخطاء POD تمامًا ، قدر الإمكان.

الافتراضي هو "يموت".

-h, --مساعدة
اطبع معلومات الاستخدام واخرج.

-l, --مرتخي
اطبع سطرًا فارغًا بعد العنوان "= head1". عادة ، لا تتم طباعة أي سطر فارغ بعد ذلك
"= head1" ، على الرغم من استمرار طباعة أحدها بعد "= head2" ، لأن هذا هو المتوقع
تنسيق الصفحات اليدوية؛ إذا كنت تقوم بتنسيق مستندات نصية عشوائية، فاستخدم هذا
ينصح الخيار.

-m عرض, - الهامش الأيسر=عرض, --هامش=عرض
عرض الهامش الأيسر بمسافات. القيمة الافتراضية هي 0. هذا هو الهامش للجميع
النص ، بما في ذلك العناوين ، وليس مقدار المسافة البادئة للنص العادي ؛ ل
الأخير، انظر -i الخيار.

- نورلز
عادةً ما يتم تنسيق رموز التنسيق L <> بعنوان URL ولكن نص الرابط لإظهار كليهما
نص الرابط وعنوان URL. بعبارة أخرى:

إلhttp://example.com/>

تم تنسيقه على النحو التالي:

فوhttp://example.com/>

هذه العلامة ، إذا تم تقديمها ، تمنع عنوان URL عند تقديم نص الرابط ، لذلك هذا المثال
سيتم تنسيقه كـ "foo" فقط. يمكن أن ينتج عن هذا إخراج أقل تشوشًا في الحالات
حيث لا تكون عناوين URL مهمة بشكل خاص.

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

-q يقتبس, --يقتبس=يقتبس
يعيّن علامات الاقتباس المستخدمة لإحاطة نص C <> إلى يقتبس. إذا يقتبس هو واحد
حرف ، يتم استخدامه كالاقتباس الأيسر والأيمن ؛ لو يقتبس يتكون من حرفين ،
يتم استخدام الحرف الأول كاقتباس على اليسار بينما يتم استخدام الحرف الثاني باعتباره علامة الاقتباس اليمنى ؛ و
if يقتبس يتكون من أربعة أحرف ، يتم استخدام أول حرفين كاقتباس على اليسار والثاني
اثنان كاقتباس صحيح.

يقتبس يمكن أيضًا تعيينها على القيمة الخاصة "لا شيء" ، وفي هذه الحالة لا توجد علامات اقتباس
تمت إضافته حول نص C<>.

-s, --جملة
افترض أن كل جملة تنتهي بمسافتين وحاول الحفاظ على هذا التباعد. بدون
هذا الخيار ، يتم ضغط كل المسافات البيضاء المتتالية في الفقرات غير الحرفية في
مسافة واحدة.

- ستدير
افتراضيا، pod2text يموت إذا تم اكتشاف أي أخطاء في إدخال POD. لو - ستدير is
معطى ولا - أخطاء العلم موجود ، يتم إرسال الأخطاء إلى الخطأ القياسي ، ولكن pod2text
لا يجهض. هذا يعادل "--errors = stderr" وهو مدعوم للخلف
التوافق.

-t, --termcap
حاول تحديد عرض الشاشة والتسلسل الغامق والتسطير لملف
terminal من termcap ، واستخدم هذه المعلومات في تنسيق الإخراج. سوف الإخراج
أن تكون ملفوفة في عمودين أقل من عرض جهازك الطرفي. باستخدام هذا
يتطلب الخيار أن يكون لدى نظامك ملف termcap في مكان ما حيث يمكن لـ Term :: Cap
تجده ويتطلب أن يدعم نظامك النمل. مع هذا الخيار ، الإخراج
of pod2text سيحتوي على تسلسلات تحكم طرفية لنوع جهازك الطرفي الحالي.

-u, --utf8
افتراضيا، pod2text يحاول استخدام نفس ترميز الإخراج مثل ترميز الإدخال (إلى
أن تكون متوافقة مع الإصدارات السابقة). يقول هذا الخيار بدلاً من ذلك فرض
ترميز الإخراج إلى UTF-8.

اعلم أنه عند استخدام هذا الخيار ، يجب أن يكون ترميز الإدخال لمصدر POD
تم التصريح عنها بشكل صحيح ما لم تكن US-ASCII أو Latin-1. إدخال POD بدون "= encoding"
يُفترض أن يكون الأمر باللاتينية 1 ، وإذا كان في الواقع بتنسيق UTF-8 ، فسيكون الناتج
سيتم ترميزها مرتين. يرى بيرلبود(1) لمزيد من المعلومات حول "= encoding"
أمر.

-w, - العرض =عرض, -عرض
العمود الذي سيتم فيه التفاف النص على الجانب الأيمن. الافتراضي هو 76 ، ما لم -t is
معطى ، وفي هذه الحالة يكون العمودان أقل من عرض جهازك الطرفي.

EXIT الوضع

طالما أن جميع المستندات التي تمت معالجتها ينتج عنها بعض المخرجات ، حتى لو تضمن ذلك الإخراج
errata (قسم "POD ERRORS" الذي تم إنشاؤه باستخدام "--errors = pod") ، pod2text سوف تخرج مع
الحالة 0. إذا لم ينتج عن أي من المستندات قيد المعالجة مستند إخراج ،
pod2text سيتم الخروج بالحالة 1. إذا كانت هناك أخطاء في بناء الجملة في مستند POD
تمت معالجته وتعيين نمط معالجة الأخطاء على الإعداد الافتراضي لـ "die" ، pod2text ستجهض
على الفور مع حالة الخروج 255.

DIAGNOSTICS

If pod2text فشل مع وجود أخطاء ، راجع Pod :: Text و Pod :: Simple للحصول على معلومات حول ماذا
قد تعني هذه الأخطاء. داخليًا ، يمكنه أيضًا إنتاج التشخيصات التالية:

-c (--color) يتطلب تثبيت Term :: ANSIColor
(F) -c or --اللون تم تقديمها، ولكن تعذر تحميل Term::ANSIColor.

خيار غير معروف:٪ s
(F) تم إعطاء خيار سطر أوامر غير معروف.

بالإضافة إلى ذلك، قد تنتج رسائل خطأ Getopt::Long أخرى من سطر أوامر غير صالح
خيارات.

البيئة

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

تيرمكاب
If -t معطى، pod2text سيستخدم محتويات متغير البيئة هذا إذا
متاح لتحديد تسلسل التنسيق الصحيح لجهازك الحالي
الجهاز.

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