[Pardus-kullanicilari] RST belgeleme sistemi hakkindaki sorularım.

[Server Acim]

Değerli Pardus-Kullanıcıları Listesi Üyeleri,
Bu listeyi "pardus*kullanıcıları"nın yanı sıra, "pardus-geliştiricileri"nin
de takip etmekte olduğunu bildiğimden, sevgili Anıl ÖZBEK'in mail adresine
özelden göndermiş olduğum elektronik postanın bir kopyasını, liste yapısına
uyarlayarak yeniden gönderiyorum.



Sevgili Pardus-Kullanıcıları Listesi Üyeleri,
> Son zamanlarda "geliştirici" listesinde konu edilen ve "geliştirici
> belgeleri" hazırlamakta kullanılması sevgili Onur KÜÇÜK tarafından önerilen
> RST belgeleri hazırlama konusu ve bu teknik çok ilgili çekti. Bu arada Anıl
> ÖZBEK'in oluşturmuş olduğu belge için de ayrıca kendisini tebrik ediyorum.
>

> "Hangi belge?" diye soracaklar için belgenin linklerini de vereyim.
>
> Belgenin RST dosya biçimi:
> http://ozbekanil.googlepages.com/reStructuredText_kilavuzu.rst
>
> Aynı belgenin dönüştürülerek PDF haline getirilmiş şekli:
> http://ozbekanil.googlepages.com/reStructuredText.pdf
>
> Aynı belgenin dönüştürülerek HTML haline getirilmiş şekli:
> http://ozbekanil.googlepages.com/reStructuredText.html
>

>

> Ben MediaWiki kullanarak, öğrencilerime yönelik bir "Ders Notları" sayfası
> hazırlamaya başladım. Ve aşağıdaki linkte de göreceğiniz gibi, bu ders
> notlarının bazı maddelerini önce LATEX dosya biçiminde hazırladıktan sonra
> konsolda gerekli komutları vererek hem HTML hem de PDF formatına
> dönüştürdüm. Ve bu yönteme de devam edeceğim. Bu web sayfasındaki HTML ve
> PDf dosyalarının aslını "Latex" kullanarak yazdıktan sonra "hevea" ile HTML
> şekline ve "pdflatex" komutuyla da PDF şekline dönüştürdüm.
>
> http://dersnotlari.acim.name.tr/index.php?title=Mesleki_Yabanc%C4%B1_Dil
>
> Fakat, Anıl ÖZBEK'in "Türkçe dilinde" oluşturmuş olduğu "NASIL" belgesi
> harika. Ve ben de bundan sonra hem HTML, hem de PDF olarak yayınlamayı
> düşündüğüm ders notlarımı LATEX yerine önce RST formatında hazırladıktan
> sonra konsolda gerekli komutları verip hem HTML hem de PDF dosya biçimine
> dönüştürmek istiyorum. Fakat, "bilgi" açısından eksikliklerim var. Daha
> doğrusu sorularım var.
>
> - Bu sonuçları elde etmek için Pardus'ta hangi yazılımları kurmalıyım?
>

>
Şu ana kadar kurduklarım:
> docutils
> python-sphinx
>

>
- Peki, yukarıda kurduklarım yeterli mi?
>

>
- Ve diyelim soneki ".rst" olan dosyayı hazırlamayı bitirdik ve bu dosyanın
> PDF çıktısını ve HTML çıktısını elde etmek istiyorum. Konsoldan hangi komutu
> vereceğim?
>

>
Örnek olarak "deneme.rst" diye bir dosya oluşturdum. Hadi bakalım, PDF
> çıktısını almak istiyorum.
>
>> docutils deneme.rst
>>
>
> - Bu komutu mu vereceğim? Eğer bu komutu verecek isem, HTML çıktısı için
> hangi komutu vereceğim?
> - Bu sorduğum soruların cevaplarını elbette geliştirici arkadaşlar
> biliyordur. Ama ben de öğrenmek istiyorum. Yardımcı olabilecek kişilerden
> yardım alabilir miyim?
>
>
Saygı ve sevgilerimle.

-- 
Server ACİM
- Besteci (Composer)
- İnönü Üniversitesi Devlet Konservatuvarı Öğretim Uyesi (University
Academic Staff)
- PARDUS kullanicisi, katkicisi ve destekcisi (PARDUS user, contributor and
supporter)
http://acim.name.tr
-------------- sonraki bölüm --------------
Bir HTML eklentisi temizlendi...
URL: <http://liste.pardus.org.tr/pardus-kullanicilari/attachments/20100213/33d4fbea/attachment.htm>