java doc 生成 没有找到软件包_如何从JavaDoc生成PDF(包括概述和软件包摘要)

搞定了。在尝试所有可能的工具直接从源代码生成之后，我返回到了

HTMLDOC.它不是JavaDoc感知的，但它是非常好的构造，一些调整足以使它生成一个可用的PDF。

这里有一个关于我如何做的一步一步的描述：

>下载免费的软件版本(官方网站版本需要许可证，但是它是GPL-ed，所以你可以找到免费的二进制文件，如this one，这是一个简单而实用的Windows安装程序);

>以您首选的方式生成传统的HTML文档(Ant，Maven，命令行javadoc – 您的选择);

> GUI是不错的，但是手动添加所有文件可能很麻烦，所以只需创建一个文档类型设置为“Web页面”的.book文件，从生成的javadoc的根文件夹中添加一个HTML文件(例如，概述摘要.html，任何人都会做，这只是为了参考步骤5)。在“输出”选项卡上，选择PDF格式并为其设置名称，并将其他选项添加到您的心脏的内容(标志，颜色，很多酷的东西在这里)。保存此项目(例如myjavadocpdf.book)并关闭GUI

>生成javadoc中所有HTML文件的列表。我用Cygwin的find命令(我的DOS / cmd shell天已经很久了)，但是你可以做任何你想要的，只要你得到一个文件列表。在我的情况下找到。 | grep html $ |排序-r> files.txt做的窍门;

对于所有Windows用户，dir / s / b * .html> files.txt应该这样做。

>打开您喜欢的纯文本编辑器(作为程序员您应该对此有强烈意见，因此将我的观点保留在我自己 – NOT ;-))上生成的.book文件，并附加在步骤4生成的列表这个.book文件(它保留文件列表在最后，使生活真的很容易)。不要忘记修复相对路径，如果需要全局搜索/替换(这就是为什么您需要至少一个文件添加在步骤3 – 以查看哪个文件路径模式htmldoc期望);

>现在您应该以方便的顺序排列文件。我把我的概述放在第一位，然后打包说明和每个类，然后是完整的索引，以及其他一切。请记住，您删除的任何文件将成为外部(因此被破坏)的链接，所以选择明智;

>保存您的.book文件并在HTMLDOC上重新打开它。 Voila：所有文件被添加和排序。点击生成。而已！

你可能想要弄脏图像(提示：使用HTML width / height，而不是style / css)。最后，所得到的文件是非常好的：外观美观，内部和外部链接完全可导航。令人印象深刻的是，当您认为该工具不是Java(Doc)知道…