grails-doc создает копии моих классов в пакете по умолчанию
В моем проекте grails 1.3.7 я поместил все свои классы в com.mycompany.myapp, как и вы. Так что это касается сервисов, контроллеров, классов доменов. У меня есть фильтр, который идет в своем собственном пакете. Мое приложение работает нормально.
Тем не менее, когда я бегу grails docGrails решает создать две страницы для каждого класса:
- один в своем правом пакете comp.mycompany.myapp, который имеет все права Groovy Doc
- другой принимает все вышеперечисленные классы и делает вид, что они также находятся в пакете по умолчанию.
Итак, target / docs содержит две директории: "DefaultPackage" и "com", причем DefaultPackage содержит копию всего, что находится под com /
Следовательно, мой отличный документ выглядит грязно, потому что есть два экземпляра для каждого класса.
Как я могу решить это?
2 ответа
Это было задокументировано как ошибка на GRAILS-6605. Там нет никакого обходного пути, перечисленного там для ошибки.
Я тоже столкнулся с той же проблемой и поэтому создал плагин "Документы времени выполнения Grails" ( http://grails.org/plugin/grails-runtime-docs), который решает эту проблему и генерирует как Java, так и groovy документы только по 1 копии на класс, Он понимает и разбивает классы на контроллеры, команды, домены, службы и библиотеки тегов. Groovy документация фактически генерируется из среды выполнения, чтобы также включать динамические методы, добавляя "Сводку динамического метода" и "Подробную информацию о динамическом методе" в сгенерированные HTML-документы, которые предоставляют информацию об их источнике. Надеюсь, что вы найдете ее полезной.