关于AsciiDoc
AsciiDoc 是一种轻量级且富有语义的标记语言,主要设计用于编写技术文档。该语言可以用来生成各种丰富的展示格式输出,所有这些都来自于编码在简洁、人类可读的纯文本格式中的内容。
AsciiDoc 语法直观,因为它基于既定的、用于标记和构造文本的纯文本习惯。不熟悉 AsciiDoc 的人可能通过观察语法元素就能猜到它们的用途。这是因为语法元素经过仔细选择,看起来像它们的含义(这是技术行业长期采用的做法)。
AsciiDoc语言并不依赖于它所生成的输出格式。AsciiDoc处理器可以解析和理解AsciiDoc源文件,并将解析后的文档结构转换为一个或多个输出格式,如HTML、PDF、EPUB3、man(ual)页面或DocBook。能够生成多种输出格式是AsciiDoc的主要优势之一。这种能力使得它可以用于静态网站生成器、集成开发环境(IDEs)、git工具和服务、持续集成/持续部署(CI/CD)系统以及其他软件中。
AsciiDoc桥接了写作的便捷性和技术撰写与出版的严格要求之间的差距。AsciiDoc只需要一个文本编辑器来阅读或编写,因此提供了一个门槛较低的上手方式。
关于这份文档
你正在阅读AsciiDoc语言的面向用户文档,这是在Asciidoctor中实现的。这份文档没有涵盖如何设置和使用Asciidoctor来处理AsciiDoc内容。您可以在本网站的Asciidoctor部分找到那份文档。
这份文档已作为对https://projects.eclipse.org/projects/technology.asciidoc[Eclipse^上AsciiDoc语言项目]的初始贡献而提交。该项目将使用这份文档作为起草AsciiDoc语言规范的基础。它同样也将用作AsciiDoc语言的用户指南草稿,该指南将由该项目维护。
在AsciiDoc语言规范的第一个版本被批准之前,AsciiDoc是由Asciidoctor实现定义的。没有其他官方的语言定义。
AsciiDoc的文档将保留在本站点上,直到AsciiDoc语言项目开始发布其自身的AsciiDoc语言文档。
直到那时,我们开始吧!