добавление ссылок в javadoc к исходным файлам в коде Google - PullRequest
5 голосов
/ 13 августа 2011

Я работаю над проектом с открытым исходным кодом, который размещен на Google Code. Я использую муравей для создания Javadocs, и я хотел бы иметь ссылки на исходные файлы. Я понимаю, что могу использовать флаг linksource для javadoc , чтобы включить источник в результирующий HTML, но это не то, что я действительно хочу. Я предпочел бы предоставить ссылку на исходный файл в браузере svn кода Google. Я полагаю, я мог бы сделать простой фильтр до запуска Javadoc, но было бы еще лучше, если бы я мог найти способ сделать это правильно в Javadoc. В идеале, я мог бы иметь свойство в моем файле свойств муравья, например

base.src.url=http://code.google.com/p/myproject/source/browse/branches/1.2

и команда javadoc добавит строку в html-файл каждого класса:

<a href="http://code.google.com/p/myproject/source/browse/branches/1.2/[package]/[classname].html">see source on google code</a>

Есть идеи?

1 Ответ

2 голосов
/ 15 августа 2011

Насколько мне известно, в стандартном доклете такой опции нет.Похоже, вам нужно либо

  • использовать альтернативный доклет,
  • исправить стандартный доклет,
  • предварительно обработать файлы Java или
  • постпроцессироватьсозданный HTML.

Запрос на добавление функции в стандартный доклет также может быть хорошей идеей.

...