关于工具:Y-分钟速成-asciidoc

46次阅读

共计 1083 个字符,预计需要花费 3 分钟才能阅读完成。

源代码下载:asciidoc-cn.md

AsciiDoc 是一种相似于 Markdown 的标记语言,它能够用来写从书到博客的任何货色。它由 Stuart Rackham 在 2002 年创造,它的语言很简略,但同时也能够有丰盛的定制。

文档题目

题目是可选的,且不能够蕴含空行。它必须离注释空出至多一个空行。

 仅题目 = 文档题目
文档的第一句话。

题目和作者

= 文档题目
张三 <san.zhang@learnxinyminutes.com>
文档开始。

多名作者的情景

= 文档题目
李四 <si@go.com>; 王五 <wu@yo.com>; 赵六 <xzhao@pirate.com>

有多名作者的文档开始。

版本行(须要作者行)

= 文档题目(第一版)土豆人 <chip@crunchy.com>
v1.0, 2016-01-13

这篇对于炸薯条的文章会很乏味。

段落

 段落不须要什么特地操作。在两段之间用一个空行隔开。当你须要换行时,增加一个 +
你就会失去一个换行符!

文本格式化

_用下划线创立斜体_
* 用星号加粗 *
*_组合起来用更乏味_*
` 用重音符显示等宽字体 `
`* 加粗等宽字体 *`

节题目 = 第 0 级(个别只用于文档题目)

== 第 1 级 <h2>

=== 第 2 级 <h3>

==== 第 3 级 <h4>

===== 第 4 级 <h5>

列表

用星号创立无序列表。

* 甲
* 乙
* 丙 

用句点创立有序列表。

. 我的项目 1
. 我的项目 2
. 我的项目 3

你能够用额定的星号或句点来嵌套最多五次列表。

* * 甲 1
** 甲 2
*** 甲 3
**** 甲 4
***** 甲 5

. 甲 1
.. 甲 2
... 甲 3
.... 甲 4
..... 甲 5

补充资料解决

AsciiDoc 文档有两种工具:

  • AsciiDoc: 原版的 Python 实现,在支流 Linux 发行版中已附带,目前处于稳固版本保护模式。
  • Asciidoctor: 应用 Ruby 的另一种实现,也能够从 Java 和 JavaScript 中应用。它处于踊跃的开发中,指标是用新个性和输入格局扩大 AsciiDoc 的语法。

以下是 Asciidoctor 实现的相干链接

  • Markdown – AsciiDoc 语法比拟:并列比拟个别 Markdown 和 AsciiDoc 的元素。
  • 入门:装置和疾速启动指南,帮忙构建简略的文档。
    * Asciidoctor 用户手册: 残缺的单文档指南,蕴含语法参考、示例、渲染工具等。

有倡议?或者发现什么谬误?在 Github 上开一个 issue,或者发动 pull request!

原著 Ryan Mavilia,并由 0 个好心人批改。
Translated by: Liu Yihua
© 2022 Ryan Mavilia, Abel Salgado Romero
本作品采纳 CC BY-SA 3.0 协定进行许可。

正文完
 0