Asciidoctor 文档

您已到达旧版 Asciidoctor 文档的着陆页。新文档的着陆页位于 https://docs.asciidoctor.org.cn,现在是一个专门的站点。在新站点上,您可以找到 AsciiDoc 标记语言、Asciidoctor 处理器和工具链以及众多 Asciidoctor 集成的最新文档。

如果您正在寻求社区成员的实时支持,请在 #users 流下的 社区聊天中提问。您也可以在 讨论列表中找到有用的信息,但请注意,讨论列表已被弃用,转而使用社区聊天作为沟通方式。

开始使用 Asciidoctor

现在,让我们设置并使用 Asciidoctor 工具链!

使用 AsciiDoc 编写

AsciiDoc 语言文档

Asciidoctor 中实现的 AsciiDoc 语言的文档。

AsciiDoc 语法快速参考

您可能需要用来构建和格式化文档的 AsciiDoc 语法的概述。

AsciiDoc 作者指南

包含示例的综合教程,展示如何使用 AsciiDoc 语法。

AsciiDoc 风格指南和推荐实践(草稿)

风格提示和推荐实践,用于编写易于阅读和转换的文档。

AsciiDoc 文章模板

包含 AsciiDoc 文章文档中最常用的内容结构和标记的模板。

语法扩展

Asciidoctor Diagram

了解如何使用 PlantUML、Graphviz、ditaa 和 Shaape 在您的 AsciiDoc 文档中创建图表和 ASCII 艺术。

处理器

Asciidoctor 文档

Asciidoctor 是一个快速、开源、基于 Ruby 的文本处理器,用于将 AsciiDoc 解析为文档模型并将其转换为 HTML 5、DocBook 5、手册页、PDF 和 EPUB 3 等输出格式。这个 Ruby 库通常被称为 Asciidoctor core。

安装和使用 AsciidoctorJ

AsciidoctorJ 捆绑了执行 Asciidoctor 所需的所有 gem,并将其包装在 Java API 中,以便 Asciidoctor 可以像任何其他 Java 库一样在 Java 中使用。

安装和使用 Asciidoctor.js

Asciidoctor.js 将 AsciiDoc 带入 JavaScript 世界!

扩展转换器

使用 Asciidoctor 将 AsciiDoc 转换为 PDF

Asciidoctor PDF 是 AsciiDoc 的原生 PDF 转换器。我们正在谈论 AsciiDoc 直接转换为 PDF!了解如何安装 Asciidoctor PDF 并使用它将您的 AsciiDoc 文档转换为 PDF。

使用 Asciidoctor 将 AsciiDoc 转换为 EPUB3

Asciidoctor EPUB3 是 AsciiDoc 的原生 EPUB3 转换器。了解如何安装 Asciidoctor EPUB3 并使用它直接将您的 AsciiDoc 文档转换为 EPUB3 和 Amazon 的 Kindle KF8/Mobi 格式。

使用 Asciidoctor 创建 reveal.js 演示文稿

Asciidoctor reveal.js 是 Asciidoctor 和 Asciidoctor.js 的一个转换器,它将 AsciiDoc 文档转换为 HTML5 演示文稿,该演示文稿旨在由 reveal.js 演示文稿框架执行。

为 Asciidoctor 贡献