如何下载休眠文档答案

【问题标题】：how to download hibernate documentation如何下载休眠文档
【发布时间】：2017-05-09 06:50:56
【问题描述】：

大家好，对于这样的问题，我真的很抱歉。我无法下载hibernate官方文档我使用的是在线html版本。可以下载它的pdf吗？

http://docs.jboss.org/hibernate/orm/5.2/userguide/html_single/Hibernate_User_Guide.html

谢谢

【问题讨论】：

我找到了 3.3 docs.jboss.org/hibernate/orm/3.3/reference/en/pdf/… 的文档，但我需要 5.2

标签： hibernate

【解决方案1】：

我们将文档的 HTML 版本与我们发布到 SourceForge 和 Bintray 的最终发布包捆绑在一起。

如果您查看我们的博客文章here，请单击 SourceForge 或 Bintray 链接并下载发布存档。发布存档内是一个文档目录，其中包含该版本发布的所有各种文档指南。

虽然它可能是 HTML 而不是 PDF，但它至少是一个离线版本。

【讨论】：

【解决方案2】：

很遗憾，Hibernate 的官方文档sources 没有为我们提供 pdf 版本。但是，这个问题有一个解决方案：我们可以下载一个单一的html版本，并通过一些html => pdf工具进行转换。以下解决方案适用于Linux，但您也可以下载Windows的相应命令行工具：

让我们创建一些本地文件夹，到那里然后下载带有嵌入图像的文档的单 html 版本：
```
wget --no-parent --recursive --level=inf --page-requisites --wait=1 --reject-regex='index.html\?(.*)' https://docs.jboss.org/hibernate/orm/5.4/javadocs/
```
(wget是一个非常常见的预装工具，用于在Linux中处理html网页；如果您对上述wget命令的cmd选项感到好奇，那么您可以阅读它们here)
由于wget下载了很多目录和子目录，我们需要遍历它们并找到原始html文件所在的文件夹，在这种情况下为Hibernate_User_Guide.html。

现在，我们必须将下载的 html 页面转换为 pdf。我们将使用wkhtmltopdf，您可以下载here：

wkhtmltopdf Hibernate_User_Guide.html Hibernate_User_Guide.pdf

或者，如果您需要更多配置选项：

wkhtmltopdf --encoding utf-8 --page-size A4 --margin-left 5mm --margin-right 5mm --margin-top 5mm --margin-bottom 5mm Hibernate_User_Guide.html Hibernate_User_Guide.pdf

附：上述方法不仅可用于 Hibernate、Spring 等。它是将几乎所有单 html 文档页面转换为 PDF 的通用解决方案。

【讨论】：

【解决方案3】：

我认为不可能下载 pdf 版本的 Hibernate 用户指南。
但是... ;) ;) 您可以转到该链接
(http://docs.jboss.org/hibernate/orm/5.2/userguide/html_single/Hibernate_User_Guide.html)
其中包含所有休眠用户指南并将其打印为 pdf 文件。在您的浏览器上按 Ctrl+P 并选择 print as pdf（我不知道是否所有浏览器都具有此功能。最坏的情况是您需要一个插件）。
这就是我所做的，生成的 pdf 相当不错。

【讨论】：

【解决方案4】：

（2021 年 12 月 26 日）

我终于找到了一种简单的基于 GUI 的方法，可以将 Hibernate 文档导出为单个 PDF 文件，其目录可由任何 PDF 查看器软件读取。

首先，您需要转到Hibernate releases page 并将所需版本的 Zip 存档下载到本地计算机。所有原始 AsciiDoc 文档格式的 Hibernate 文档都位于从 Zip 存档解压缩的文件夹的根目录 /project/documentation/src/main/asciidoc 中。您需要 Asciidoctor PDF Ruby Gem（Asciidoctor 扩展）将 AsciiDoc 文档直接转换为 PDF 文档。

以下是安装扩展程序所需的所有步骤：

推荐安装 Ruby 的方法是使用 Ruby 环境管理器 (RVM)，按照all these steps 为您的操作系统安装它，建议使用 Homebrew 安装所需的依赖项。
上一步的RVM安装完成后，运行以下CLI命令rvm install ruby --default安装最新的稳定版Ruby并选择此版本作为默认版本。
上一步中的Ruby安装完成后，运行以下CLI命令gem install asciidoctor-pdf来安装AsciiDoc-to-PDF转换器。如果安装过程中出现任何错误，您可能需要关注Installation Troubleshooting。
按照my Stackoverflow answer 执行转换（忽略从多个.adoc 文件创建单个pdf 文件的步骤）。在上面提到的asciidoc文件夹中，记得在转换前将Hibernate doc中特定部分的文件夹如userguide或quickstart拖到VSCode IDE中。

【讨论】：