Dokuman yazmayi kolaylastiracak biseyler

[di]

Selam,

API dokumanlarini yaziyorum da, omrumden omur goturuyor. Oyle wiki neyim yok ortada, haliyle word'de yaziyorum.

Boyle kod bloklarini falan atabilecegim, alakali yerleri otomatik renklendirecek, indent'ini yapacak, en son PDF olarak bana verebilecek bir program neyim var midir acep ?

[GERGE]

Dokuman olarak bilmiyorum ama frp sistemimin kitabını yazarken (tarz olarak api dokumanına benzer biraz) Sublime Text ve reStructuredText kullandım. Zaten word processor cok cok iyi degilse asla kullanılmamalı bence. Word en kotulerden :) Tipografi açısından sadece Mac'lerde iyi programalr gördüm.

Text Editor ve reStructuredText gibi bir şey kullanmayı dene derim ama. reStructuredText'in syntax'ı öğrenmek 20 dakika filan sürüyor. Kendisi de zaten Python dokumanlarını yazman icin yaratılmıs: http://en.wikipedia.org/wiki/ReStructuredText

http://docutils.sourceforge.net/rst.html

[di]

Bahsetmistin sen bundan daha once hatirliyorum. Bakayim tekrar.

Diger yandan Swagger diye biseye denk geldim, tam aradigim sey yalniz implementasyonu bende olmayan kadar vakit alacak gibi.

Ahanda demo link'i, deneyin bi, lazim olur kesin bi ara.
http://petstore.swagger.wordnik.com/

[GERGE]

Word processor kavramı cidden iyi değil ama benim gibi tipografi takıntısı olan biri için. Gördüğüm ilk iyi program text editor ile word processor arasında kalmış Pages. İyiymiş kendisi.

Bak ama reStructuredText'e. Sublime Text ya da bildiğin başka bir text editor kullanacağından kısayollara filan da hakim olursun hep.

[GERGE]

Bunu vereyim bir de: http://stackoverflow.com/questions/2746692/restructuredtext-tool-support

[Gladmir]

HLD icin Sublime, javadoc icin Intellij idea nin javadoc plugin i super.

[Sypro]

az önce denk geldim, alternatif arayanlara gelsin:
http://revaxarts-themes.com/documenter/

[Pluton]

di said:

Bahsetmistin sen bundan daha once hatirliyorum. Bakayim tekrar.

Diger yandan Swagger diye biseye denk geldim, tam aradigim sey yalniz implementasyonu bende olmayan kadar vakit alacak gibi.

Ahanda demo link'i, deneyin bi, lazim olur kesin bi ara.
http://petstore.swagger.wordnik.com/

Bu ne güzel bişimiş lan öyle

[elma]

LaTex öğrensen bi daha Word falan kullanmazsın

[GERGE]

Latex overkill ya. Rst iyi.

[uk]

di said:

Selam,

API dokumanlarini yaziyorum da, omrumden omur goturuyor. Oyle wiki neyim yok ortada, haliyle word'de yaziyorum.

Boyle kod bloklarini falan atabilecegim, alakali yerleri otomatik renklendirecek, indent'ini yapacak, en son PDF olarak bana verebilecek bir program neyim var midir acep ?

http://nanoc.ws/

Aslında online static sayfalar için çok kullanışlı. Single Page yapıp pdf e çevirebilirsin diye düşünüyorum. Baya esneklik ve kolaylık sağlar. Bir kere kendi şablonunu oluşturdunmu gerisi daha kolay olabilir.