From 9a76ba9d83cc657c8a94153a75c66765b135049e Mon Sep 17 00:00:00 2001 From: Liu Yihua Date: Mon, 9 Aug 2021 18:34:56 +0800 Subject: [PATCH] [asciidoc/zh-cn] Add translation (#4210) --- zh-cn/asciidoc-cn.html.md | 135 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 zh-cn/asciidoc-cn.html.md diff --git a/zh-cn/asciidoc-cn.html.md b/zh-cn/asciidoc-cn.html.md new file mode 100644 index 00000000..74eed445 --- /dev/null +++ b/zh-cn/asciidoc-cn.html.md @@ -0,0 +1,135 @@ +--- +language: asciidoc +filename: asciidoc-cn.md +contributors: + - ["Ryan Mavilia", "http://unoriginality.rocks/"] + - ["Abel Salgado Romero", "https://twitter.com/abelsromero"] +translators: + - ["Liu Yihua", "https://github.com/yihuajack"] +lang: zh-cn +--- + +AsciiDoc 是一种类似于 Markdown 的标记语言，它可以用来写从书到博客的任何东西。它由 Stuart Rackham 在 2002 年发明，它的语言很简单，但同时也可以有丰富的定制。 + +文档标题 + +标题是可选的，且不可以包含空行。它必须离正文空出至少一个空行。 + +仅标题 + +``` += 文档标题 + +文档的第一句话。 +``` + +标题和作者 + +``` += 文档标题 +张三 + +文档开始。 +``` + +多名作者的情形 + +``` += 文档标题 +李四 ; 王五 ; 赵六 + +有多名作者的文档开始。 +``` + +版本行（需要作者行） + +``` += 文档标题（第一版） +土豆人 +v1.0, 2016-01-13 + +这篇关于炸薯条的文章会很有趣。 +``` + +段落 + +``` +段落不需要什么特别操作。 + +在两段之间用一个空行隔开。 + +当你需要换行时，添加一个 + +你就会得到一个换行符！ +``` + +文本格式化 + +``` +_用下划线创建斜体_ +*用星号加粗* +*_组合起来用更有趣_* +`用重音符显示等宽字体` +`*加粗等宽字体*` +``` + +节标题 + +``` += 第 0 级 （一般只用于文档标题） + +== 第 1 级

+ +=== 第 2 级

+ +==== 第 3 级

+ +===== 第 4 级

+ +``` + +列表 + +用星号创建无序列表。 + +``` +* 甲 +* 乙 +* 丙 +``` + +用句点创建有序列表。 + +``` +. 项目 1 +. 项目 2 +. 项目 3 +``` + +你可以用额外的星号或句点来嵌套最多五次列表。 + +``` +* 甲 1 +** 甲 2 +*** 甲 3 +**** 甲 4 +***** 甲 5 + +. 甲 1 +.. 甲 2 +... 甲 3 +.... 甲 4 +..... 甲 5 +``` + +## 补充材料 + +处理 AsciiDoc 文档有两种工具： + +1. [AsciiDoc](http://asciidoc.org/): 原版的 Python 实现，在主流 Linux 发行版中已附带，目前处于稳定版本维护模式。 +2. [Asciidoctor](http://asciidoctor.org/): 使用 Ruby 的另一种实现，也可以从 Java 和 JavaScript 中使用。它处于积极的开发中，目标是用新特性和输出格式扩展 AsciiDoc 的语法。 + +以下是 `Asciidoctor` 实现的相关链接： + +* [Markdown - AsciiDoc 语法比较](http://asciidoctor.org/docs/user-manual/#comparison-by-example)：并列比较一般 Markdown 和 AsciiDoc 的元素。 +* [入门](http://asciidoctor.org/docs/#get-started-with-asciidoctor)：安装和快速启动指南，帮助构建简单的文档。 +* [Asciidoctor 用户手册](http://asciidoctor.org/docs/user-manual/): 完整的单文档指南，包含语法参考、示例、渲染工具等。