создание Javadoc в качестве документа Word - PullRequest
Новая
       11

создание Javadoc в качестве документа Word

9 голосов
/ 22 октября 2009

Как мы можем сгенерировать Javadoc в виде текстового документа вместо традиционных HTML-страниц?

Ответы [ 5 ]

7 голосов
/ 22 октября 2009

посмотрите на доклеты, http://doclet.com, которые имеют множество примеров пользовательского рендеринга javadoc (т.е. в PDF и т. Д.), А также изучите Apache POI (http://poi.apache.org/) для создания MS Office файлы

4 голосов
/ 14 апреля 2011

Если бы вы могли жить с pdf вместо word, вы должны дать PDFDoclet шанс. Я обнаружил это на doclet.com (спасибо Марку за ссылку). Он работает довольно хорошо, прост в использовании и допускает некоторую настройку. Для моей цели pdf лучше подходит, чем word, потому что pdf документ лучше подходит для чтения, чем слово в отношении необходимого приложения для просмотра.

Вот мой маленький пакетный файл Windows: 

echo OFF

set JAVA_HOME=C:/program files/Java/jdk1.6.0_23
set PATH=%JAVA_HOME%/bin;%PATH%
set VERSION=1.0.2
set DOCLET=com.tarsec.javadoc.pdfdoclet.PDFDoclet
set JARS=jar/pdfdoclet-%VERSION%-all.jar
set PACKAGE="cvu.html"

javadoc -doclet %DOCLET% -docletpath %JARS% -pdf html.pdf -config example/html/config_html.properties -private -sourcepath example/html -subpackges %PACKAGE%
1 голос
/ 04 октября 2013

Вы можете использовать maven для запуска pdfdoclet . Хотя я не нашел никакого «официального» репозитория maven, мне кажется более понятным следующее, в отличие от манипулирования скриптами оболочки или использования команд ant в maven, как предложено на их вебсайте : 

        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.9.1</version>

            <configuration>
                <doclet>com.tarsec.javadoc.pdfdoclet.PDFDoclet</doclet>
                <docletPath>path/to/pdfdoclet-1.0.2-all.jar</docletPath>
                <useStandardDocletOptions>false</useStandardDocletOptions>
            </configuration>
        </plugin>

Обратите внимание на отключение стандартных параметров, в противном случае Javadoc жалуется на неизвестные параметры (очевидно, не поддерживается pdfdoclet)

Оттуда вы можете начать настройку, используя краткую maven документацию

1 голос
/ 30 августа 2011

http://doclet.com/ связывает RTF Doclet («RTF Doclet генерирует документацию формата RTF».) Полученный RTF открывается в Word и Open Office Writer.

0 голосов
/ 22 октября 2009

Вы не можете создать документ Word напрямую. Однако вы можете попытаться сгенерировать документ (ы) Word из сгенерированных файлов html: Поиск в Google

...