Markowik

Markowik Google Code Wiki Markdown biçimlendirilmiş mətn çevirir bir Python app edir.
Markowik onun Google Code Wiki (GCW) ekvivalentləri ən Markdown inşa çevirmək edə bilər. Bunun əvəzinə bütün dəstəyi dönüşüm siyahısı, Markowik test suite və şou halda nəzər edin.
Quraşdırma
Run:
markowik bərpa PIP
və ya:
easy_install markowik
Yardım çərçivəsində təsvir kimi siz də, quraşdırma olmadan Markowik istifadə edə bilərsiniz.
Command Line istifadə
Kömək çıxdı:
istifadə: markowik [h] [--mx [MX [MX ...]]] [--image-baseurl URL]
& Nbsp; [- html-şəkillər] [--encoding ENCODING] [--quiet]
& Nbsp; INFILE [OUTFILE]
Google Code Wiki Markdown Convert.
mövqeli dəlilləri:
& Nbsp; INFILE markdown fayl
& Nbsp; OUTFILE wiki faylı (default: stdout)
isteğe dəlilləri:
& Nbsp; h, bu yardım mesaj və çıxış göstərmək help
& Nbsp; - mx [MX [MX ...]] markdown uzantıları aktivləşdirmək üçün
& Nbsp; - image-baseurl URL bazası URL nisbi image yerlərdə başına üçün
& Nbsp; - html-şəkillər həmişə images üçün HTML istifadə
& Nbsp; - giriş və çıxış encoding ENCODING encoding (default: UTF8)
& Nbsp; - sakit aradan info mesaj
Markdown uzantıları fərdi uzantıları bir boşluqla ayrılmış olunmalıdır ki, istisna olmaqla, eyni Python Markdown (PyMD) command line alət kimi verilə bilər:
Giriş --mx masalar markowik def_list
Hal-hazırda desteklenen (yəni test) uzantıları abbr, masalar, və def_list var. Digər uzantıları ümumiyyətlə çox işləməlidir, lakin konvertasiya wiki mətn gözlənilməz nəticələrə gətirib bilər.
Seçim --html-şəkillər gəlincə, məhdudiyyətlər aşağıdakı şərhlər görürük.
Proqramatik istifadə
Markowik Python həyata keçirilir. markowik modulu funksiyası adlı çevirmək təmin edir. Semantically Bu (söz arqumentləri line variantları əmr uyğun) command line interface kimi. Burada qısa istifadə misal var:
>>> Idxal markowik
>>> Markowik.convert ("Bəzi * markdown * mətn ...", mx = ['masalar'])
u'Some _markdown_ mətn ... "
Page Pragmas
GCW səhifə Pragmas PyMD meta uzadılması ilə müəyyən edilmiş formatda meta data kimi Markdown mənbə faylları müəyyən edilə bilər:
>>> Src = "" "Xülasə: səhifə xülasə
... Labels: bəzi yazıları
...
... Burada * səhifəni başlayır ..
... "" "
>>> Çap markowik.convert (src, mx = ['meta'])
#summary səhifə xülasə
bəzi yazıları #labels

Burada _page_ başlayır ..
Meta uzadılması səhifə Pragmas tanımır default Markowik yəni aydın effektiv olmalıdır Qeyd edək ki,

Bu azad Yeni nədir.

< ul>

versiya 0.1.1 yeni nədir.

• Təkmilləşdirilmiş sənədlər
• Kiçik giderir.

tələblər

• Python

məhdudiyyətlər

• GCW Markdown mümkün olan bütün biçimlendirme ifadə edə bilməz. Bu Markdown mənbə faylları nəzərə aşağıdakı məhdudiyyətlər ilə yazılmalıdır deməkdir.

Links və Şəkillər
• URL:

Links və ya image mənbələri üçün istifadə
• URL mütləq olmalıdır və GCW tərəfindən tanınmış almaq üçün xüsusi protokol olmalıdır. Xüsusilə, hər hansı bir URL http ilə başlamaq lazımdır: //, https: //, və ya ftp: //. Bu tələblərinə uyğun olmayan URL bulursa Markowik dönüşüm aborts.


• Link Adlar Typefacing:
• GCW link adları typefacing bilmir. Məsələn GCW [http://foo.com _Foo_] sanki _Foo_ kimi yəni link adı göstərir. Lakin, GCW HTML links, yəni & lt typefacing tanıyır; a href = & quot; http: //foo.com" & Gt; _Foo_ & lt; / A & gt; düzgün olduğunu vurğuladı. [* Foo *] kimi iç-içə typefacing bu səbəb Markdown links üçün (http://foo.com) HTML links çevrilir. Nəticədə, backtick istifadə GCW qaçan olmalıdır müəyyən xüsusi simvol ilə link yazıları (`) markerlər də HTML links ilə nəticələnəcək.


• iç içə maddələr:
• həqiqətən çox nested ci maddələrdə bilmir GCW (məsələn, siyahıları və ya blockquotes ilə). Markowik a & lt ilə onları ayıran bir çox nested ci maddələrdə simüle; br / & gt; (Bu vizual mimics ci maddələrdə, lakin yuva mühit qırmaq deyil).


• Şəkillər:
• Markdown images üçün alternativ və adı mətnləri ifadə etməyə imkan verir. GCW image sintaksis bu bilmir. bu mətnləri qorumaq üçün yeganə yol düz HTML & lt istifadə etmək; img & gt; tags. seçim --html-images bu çözüm imkan verir.
• Digər məsələ GCW image URL'leri bir resim fayl növü uzadılması ilə bitirmək üçün gözləyir ki. Zəruri hallarda instansiya http://foo.bar/image üçün http://foo.bar/image?x=x.png. Dəyişdirilir üçün Markowik, süni image uzantıları edir


• İxtisarlar:
• GCW ixtisarlar heç bir biçimlendirme var, nə də bu HTML tag & lt dəstək; abbr & gt ;. Markowik & lt ixtisarlar çevirir; span & gt; elementləri (əlbəttə məhdud moda) mimics ixtisarlar cür
.

• HTML:
• bir Markdown mənbəyi meydana gələn hər hansı bir düz HTML (span səviyyəli tags məzmunu istisna olmaqla) GCW sözün başa çatır. Bu Markdown mənbəyi yalnız GCW tərəfindən dəstəklənir HTML olmalıdır deməkdir. Digər dolayısı düz HTML tags istifadə URL GCW uyğunluğu yoxlanılır deyil ki. Başqa sözlə: xam HTML istifadə edərkən öz var
!