وMarkowik هو التطبيق بيثون الذي يحول النص المنسق تخفيض السعر إلى Google مدونة ويكي.
Markowik غير قادرة على تحويل معظم البنى تخفيض السعر لفي مدونة جوجل ويكي (GCW) في حكمه. بدلا من سرد كل التحويلات المعتمدة، يرجى إلقاء نظرة على Markowik في اختبار داخلي وحالة العرض لها.
تركيب
تشغيل:
PIP تثبيت markowik
أو:
easy_install markowik
يمكنك أيضا استخدام Markowik من دون تركيب، كما هو موضح في إطار المساهمة.
سطر الأوامر الاستخدام
من إخراج مساعدة:
الاستعمال: markowik [-h] [--mx [MX [MX ...]]] [URL --image-baseurl]
على & nbsp؛ [- أتش تي أم أل الصور] [--encoding ENCODING] [--quiet]
على & nbsp؛ INFILE [OUTFILE]
تحويل تخفيض السعر إلى Google مدونة ويكي.
الحجج الموضعية:
على & nbsp؛ ملف تخفيض السعر INFILE
على & nbsp؛ ملف يكي OUTFILE (الافتراضي: المعياري)
سيطات اختيارية:
على & nbsp؛ -h، --help إظهار هذه الرسالة مساعدة والخروج
على & nbsp؛ - MX [MX [MX ...]] ملحقات تخفيض السعر لتفعيل
على & nbsp؛ - URL صورة-baseurl قاعدة URL إلى prepend إلى مواقع صورة النسبية
على & nbsp؛ - أتش تي أم أل الصور دائما استخدام HTML للصور
على & nbsp؛ - الترميز الترميز ENCODING من المدخلات والمخرجات (الافتراضي: UTF8)
على & nbsp؛ - هادئة تعطيل رسائل المعلومات
يمكن إعطاء ملحقات تخفيض السعر بالمثل فيما يتعلق أداة سطر الأوامر بيثون تخفيض السعر (PyMD)، مع الاستثناء الذي ملحقات الفردية يجب أن تكون مفصولة بمسافة:
markowik جداول المدخلات --mx def_list
والمعتمدة حاليا (أي اختبار) التمديدات هي ابر، والجداول، وdef_list. ملحقات أخرى عموما يجب أن تعمل أيضا ولكن قد تسفر عن نتائج غير متوقعة في النص يكي المحولة.
وفيما يتعلق الخيار --html الصور، نرى التفسيرات أدناه في القيود.
استخدام برنامجي
ويتم تنفيذ Markowik في بيثون. توفر وحدة markowik وظيفة اسمه تحويل. غويا أنها تشبه إلى واجهة سطر الأوامر (الحجج الكلمات الرئيسية تتوافق مع خيارات سطر الأوامر). وإليك مثال الاستخدام القصير:
>>> markowik استيراد
>>> markowik.convert ("بعض * تخفيض السعر * النص ..."، MX = ['الجداول'])
النص u'Some _markdown_ ... '
الصفحة Pragmas
GCW pragmas الصفحة يمكن تعيين في ملفات مصدر تخفيض السعر إلى البيانات الوصفية في شكل يحددها تمديد الفوقية PyMD:
>>> SRC = "" "ملخص: ملخص الصفحة
... التسميات: بعض والملصقات
...
... وهنا يبدأ صفحة * * ..
... "" "
>>> markowik.convert الطباعة (SRC، MX = ['ميتا'])
ملخص الصفحة #summary
#labels بعض، والعلامات
هنا يبدأ _page_ ..
لاحظ أن تمديد الفوقية لابد من تمكين صراحة، أي افتراضيا Markowik لا تعترف pragmas الصفحة
ما هو الجديد في هذا الإصدار:.
Markowik يدعم الآن (ويتطلب) PyMD ≥ 2.1. بجانب التغييرات الطفيفة API PyMD 2.1 أيضا لديه بعض التغييرات والتحسينات في عملية تحولها - لمزيد من التفاصيل، راجع كيف تم تعديل الاختبارات لPyMD 2.1.
ما هو الجديد في الإصدار 0.1.1:
تحسين الوثائق.
إصلاحات طفيفة.
المتطلبات:
بيثون
القيود:
GCW لا يمكن التعبير عن كل العلامات الممكنة في تخفيض السعر. وهذا يعني يجب أن تكون مكتوبة ملفات مصدر تخفيض السعر مع القيود التالية في الاعتبار.
عناوين المواقع في الروابط والصور:
عناوين المواقع المستخدمة للحصول على ارتباطات أو مصادر الصورة يجب أن تكون مطلقة ويجب أن يكون بروتوكول معين للحصول على الاعتراف من قبل GCW. على وجه الخصوص، يجب على أي URL يبدأ ب http: // أو https: //، أو ftp: //. Markowik إحباط عملية التحويل إذا وجد عناوين المواقع غير مطابقة هذه المتطلبات.
Typefacing في ارتباط أسماء:
GCW لا يدعم typefacing في أسماء الارتباط. على سبيل المثال يجعل GCW اسم الارتباط في [http://foo.com _Foo_] حرفيا، أي كما _Foo_. ومع ذلك، يعترف GCW typefacing في وصلات HTML، أي العلامة & lt؛ وأ href = & مثل، HTTP: //foo.com". وGT، _Foo_ العلامة & lt؛ / أ و GT. وأكد بشكل صحيح. لهذا السبب وصلات تخفيض السعر مع typefacing متداخلة مثل [* فو *] (http://foo.com) سيتم تحويلها إلى روابط HTML. ونتيجة لذلك، والعلامات صلة مع بعض الأحرف الخاصة التي يجب أن هرب في GCW باستخدام backtick (`) علامات سوف يؤدي أيضا إلى الروابط HTML.
متداخلة الفقرات:
GCW لا يدعم حقا الفقرات متداخلة متعددة (على سبيل المثال في القوائم أو blockquotes). Markowik يحاكي الفقرات متداخلة متعددة عن طريق فصل لهم مع العلامة & lt؛ ر / و GT. (والتي بصريا يقلد الفقرات ولكن لا كسر البيئة التعشيش).
الصور:
تخفيض السعر يسمح للتعبير عن النصوص البديلة وعنوان للصور. تركيب صورة GCW للا يدعم هذا. الطريقة الوحيدة للحفاظ على هذه النصوص هي استخدام العادي HTML العلامة & lt؛ IMG & GT. العلامات. الخيار --html صور عالية تمكن هذا الحل.
وثمة مسألة أخرى هي أن GCW تتوقع عناوين الصورة لينتهي مع ملحق صورة نوع الملف. Markowik يضيف ملحقات صورة مصطنعة إذا لزم الأمر، ليتم تغيير المثال http://foo.bar/image إلى http://foo.bar/image؟x=x.png.
الاختصارات:
GCW ديه أي العلامات لالاختصارات كما أنها لا تؤيد علامة HTML العلامة & lt؛ ابر & GT؛. Markowik يحول الاختصارات إلى العلامة & lt؛ فترة & GT؛ -elements أي نوع من يقلد الاختصارات (بطريقة محدودة بطبيعة الحال).
HTML:
أي HTML عادي تحدث في مصدر تخفيض السعر ينتهي حرفيا في GCW (باستثناء محتوى علامات على مستوى العمر). وهذا يعني يجب أن يحتوي على مصدر تخفيض السعر فقط HTML بدعم من GCW. ضمنا آخر هو أن عناوين المواقع المستخدمة في العلامات HTML عادي لا فحص للتوافق GCW. وبعبارة أخرى: عند استخدام HTML الخام كنت لوحدك!
لم يتم العثور على التعليقات