Yaklaşık bir hafta önce piyasaya çıkan “Herkes İçin Python” adlı kitabımız hakkında Sayın Uğur Özyılmazel bir inceleme yazısı yazmış.
İnceleme yazısına http://vigoyla.blogspot.com/2010/02/python-kitab.html adresinden ulaşabilirsiniz.
Kitabı okuyup incelediği için Uğur Özyılmazel’e teşekkür ederim.
Bildiğiniz gibi istihza.com‘daki belgeler reStructuredText biçiminde hazırlanıyor. Bu belgeleri farklı biçimlere dönüştürmek için ise Sphinx adlı bir yazılımı kullanıyorum.
Özellikle reStructuredText, belgelendirme çalışmalarıyla uğraşanlar için çok önemli bir araç. Hatta Python programlama dilinin resmi sitesi olan www.python.org‘daki belgelendirme çalışmaları da reStructuredText biçimi kullanılarak yapılıyor. Python geliştiricileri de reStructuredText biçiminde hazırladıkları belgeleri Sphinx adlı yazılım yardımıyla HTML’ye çeviriyorlar. Zaten Sphinx yazılımının geliştiricisi olan Georg Brandl da Python topluluğunun etkin bir üyesi…
Elbette bu önemli konuya istihza.com’da yer vermemek olmazdı. O yüzden Python 2.x bölümüne “reStructuredText ve Sphinx” adlı yeni bir konu ekledim.
Bu konu çok geniş olduğu için henüz tamamlanmadı. Konuları yazdıkça siteye ekleyeceğim. Şimdilik “reStructuredText” ile bir giriş yaptım.
Yeni konu eklemenin yanısıra, Python 2.x bölümünde varolan belgeleri de gözden geçirmeye devam ediyorum. Tabii buna bağlı olarak PDF belgeleri de sürekli olarak tazeleniyor. Yakında istihza.com’da bunun dışında yenilikler de göreceksiniz.
Sevgiler,
istihza
Böyle bir ihtiyaç var mı bilmiyorum, ama yine de elimizin altında bulunsun istedim ve dileyenler için iki adet istihza.com tabelası hazırladım. Birinci tabelamız şu:
Bu tabelayı sitenize eklemek için şu kodu kullanabilirsiniz:
<a href="http://www.istihza.com" target="_blank"><img title="Python Programlama Dili için Türkçe Kaynak" src="http://img85.imageshack.us/img85/6681/istihzakodgorunumu.png" border="0" alt="Python Programlama Dili için Türkçe Kaynak" /></a>
İkinci tabelamız ise şu:
Bu tabelanın kodları da şöyle:
<a href="http://www.istihza.com" target="_blank"><img title="Python Programlama Dili için Türkçe Kaynak" src="http://img64.imageshack.us/img64/2890/istihzayalin.png" border="0" alt="Python Programlama Dili için Türkçe Kaynak" /></a>
Tabelalarımız hayırlı olsun! Bu arada, “Ben daha iyisini yaparım,” diyenlere kapımız her zaman açık… 
Sevgili Arkadaşlar,
Birkaç gün önce duyurduğumuz Python kitabı bugün itibariyle kitapçılardaki yerlerini aldı.
Kitabın duyurusu için http://www.istihza.com/blog/python-kitab.html/ adresini, kitap hakkında bazı teknik ayrıntıları öğrenmek için ise http://www.istihza.com/blog/python-kitabi-hakkinda-teknik-bilgiler.html/ adresini ziyaret edebilirsiniz.
Kitabı yayımlayan KODLAB Yayınevi’ne ve “Math Modülü” adlı makaleyi kitaba almama izin veren Kürşat Örsel’e teşekkür ederim.
Bayinizden ısrarla isteyiniz!..
istihza.com‘da yer alan Python 2.x ve Tkinter 2.x bölümlerinin KODLAB Yayınları‘ndan basılı kitap olarak çıkacağını duyurmuştum. Kitap birkaç gün önce internet mağazalarında satılmaya başlandı. Cuma günü de bu kitabı kitapçıların raflarında görmeye başlayacağız…
Dilerseniz şimdi size kitap hakkında biraz teknik bilgi vereyim.
Bildiğiniz gibi, istihza.com’daki belgeleri reStructuredText biçiminde hazırlıyorum. Bu sayede tek bir biçimde hazırladığım belgeleri daha sonra rahatlıkla HTML ve PDF biçimlerine dönüştürerek okurlara sunabiliyorum. Yazıları reStructuredText olarak hazırlamak sitenin güncellenmesi açısından da bana çok büyük bir kolaylık sağlıyor. reStructuredText’in sade ve temiz yapısı sayesinde asıl işe odaklanabiliyorum.
Dediğim gibi, reStructuredText (ya da başka bir ifadeyle “rst”) biçiminde hazırlanmış belgeleri başka biçimlere çevirmek mümkün olabiliyor. Ben bu çevirme işi için, Python geliştiricilerinin de python.org’daki belgeleri hazırlamada kullandığı Sphinx adlı yazılımdan faydalanıyorum. Bu yazılımı, belgelendirme ile uğraşan herkese gönül rahatlığıyla önerebilirim…
KODLAB Yayınları bana istihza.com’daki Python 2.x ve Tkinter bölümlerini kitaplaştırmayı teklif ettikten sonra benden belgeleri .doc biçiminde istedi. Benim Windows bilgisayarlara erişimim son derece kısıtlı olduğu için elbette benim bu belgeleri doğrudan .doc biçiminde hazırlamam mümkün değildi. Ama OpenOffice’te hazırlanan .odt belgeleri .doc olarak da kaydedilebildiği için bu durum ciddi bir sorun teşkil etmedi. İşin daha da güzel tarafı, docutils paketi içinde rst2odt adlı bir betik bulunuyor. Bu betik yardımıyla reStructuredText olarak hazırlanmış belgeleri tek bir komutla .odt’ye çevirebiliyoruz. Bu belgeleri .odt’ye çevirdikten sonra da belgeyi OpenOffice ile açıp başlık, kod bloğu, paragraf ve benzeri özel alanlara istediğimiz stilleri uygulamak mümkün.
OpenOffice bu .odt belgelerini .doc biçiminde de kaydedebildiği için bunları KODLAB’ın istediği şekilde kendilerine teslim ettim. Yalnız bu noktada şöyle bir durum ortaya çıktı. Ben elimdeki rst belgelerini rst2odt betiği yardımıyla .odt’ye dönüştürdükten ve gerekli stilleri .odt belgesine uyguladıktan sonra metni son haline getirmek için doğrudan .odt belgeleri üzerinde çalıştım. Bu sayede epey zaman kazanmış oldum. Çünkü eğer yapacağım değişiklikleri doğrudan rst üzerinde yapsaydım bu belgeleri tekrar tekrar .odt’ye dönüştürüp, tekrar tekrar gerekli stilleri uygulamam gerekecekti.
Bu nedenle KODLAB’a teslim ettiğim belgelerle istihza.com üzerindeki belgeler arasında bazı metin farklılıkları ortaya çıkmış oldu. Örneğin Python 2.x bölümündeki Fonksiyonlar ve Modüller kısımlarını KODLAB’a teslim ettiğim belgelerde baştan aşağı yeniden yazdım. Ancak istihza.com takipçilerinin endişelenmesine hiç gerek yok, çünkü değiştirdiğim .odt belgelerini tekrar rst’ye dönüştürüp istihza.com’a ekledim ve eklemeye devam ediyorum. Ancak ne yazık ki “odt2rst” diye bir betik bulunmuyor… Aslında bu ada sahip bir betik var, ama bu betik henüz geliştirme aşamasında olduğu için doğru düzgün çalışmıyor. O yüzden .odt belgelerini .rst’ye elle çevirmem gerekiyor. Bu da zaman alıcı bir işlem olduğu için beni biraz zorluyor.
Bu arada hatırlatmama gerek var mı bilmiyorum, ama söyleyeyim: KODLAB’dan çıkacak Python kitabının içindeki bilgilere ücretsiz olarak istihza.com üzerinden erişebilmeye devam edebileceksiniz. Ben istihza.com’daki bu belgeleri eskisi gibi güncellemeye devam edeceğim. Yukarıda bahsettiğim teknik nedenden ötürü site ve kitap arasında oluşan farklılık çok büyük değil. Zaten ben bu değişiklikleri istihza.com’a aktarıyor olduğum için endişelenmenizi gerektirecek bir durum yok.
Bu arada, kitabı hazırlama sürecinde Samsun Ondokuz Mayıs Üniversitesi Bilgisayar Mühendisliği Bölümü’nden, istihza.com’daki belgeleri üniversitede verilecek Python derslerinde kullanmak için izin isteyen bir mektup aldım. Elbette ben de kendilerine sitedeki belgeleri istedikleri gibi indirip kopyalayabileceklerini söyledim. Ancak bildiğiniz gibi, istihza.com’daki konuları hazırlarken oldukça “teklifsiz” ve “rahat” bir dil kullanıyorum. Bu belgeleri KODLAB’a teslim etmek üzere hazırlarken bazı yerlerde bu rahatlık meselesinin dozunu biraz kaçırmış olduğumu farkettim… Ben belgeleri KODLAB’ın istediği şekilde hazırlayıp kendilerine teslim ettiğimde KODLAB da bu konuda beni uyardı. Yukarıda dediğim gibi, kitabın üniversite çevrelerinde kullanılma olasılığı da olduğu için, metinlerdeki ses tonunu bir miktar ciddileştirdim. Kitap için yaptığım değişiklikleri istihza.com’a da aktaracağım için, yakın zamanda bu ses tonu istihza.com’a da yansıyacak. Ancak elbette “ciddi” derken “asık suratlı”yı kastetmiyorum. istihza.com’daki bilgiler yine olabildiğince eğlenceli ve herkesin anlayabileceği tarzda sunulmaya devam edecek.
Gelelim kitabın içeriğine…
Sevgili arkadaşlar, istihza.com’daki bütün bilgileri topladığınız zaman ortaya 1000 sayfaya yakın bir belge bütünü çıkıyor. KODLAB’a teslim ettiğim Python kitabında istihza.com’daki Python 2.x ve Tkinter bölümleri yer alıyor. Ayrıca bu iki bölüme ek olarak, sitede “Özel Konular” başlığı altında sunduğumuz bazı makalelere de yer verdim. Ancak bu makalelerin hepsini kitaba almadım. Çünkü KODLAB’a teslim ettiğim kitap şu haliyle bile tam 544 sayfa oldu. Eğer her şeyi kitaba almaya kalksaydım, ortaya hem tuğla gibi, hem de KODLAB açısından haddinden fazla maliyetli bir kitap çıkmış olacaktı…
Bilirsiniz, eskiden kitap yazarı denince akla oldukça fantastik bir şey gelirdi. Bundan birkaç yıl öncesine kadar kitap yazarları biz okurlar için ulaşılmaz bir konumdaydılar. Yazar kitabı hazırlar ve köşesine çekilirdi. Kitap hakkındaki sorularımız, şüphelerimiz konusunda çaresizdik. Ama bu Python Kitabı’nda durum böyle değil. Kitabın yazarına nereden ulaşacağınızı biliyorsunuz… Kitapta gördüğünüz eksiklikleri ve önerilerinizi bildirmek konusunda yalnız ve çaresiz değilsiniz. Kitapla ilgili herhangi bir sorunuz olması durumunda istihza.com’a başvurabilir, kistihza[at]yahoo[nokta]com adresinden bana ulaşabilirsiniz. Bu arada istihza.com’u da takip etmeyi unutmayın. Çünkü kitap dediğiniz şey statik bir ortamdır. istihza.com ise dinamik…
Dediğim gibi, kitabın içindeki bilgilere (ve hatta daha fazlasına) istihza.com üzerinden ücretsiz olarak da erişebilmeye devam edeceksiniz. Bu kitabı çıkarmamızın amacı kitaptan okumayı sevenlerin isteğine yanıt verebilmek. Eğer kitabı satın alırsanız istihza.com’u maddi olarak desteklemiş olursunuz, ancak tabii ki böyle bir zorunluluk asla söz konusu değil. Kitabı satın almak istemiyor olabilirsiniz, maddi gücünüz kitabı almaya yetmiyor olabilir, ya da bambaşka sebepleriniz olabilir. Hiçbirine itirazım yok. Bu durumda istihza.com’daki bilgileri site üzerinden veya PDF biçiminde indirerek ücretsiz olarak takip etmeye devam edebilirsiniz. Her zaman dediğim gibi, istihza.com projesinin amacı bilgiye erişimi olabildiğince kolaylaştırmaktır. İnsanları kitabı satın almaya yönlendirmek için istihza.com’un geri bırakılması, güncellemeden kaçınılması kesinlikle söz konusu değil. Önümüzdeki günlerde istihza.com gümbür gümbür büyümeye devam edecek…
Bu kitapla ortaya güzel ve faydalı bir şey çıkarmaya çalıştık. Python programlama diliyle ilgilenen herkesin bu kitapta kendilerine uygun bir şeyler bulabileceğini ümit ediyorum. Böyle bir projeye omuz verdiği için KODLAB’a da teşekkür ediyorum.
Daha önce de bahsettiğim gibi, istihza.com‘un temeli 18 Eylül 2007 tarihinde PLO Vikisi’nde atılmıştı. Bu tarihten sonra istihza.com’un nüvesini oluşturan bilgiler zaman içinde hızla genişledi ve nihayet bugünlere gelindi… istihza.com’un tarihçesi hakkında kısa bir bilgi edinmek için http://www.istihza.com/blog/istihzacoma-dair.html/ adresindeki yazımızı inceleyebilirsiniz.
istihza.com’un yayın hayatı sırasında okur isteklerine olabildiğince cevap vermeye çalıştım. Özellikle burada yayımlanan bilgilerin en kolay ve en verimli bir şekilde okura ulaşabilmesi için olanca gücümle çabaladım. Amacım hep ortaya modern ve yenilikleri takip eden bir bilgi kaynağı çıkarabilmekti.
Yukarıda bahsedilen amacı gerçekleştirebilmek için istihza.com’daki bilgileri okura hem HTML, hem de PDF biçiminde sundum. Böylece hem farklı zevklere hitap etmeyi, hem de bilgiye erişimde kolaylık sağlamayı hedefledim. Dediğim gibi, bu çalışmalar hep okurdan gelen talepleri karşılama gayesi güdüyordu…
Siteyi takip edenlerin bildiği gibi, istihza.com’un yayın hayatı boyunca her şey güllük gülistanlık olmadı… Bu süre içinde ne yazık ki ağızda metalik tat bırakan bazı olaylar da yaşadık. Bu olayların memnuniyet verici yanı ise Python ve özgür yazılım topluluğundan arkadaşların desteğini arkamda görmek oldu. Bu bakımdan, yalnız olmadığımı hissettiren bütün arkadaşlarıma teşekkür ederim.
Dediğim gibi, istihza.com’un en önemli itici gücü, takipçilerden gelen istekler oldu hep… Uzunca bir süredir gerek e.posta yoluyla olsun, gerek başka ortamlarda olsun, istihza.com takipçileri, sitedeki bilgilerin kitap olarak da yayımlanması konusundaki isteklerini bana iletiyorlardı. Elbette bu fikir benim de arzu ettiğim bir şeydi. Ancak bu fikrin, istihza.com’un sürekliliğine zarar vermeden gerçekleşmesini istiyordum.
istihza.com’daki bilgileri kitaplaştırmak için ne yapabilirim acaba diye düşünürken sevindirici haber KODLAB Yayınları‘ndan geldi…
Bundan birkaç hafta önce KODLAB Yayınları’nın sahibi Sayın Hüseyin Üstünel’den bir e.posta aldım. Kendisi yaşanan tatsız olaylarla KODLAB Yayınları’nın herhangi bir alakası olmadığını, daha önceden çıkarılması tasarlanan kitabın istihza.com’dan izinsiz kopyalandığını da sonradan öğrendiklerini anlattı. Hüseyin Bey bana gönderdiği e.postada, istihza.com’dan alınan bilgileri benim adımla kitaplaştırmayı da teklif etti. Ben de kendisine, Talat Uyarer tarafından istihza.com’dan izinsiz kopyalanan bilgilerin alındığı tarihten bu yana siteye pek çok yeni bilgi eklendiğini, ayrıca Talat Uyarer’in istihza.com’dan izinsiz kopyaladığı bilgiler üzerinde ne tür değişiklikler yaptığını bilmediğimi söyledim. Dolayısıyla kitabı sadece üzerindeki ismi değiştirerek yayımlamak doğru olmayacaktı. Bu yüzden Hüseyin Bey’e bilgileri yeniden düzenledikten sonra kitaplaştırma işine girmeyi önerdim. O da bu önerimi kabul etti. Ardından KODLAB ile istihza.com arasında bir anlaşma imzaladık ve kitap üzerinde çalışmaya başladık. Çalışmalarımız birkaç gün önce sona erdi ve ortaya şöyle şık bir şey çıktı:
Kitap, eğer bir aksilik olmazsa iki-üç gün içinde kitap raflarındaki yerini alacak. Bu arada elbette istihza.com da varolmaya ve güncellenmeye devam edecek. Bu kitaptaki bilgilere istihza.com üzerinden de erişebileceksiniz. Bu kitap projesi, Python programlama dilini öğrenmek isteyenlerin bilgiye daha kolay erişebilmesini sağlamak ve uzun bir süredir bana iletilen bir isteği yerine getirmek için hayata geçirildi. Bu kitabı yayımlayan ve kitaptaki bilgilerin istihza.com üzerinden paylaşılmasına izin veren KODLAB Yayınları’na teşekkür ederim.
Bu süreçte teşekkür etmek istediğim bir arkadaşım daha var: O da sevgili dostum Kürşat Örsel. Bildiğiniz gibi, kendisi istihza.com’daki en önemli makalelerden biri olan “Math Modülü”nü yazan kişidir. Python kitabını hazırlarken Kürşat Örsel’i aradım ve bu makaleyi kitaba alabilmek için kendisinden izin istedim. O da sağolsun beni kırmadı ve makaleyi kitaba almamıza müsaade etti. Kendisine nezaketi için bir kez daha teşekkür ederim.
Aslında özellikle kitabın teknik detayları ve içeriğiyle ilgili söylemek istediğim başka şeyler de var. Ama onları da bu yazıda ifade etmeye kalkışırsam yazı epey uzayacak. O yüzden bu da başka bir yazının konusu olsun…
Düzenleme: Python kitabı ile ilgili teknik bilgiler için bkz.: http://www.istihza.com/blog/python-kitabi-hakkinda-teknik-bilgiler.html/
Firefox tarayıcısıyla istihza.com’da bazı sayfaları görüntülemeye çalışırken tarayıcının bazen şöyle bir hata verdiğini farkettim:
Content Encoding Error
The page you are trying to view cannot be shown because it uses an invalid or unsupported form of compression.
Please contact the website owners to inform them of this problem.
Bu hatayı sadece Firefox veriyor. Google Chrome, Galeon ve IE gibi tarayıcıların bu hatayı verdiğine rastlamadım. İnternette araştırdığıma göre Firefox bu hatayı başka pek çok sitede de veriyormuş…
Bu sorunu gidermek için Firefox’un önbelleğini temizlemeyi deneyebilirsiniz. Bu işlem sorunun çözülmesini sağlıyor… İşin ilginci bu sorun sadece Firefox 3′te var. Bu tarayıcının eski sürümlerinde böyle bir sorun yok.
Loading ...
Son Yorumlar