nekt 5 янв 2009 в 23:07

Автоматический генератор документации кода

2 мин

Чулан

-1

Комментарии 12

khizhaster 5 янв 2009 в 23:21

Для JavaScript вполне можно пользовать вот такую зарекомендовавшую себя штуку: www.scriptdoc.org/specification.htm

nekt 5 янв 2009 в 23:29

Хм. Выглядит достаточно просто. Думаю с ней проблем возникнуть не должно.
А нет ли возможности посмотреть пример что на выходе получается?

khizhaster 6 янв 2009 в 01:47

Хм-хм, стандартный парсер в Aptana делает одну страничку с полным описанием всем функций и прочего. Собсно, хвастаться нечем. Может быть Pro версия делает полноценную документацию, не в курсе. Но внутри Aptana есть чудный view — Visual ScripDoc, где отображаются комментарии в древовидном виде по классам и объектам.
Коллеги пользуют ту же систему более серьезно (я почему и рекомендовал), завтра узнаю, что они используют для парсинга, ибо у них все вполне серьезно выглядит.

nekt 6 янв 2009 в 01:56

Я аптану не пробовал толком… мб ее тоже стоит посмотреть. Но она мне тоже кажется монстрячной :)

khizhaster 6 янв 2009 в 07:53

Хм-хм, как оказалось ScriptDoc — это методология, не более того, как я понял. Найти вменяемый «официальный» парсер не смог. Я пользовал встроенное в Aptana решение и думал, что оно везде такое :)
Коллеги рассказали, что пользуют доработанный напильником под свои нужды JsDoc.