nekt Jan 6 2009 at 02:07

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

2 min

1.9K

Lumber room

-1

Comments 12

khizhaster Jan 6 2009 at 02:21

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

nekt Jan 6 2009 at 02:29

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

khizhaster Jan 6 2009 at 04:47

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

nekt Jan 6 2009 at 04:56

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

khizhaster Jan 6 2009 at 10:53

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