Asciidoctor PDF 文档

Asciidoctor PDF 是 AsciiDoc 的原生 PDF 转换器，它挂接到 pdf 后端。它绕过了生成中间格式（如 DocBook、Apache FO 或 LaTeX）的要求。相反，您可以使用 Asciidoctor PDF 直接将 AsciiDoc 文档转换为 PDF。此库的目的是消除从 AsciiDoc 创建 PDF 文档的痛苦。

您正在查看 Asciidoctor PDF 2.3 的文档。如果您正在寻找 Asciidoctor PDF 1.6 的文档，请参阅 v1.6.x 分支中的 README。Asciidoctor PDF < 2 已EOL（生命周期结束），因此不再开发。建议您尽快迁移到 Asciidoctor PDF 2。

概述

Asciidoctor PDF 直接将 AsciiDoc 文档转换为 PDF 文档。PDF 的样式和布局由专用的主题文件控制。在最大程度上，Asciidoctor PDF 支持 Asciidoctor 支持的所有 AsciiDoc 功能。它还提供了 PDF 特有的附加功能。但是，PDF 格式和此扩展使用的底层 PDF 库存在某些限制。

Asciidoctor PDF 使用 Prawn gem 和 Prawn 的扩展（如 prawn-svg 和 prawn-table）来生成 PDF 文档。Prawn 是一个通用的 Ruby PDF 生成器，它具有用于常见需求（如设置页面和插入图像）的高级 API，以及用于定位和渲染文本和图形的低级 API。