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

[anil ozbek]

Sayın Server Acim merhaba,

RST, benim de geçen geliştirici listesinde bahsi geçince ilgimi çekti. O
sırada da C++ için belgelendirme araçları arıyordum, her ne kadar bu iş için
uygun olmadığını görsem de bu biçim hakkında bir Türkçe nasıl belgesi
olmadığı için kendim yapmaya karar verdim ve sonuçta bahsettiğiniz belge
çıktı ortaya.

Öğrencileriniz için böyle bir belgelendirme çalışması içinde olduğunuz için
kendi adıma teşekkür ederim. Eminim onlar için çok faydalı olacaktır. Ayrıca
size iki iş olduğu halde sorunuzu tekrar burada sorduğunuz ve diğer
kullanıcıların yararlanmasını sağladığınız için de teşekkürler.

RST belgelerini HTML'ye çevirmek için gerekli araç docutils'in bir parçası.
PDF'ye ise rst2pdf paketindeki uygulamalar aracılığıyla çevrim
yapabilirsiniz. rst2pdf yeni paketlendi, henüz ikili paketleri [1] oluşmadı
sanırım ama çok kısa sürede Paket Yöneticisi aracılığıyla yükleyebilirsiniz.

Hem PDF'ye hem de HTML'ye dönüşüm yapan araçlar konsol uygulaması. Çeşitli
parametrelerle farklı özellikte ve görünümde belgeler oluşturabilirsiniz,
bunların tam listesini komut satırı yardım parametresi (--help) ile
görebilirsiniz. Basit olarak HTML ve PDF'ye şu şekilde çevirebilirsiniz
yazdığınız RST belgelerini:

rst2html.py deneme.rst > deneme.html
rst2pdf deneme.rst

Çalışmalarınızda başarılar dilerim,
Anıl.

[1] http://paketler.pardus.org.tr/info/2009/stable/source/rst2pdf.html
-------------- sonraki bölüm --------------
Bir HTML eklentisi temizlendi...
URL: <http://liste.pardus.org.tr/pardus-kullanicilari/attachments/20100213/1193cab6/attachment.htm>