:) AsciiDoc 的文档看起来还是比较舒服的。
1. AsciiDoc 概要
这种文件格式最大的优点就是简洁!语法和使用以及手册都是如此,常用的转换工具只有一个 asciidoc.py 文件。通过配置文件,可以定制 asciidoc 的语法以及输出文件的大部分信息。
2. 开始 AsciiDoc 之旅
安装 AsciiDoc 相当简单,在安装好 python 2.4 以上版本以后,解压缩文件即可通过运行 asciidoc.py 来进行基本的转换。而 a2x 则没有实现 windows 下的移植。
在安装包中的 doc 目录,有很多可以参考的实例。
3. AsciiDoc 的文档类型
AsciiDoc 主要有三种文档类型: article, book, manpage, 分别为文章、书籍和手册。几种格式的文档都使用大体上相同的格式,只有细微的差别。
转换的时候,可以通过 asciidoc -d (-doctype) 来指定需要输出的文档类型。
article(文章)主要用于短篇的文本,实例可以参考 ./doc/article.txt 。
book(书籍)的格式和 article 基本一样,不过 book 中可以增加级别为 0 的节 (section)。其实 article 和 book 都是基本上跟 DocBook 看齐的。doc 文件夹中有 book 以及多部分的 book [...]
分享到:
相关推荐
AsciiDoc是一种文本文档格式,可以用于书写文档,文章,手册,书籍和UNIX手册。AsciiDoc文件可以使用asciidoc命令转换成HTML和DocBook文件格式。AsciiDoc结构先进:AsciiDoc语法和输出标签(几乎可以转换成任意的...
asciidoc-book-toolchain, 基于AsciiDoc的图书出版工具链 AsciiDoc图书工具链这个库包含一个基本的工具链,用于使用 AsciiDoc 发布图书。 它把这本书编译成:HTMLPDFPDF ( 可以打印)ePub移动移动这个工具链已经创建...
mvn install:install-file -DgroupId=nl.jworks.markdown_to_asciidoc -DartifactId=markdown_to_asciidoc -Dversion=1.0 -Dpackaging=jar -Dfile=C:\Users\lizz\Downloads\markdown_to_asciidoc-1.0.jar
附件包括两个asciidoc的示例文件: cheatsheet.adoc------AsciidocFX软件自带的示例 userguide.adoc-------asciidoc官网提供的示例,对应生成的html为http://asciidoc.org/asciidoc.html
AsciiDoc是一种文本文档格式,用于编写笔记,文档,文章,书籍,电子书,幻灯片,网页,手册页和博客。 AsciiDoc文件可以转换为多种格式,包括HTML,PDF,EPUB,手册页。 AsciiDoc.py是此语法的旧式处理器,用于...
AsciiDoc AsciiDoc是一种文本文档格式,用于编写笔记,文档,文章,书籍,电子书,幻灯片,网页,手册页和博客。 AsciiDoc文件可以转换为多种格式,包括HTML,PDF,EPUB,手册页。 AsciiDoc是高度可配置的:AsciiDoc...
AsciiDoc 的 OS Inferno 和 Plan9 手册页后端 用于从 AsciiDoc 源生成和手册页 (troff) 的插件。 要安装 9man 插件,请下载并使用asciidoc安装它: asciidoc --backend install 9man.zip 用法: asciidoc -d ...
AsciiDoc是一种人类可读的文本文档格式,用于编写笔记,文档,文章,书籍,电子书,幻灯片,网页,手册页和博客等。 AsciiDoc文件可以转换为多种格式,包括HTML,PDF,EPUB和手册页。 要了解更多信息,请访问...
采用JavaFX 8 开发的一款Asciidoc编辑器和工具链
腹水 笔记目前正在高度开发中。 Asciidocular是一个小型AngularJS Web应用程序,可通过Ajax加载文件并将其呈现为完整的网站。 Asciidocular使用将AsciiDoc文件转换为HTML。 Asciidocular可用于创建您的项目或API的...
Atom-atom-asciidoc-preview.zip,atom编辑器的ascidoc预览。Asciidoc预览包,atom是一个用web技术构建的开源文本编辑器。
Asciidoc 速查表Asciidoc 是一种富文本标记语言。 它不同于简单的文本标记语言,如 Markdown,具有多语言特性。 用 Asciidoc 标记语言编写的文本可以轻松转换为HTML 、 PDF 、 Docbook 、 Mobi 、 Epub格式。 通过本...
Sphinx的AsciiDoc Builder和Writer(asciidoc)介绍Sphinx用于使用Docutils从reST源文件构建文档。 尽管有许多Sphinx输出编写器,例如html,ePub和LaTex,但没有可用的转换工具将基于Sphinx的reST文档转换为asciidoc...
Atom-atom-language-asciidoc.zip,atom编辑器的ascidoc语言包。atom的ascidoc语言包,atom是一个用web技术构建的开源文本编辑器。
markdown_to_asciidoc-1.0.jar 和 paleo-core-0.11.0.jar 两个jar包
注意:Vim asciidoc语法高亮显示的开发完全放在。 因此,此存储库已出于历史目的... 笔记 如果此目录尚不存在,请创建它。 您可以通过以下方式之一启用语法高亮处理: 将Vim autocmd放入Vim配置文件中 执行Vim命令
示例-asciidoc Asciidoc 示例项目 asciidoc 文件应该以 .ad、.adoc 或 .asciidoc 结尾
西塔卡手册 ASCIIdoc中的Sitka手册
asciidoc_publishing_toolbox:AsciiDoc的发布工具箱