Markowik

Markowik Google Code Wiki Markdown biçimlendirilmiş metni dönüştürür bir Python uygulaması.
Markowik onun Google Code Wiki (GCW) eşdeğerleri en Markdown yapıları dönüştürmek mümkün. Bunun yerine tüm desteklenen dönüşümleri listeleme, Markowik test paketi ve gösteri durumda bir göz atın.
Kurulum
Koşmak:
markowik yüklemek pip
veya:
easy_install markowik
Contribute altında açıklanan şekilde, kurulum olmadan Markowik kullanabilirsiniz.
Komut Satırı Kullanımı
Yardım çıkışı Gönderen:
kullanımı: markowik [-h] [--mx [MX [MX ...]]] [--image-baseurl URL]
& Nbsp; [- html görüntüleri] [--encoding ENCODING] [--quiet]
& Nbsp; INFILE [ÇIKDOSYA]
Google Code Wiki Markdown dönüştürün.
konumsal argümanlar:
& Nbsp; INFILE markdown dosyası
& Nbsp; ÇIKDOSYA wiki dosyası (varsayılan: stdout)
İsteğe bağlı argümanlar:
& Nbsp; -h, bu yardım iletisini ve çıkış göstermek help
& Nbsp; - mx [MX [MX ...]] markdown uzantıları etkinleştirmek için
& Nbsp; - görüntü baseurl URL taban URL göreli görüntü yerlere prepend
& Nbsp; - html görüntüleri daima görüntüler için HTML kullanmak
& Nbsp; - giriş ve çıkış kodlama KODLAYAN kodlama (varsayılan: UTF8)
& Nbsp; - sessiz devre dışı bilgi mesajları
Markdown uzantıları tek tek uzantıları bir boşlukla ayrılmış gerektiğini hariç, benzer Python Markdown (PyMD) komut satırı aracı olarak verilebilir:
INPUT --mx tabloları markowik def_list
Şu anda desteklenen (yani test) uzantıları kısalt, tablolar ve def_list vardır. Diğer uzantıları genellikle çok çalışması gerektiğini, ancak dönüştürülen wiki metinde beklenmedik sonuçlar olabilir.
Seçeneği --html görüntüleri ile ilgili, Sınırlamalar aşağıda açıklamalara bakınız.
Program Kullanımı
Markowik Python'daki uygulanmaktadır. markowik modülü adında bir işlevi dönüştürme içerir. Semantik o (anahtar kelime argümanlar satırı seçeneklerini komuta karşılık) komut satırı arayüzüne benzer. İşte kısa bir kullanım örneği var:
>>> Import markowik
>>> Markowik.convert ("Bazı * markdown * metin ...", mx = ['tabloları'])
u'Some _markdown_ metin ... '
Sayfa Pragmas
GCW sayfa pragmas PyMD meta uzantısı tarafından tanımlanan biçimde meta veri olarak Markdown kaynak dosyalarında ayarlanabilir:
>>> Src = "" "Özet: sayfa özeti
... Etiketler: bazı etiketler
...
... İşte * * sayfasını başlar ..
... "" "
>>> Print markowik.convert (src, mx = ['meta'])
#summary sayfa özeti
Bazı etiketleri #labels

İşte _page_ başlar ..
Meta uzatma sayfa pragmas tanımıyor varsayılan Markowik tarafından yani, açıkça etkin olması gerektiğini unutmayın

Bu sürümde Yeni nedir:.

< ul>

sürüm 0.1.1 yeni nedir:.

• Geliştirilmiş dokümantasyon
• Küçük düzeltmeler.

Gereksinimler :

• Python

Sınırlamalar :

• GCW Markdown mümkün tüm biçimlendirme ifade edemez. Bu Markdown kaynak dosyaları akılda aşağıdaki sınırlamalar ile yazılmalıdır anlamına gelir.

Bağlantılar ve Görüntüler
• URL'ler:

Bağlantıları veya görüntü kaynakları için kullanılan
• URL'leri mutlak olması ve GCW tarafından tanınan almak için belirli bir protokol olması gerekir. Özellikle, herhangi bir http ile başlamalıdır: //, https: // veya ftp: //. Bu şartları uymayan URL'leri bulursa Markowik dönüşüm iptal.


• Bağlantı Adları Typefacing:
• GCW bağlantı adlarında typefacing desteklemiyor. Örneğin GCW [http://foo.com _Foo_] anlamıyla, _Foo_ olarak yani link adını vermektedir. Ancak, GCW HTML bağlantıları, yani & lt typefacing tanır; a href = & quot; http: //foo.com" & Gt; _Foo_ & lt; / A & gt; düzgün vurgulanmaktadır. [* Foo *] gibi iç içe typefacing bu nedenle Markdown bağlantıları için (http://foo.com) HTML bağlantıları dönüştürülür. Sonuç olarak, backtick kullanarak GCW kaçan gereken bazı özel karakterler ile bağlantı etiketleri (`) belirteçleri de HTML bağlantıları neden olur.


• İç içe paragraflar:
• gerçekten birden fazla iç içe paragraf desteklemiyor GCW (örn listeleri veya blockquotes olarak). Markowik & lt ile ayırarak birden fazla iç içe paragraf simüle; br / & gt; (Ki görsel taklit paragraflar ama yuvalama ortamı sonu yok).


• Görüntüler:
• Markdown görüntüler için alternatif ve başlık metinleri ifade etmesini sağlar. GCW görüntü sözdizimi bu desteklemiyor. Bu metinleri korumak için tek yolu düz HTML & lt kullanmaktır; img & gt; etiketleri. seçeneği --html-görüntüler bu geçici çözüm sağlar.
• Bir diğer konu GCW görüntü URL'ler bir görüntü dosya türü uzantısı ile bitmesini beklemektedir olmasıdır. Gerekirse örnek http://foo.bar/image için http://foo.bar/image?x=x.png. Değiştirildiğinde için Markowik, yapay görüntü uzantıları ekler


• Kısaltmalar:
• GCW kısaltmalar için hiçbir biçimlendirme vardır ne de HTML etiketini & lt desteklemiyor; kısalt & gt ;. Markowik & lt kısaltmalar dönüştürür; span & gt; -elemanları (tabii sınırlı şekilde) taklit kısaltmalar tür
.

• HTML:
• Markdown kaynağı meydana gelen herhangi bir düz HTML (yayılma düzeyi etiketleri içeriği hariç) GCW anlamıyla biter. Bu Markdown kaynağı sadece GCW tarafından desteklenen HTML içermelidir anlamına gelir. Başka bir anlamı düz HTML etiketleri kullanılan URL'ler GCW uyumluluk için işaretli olmadığından emin değildir. Başka bir deyişle: ham HTML kullanırken kendi
!