سؤال
كيف يمكننا إنشاء Javadoc كمستند للكلمة بدلاً من صفحات HTML التقليدية؟
المحلول
ابحث في doclets ، http://doclet.com التي لديها الكثير من الأمثلة على عرض Javadoc المخصص (أي في PDF وما إلى ذلك ...) ونظر أيضًا إلى Apache POI (http://poi.apache.org/) لتوليد ملفات MS Office
نصائح أخرى
إذا تمكنت من العيش مع PDF بدلاً من الكلمة ، فيجب عليك تقديمها pdfdoclet فرصة. لقد اكتشفت ذلك على dclet.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%
http://doclet.com/ يرتبط RTF Doclet ("RTF DCLET يولد وثائق تنسيق RTF.") يفتح RTF الناتج في Word و Open Office Conster.
يمكنك استخدام 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
لا يمكنك إنشاء مستند كلمة مباشرة. ومع ذلك ، يمكنك محاولة إنشاء مستندات (مواقع) Word من ملفات HTML التي تم إنشاؤها: ابحث في جوجل