Sphinx 1.0 Yolda…
istihza.com‘u takip edenlerin artık gayet iyi bildiği gibi, sitedeki HTML ve PDF belgelerini oluşturmak için Sphinx adlı bir yazılımdan yararlanıyorum.
Bu yazılımı istihza.com’daki belgelendirme çalışmaları için kullanmaya ilk karar verdiğimde yazılımın benim amacım açısından en önemli eksikliği Türkçe desteğinin olmamasıydı. Bu yüzden ilk iş olarak Sphinx’i Türkçe’ye çevirdim. Böylece istihza.com’daki HTML belgelerinin arayüzü Türkçe desteğiyle okura sunulabilmiş oldu.
Sphinx’i Türkçe’ye ilk çevirdiğimde, bu yazılımı istihza.com’da kullanacağımı düşünerek, sadece kendi amacıma hizmet edecek şekilde Türkçeleştirmiştim. Daha sonra çeviriler üzerinde biraz daha çalışarak, bu çalışmayı Sphinx geliştiricilerine de göndermeye karar verdim.
Sphinx’in yakın zamanda yayımlanacak olan 1.0 sürümünde Türkçe dil desteği de olacak. Böylece Sphinx’i Türkçe belgelendirme çalışmalarında kullanmak isteyenler de, Türkçe arayüze sahip HTML belgeleri oluşturabilecek.
Sphinx’in şu anda beta aşamasında olan 1.0b1 sürümünün en son güncellemeleri de içeren halini indirmek için şu adresi ziyaret edebilirsiniz. Ama ben size kararlı sürümü beklemenizi tavsiye ederim. Kararlı sürüm yayımlandığında buradan duyuracağım.
Faydalı olması ümidiyle.
Loading ...
iyi günler sizin takipcinizim (twitter : hazal1) . ingilizcem olmasına rağmen sphinx sitesinden ne işe yaradığını tam çözemedim. ben Ruby dilinin belgelendirmesinde bunu nasıl kullanabilirim ? sizinki kadar detaylı ve güzel olmasa da Ruby için sizinki gibi tanıtım sitesi düşünüyorum.
Sphinx, herhangi bir belgelendirme çalışması için hazırlayacağınız HTML ve PDF belgelerini kolay bir şekilde oluşturmanızı sağlar. Sphinx’in tam olarak ne olduğunu anlamak için http://www.istihza.com/py2/restructuredtext.html ve http://www.istihza.com/py2/sphinx.html adresindeki makaleleri okumanızı tavsiye ederim. Eğer aklınıza takılan bir şey olursa kistihza [at] yahoo [nokta] com adresinden bana ulaşın. Size yardımcı olurum.