ternJS има няколко. JSON файлове defs, които съдържат определението за библиотеки. Може ли някой да ми обясни как най-добре мога да генерирам свои собствени към моите javascript библиотеки / или само дефиниционни обекти?
Не виждам, че няма обща процедура за това?
Има инструмент за това, включен в Tern. Вижте condense на http://ternjs.net/doc/manual.html#utils . Той изпълнява Tern на вашия файл и се опитва да изведе типовете, които намира. Далеч не е безупречен, но за прости програми работи добре. За файлове със сложна структура или интерфейс често ще трябва да пишете на ръка дефинициите.
Има три начина, които съм обмислил да разреша проблема ви:
Един от начините да разрешите проблема си е да използвате анализатора на абстрактно синтактично дърво и посетител, за да автоматизирате задачата за сканиране на кода и документирането му.
Ресурсите тук ще бъдат полезни:
-http://ramkulkarni.com/blog/understanding-ast-created-by-mozilla-rhino-parser/ -Какво е JavaScript AST, как да играете с него?
Обикновено използвате анализатор, за да извлечете дърво, а след това използвате посетител, за да посетите всички възли и да свършите работата си там.
По същество ще имате дърво, представляващо конкретната библиотека и след това трябва да напишете кода, за да го съхраните във формата def, към който свързвате.
Друга идея е да изтеглите изходния код за генератор на документация, напр. https://github.com/yui/yuidoc/
Чрез модифициране на стила/изходния формат можете да генерирате „документация“ в подходящия json формат.
Можете да направите анализатор, който приема стандартен формат на документация (сигурен съм, че тъй като Javadoc е такъв за java, трябва да има такъв за javascript), и да напишете конвертор, който извлича съответната информация и съхранява в JSON дефиниция.
