Kullanarak bir fiyat indirimi yerine RST ile Sfenks

SORU

18 Mart 2010, PERŞEMBE

Kullanarak bir fiyat indirimi yerine RST ile Sfenks

İLK nefret ederim ama Sfenks seviyorum. Sfenks reStructuredText yerine fiyat indirimi okuyan bir yolu var mı?

CEVAP

21 Mart 2010, Pazar

"Uygun fiyat indirme için docutils parser bir yaz olacağını" yapmak için bir yol. (Artı çözümleyici seçmek için Sfenks bir seçenek.) Bu güzelliği tüm docutils çıkış biçimleri için anında destek (ama benzer bir fiyat indirimi araçlar zaten en var gibi değer veriyorsun, değil) olurdu. Yollar sıfırdan bir ayrıştırıcı geliştirme olmadan bu yaklaşım için:

Ve bir hile yazabilirsin "" o Pandoc fiyat indirimi İLK dönüştürmek ve İLK parser bunu geçirmek için kullanır: -) çözümleyici.
Fiyat indirimi -^ varolan kullanabilirsiniz . Ayrıştırıcı XML ve sonuç (XSLT kullanarak?) dönüşümü docutils şema.
Özel bir işleyici tanımlar ve docutils inşa düğüm ağaç sağlayalım existing python markdown parser bazı alabilirsin.
Mevcut İLK okuyucu, her şeyi bir fiyat indirimi alakasız söküp atıp, farklı sözdizimi (this comparison yardımcı olabilir) değiştirme çatalı...
EDİT: yoğun bir şekilde test etmeye hazır değilsen bu yolu tavsiye etmem. Fiyat indirimi zaten çok kurnazca farklı lehçelerde ve bu muhtemelen henüz başka bir... neden olur

GÜNCELLEME: https://github.com/sgenoud/remarkdown docutils için fiyat indirme okuyucusudur.Yukarıdaki kısayolları herhangi sürmedi ama Parsley PEG dilbilgisi peg-markdown ilham kullanır. Doesn't yet yönergeleri destekler.

tümdoğduğunda bir fiyat indirimi uzantıları Sphinx directives and roles temsil etmek için icat gerekir. Hepsine gerek olmayabilir, .. toctree:: gibi bazı temel [*].
Bu bence en zor kısmıdır. Sfenks uzantıları önce reStructuredText zaten bir fiyat indirimi daha zengin oldu. Hatta ağır genişletilmiş bir fiyat indirimi, pandoc's gibi çoğu kez ilk özellik kümesinin bir alt kümesidir. Çok büyük bir alanı kapsayacak.

Uygulama açısından en kolay şey, herhangi bir docutils rolü/Direktif ifade etmek için genel bir yapı katıyor. Sözdizimi ilham için bariz bir aday

Pandoc öznitelik sözdizimi ve diğer bazı uygulamaları zaten birçok satır içi ve blok yapıları üzerinde izin. Örneğin `foo`{.method} ->`foo`:method:.
/XML HTML. Sadece ekleme docutils bu kludgiest yaklaşım <span class="method">foo</span> iç XML!
Yönergeler için YAML gibi bir şey mi?

Ama böyle genel bir eşleme fiyat indirimi gibi en çözüm olmayacak... Şu anda en aktif yerlerden fiyat indirimi uzantıları görüşmek üzere https://groups.google.com/forum/#!topic/pandoc-discuss, https://github.com/scholmd/scholmd/

Bu da bir şekilde genişletmeden fiyat indirimi bir çözümleyici yeniden kullanabilirsiniz. Pandoc tekrar custom filtes destekleyici belge dönüştürme isviçre çakısı olarak ününü kadar yaşıyor. Eğer docutils okuyucu/transformers/yazarlar ve pandoc okuyucuları arasında genel bir köprü inşa etmek için denemek istiyorum bu yaklaşımın olsaydım (aslında,//yazar filtreler. İhtiyacınız olandan daha fazla değil ama ödeme sadece fiyat indirme Sfenks daha geniş olurdu.)

Alternatif çılgın bir fikir: fiyat indirme Sfenks işlemek için genişletme yerine, reStructuredText (çoğunlukla) bir fiyat indirimi bir üst destek uzatın! Güzellik herhangi bir Sphinx olarak kullanmak mümkün olacak, ama en fiyat indirimi içerik yazabilir.

Zaten considerable syntax overlap; en sözdizimi uyumlu değil kesinlikle bağlantı var. Bence eğer siz ekleyin desteklemek için RST için fiyat indirme bağlantıları ###tarzı başlıkları ve değişim varsayılan `backticks` rol için hazır, ve belki de değiştirmek girintili blok yani literal (İLK destekler > ... tırnak nowdays), alacaksın bir şey kullanılabilir destekleyen en fiyat indirimi.

Bunu Paylaş: