در Markowik یک برنامه پایتون که مدل های نشانه گذاری متن فرمت شده به گوگل کد ویکی تبدیل شده است.
Markowik قادر به تبدیل اکثر سازه مدل های نشانه گذاری به گوگل کد ویکی (GCW) معادل آن است. به جای فهرست همه تبدیل پشتیبانی، لطفا نگاهی به مجموعه تست Markowik و مورد نشان می دهد آن است.
نصب
را اجرا کنید:
تصویر در تصویر markowik نصب
و یا:
easy_install markowik
شما همچنین می توانید Markowik بدون نصب استفاده کنید، به عنوان زیر مشارکت در توصیف کرد.
خط فرمان طریقه استفاده
از خروجی کمک:
طریقه استفاده: markowik [-h] [--mx [MX [MX ...]]] [URL --image-baseurl]
و nbsp؛ [- HTML-تصاویر] [--encoding رمزگذاری] [--quiet]
& nbsp؛ در INFILE [OUTFILE]
تبدیل مدل های نشانه گذاری به گوگل کد ویکی.
استدلال موضعی:
را لمس کنید و. INFILE فایل مدل های نشانه گذاری
& nbsp؛ در OUTFILE فایل ویکی (به طور پیش فرض: STDOUT)
استدلال اختیاری:
& nbsp؛ در -h، --help این ارسال و خروج کمک نشان می دهد
و nbsp؛ - MX [MX [MX ...]] الحاقات مدل های نشانه گذاری به فعال
و nbsp؛ - URL تصویر baseurl پایه URL به prepend به نقاط تصویر نسبی
و nbsp؛ - HTML-تصاویر همیشه HTML برای تصاویر استفاده
و nbsp؛ - را پشتیبانی می کند پشتیبانی می کند پشتیبانی می کند از ورودی و خروجی (به طور پیش فرض: UTF8)
و nbsp؛ - آرام پیام های اطلاعات غیر فعال کردن
پسوند مدل های نشانه گذاری ممکن است به طور مشابه به عنوان به پایتون مدل های نشانه گذاری (PyMD) ابزار خط فرمان، با این تفاوت که پسوند فرد باید توسط یک فاصله از هم جدا شده است:
markowik جداول INPUT --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 می توانید تمام نشانه گذاری ممکن است در مدل های نشانه گذاری بیان نیست. این به این معنی فایل های منبع مدل های نشانه گذاری باید با محدودیت های زیر را در ذهن نوشته شده است.
URL ها در پیوندها و تصاویر:
آدرس ها استفاده شده برای لینک یا منابع تصویر باید مطلق و باید یک پروتکل خاص به توسط GCW به رسمیت شناخته اند. به طور خاص، هر URL باید با http: //، https: // را، یا ftp: //. Markowik بینتیجه میگذارد تبدیل اگر آن را پیدا کرد URL ها به این نیاز تطبیق نیست.
Typefacing در نام لینک:
GCW کند typefacing در نام لینک را پشتیبانی نمی کند. به عنوان مثال GCW ارائه نام لینک در [http://foo.com _Foo_] به معنای واقعی کلمه، یعنی به عنوان _Foo_. با این حال، GCW typefacing در لینک های HTML، یعنی و LT به رسمیت می شناسد. عکاس هنگام عکسبرداری = & quot؛ را 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 انتظار URL های تصویر با فرمت تصویر نوع فایل پایان. 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. مفهوم دیگر این است که URL های مورد استفاده در تگ های HTML ساده برای سازگاری GCW بررسی نیست. به عبارت دیگر: هنگامی که با استفاده از HTML خام شما را در خود هستند!
نظر یافت نشد