AsciiDoc是编写文档的极佳工具,但关于它的信息却远远不够。

今天,我很兴奋地宣布一个新的AsciiDoc资源,http://asciidoctor.org[asciidoctor.org]。除了作为http://github.com/asciidoctor[Asciidoctor项目]及其集成的项目页面,这个网站还通过教育和倡导帮助推广AsciiDoc。

黎明
一个新纪元的黎明 照片版权: bartvandorp

该网站的主要亮点是一系列新的AsciiDoc指南:

这些指南的目的是回答你关于AsciiDoc的问题,并迅速让你熟悉语法。它们遵循一套推荐的规范来呈现AsciiDoc,帮助你创建更一致的文档,最大化你的写作生产力。

如果你看到想要进行的改变,为指南做贡献很简单!

指南是用AsciiDoc编写的,并且托管在GitHub上 https://github.com/asciidoctor/asciidoctor.org 。如果你在指南中看到想要进行的更改,只需在右手边的列中寻找*编辑*按钮并点击它。那会带你进入GitHub的一个编辑器,在那里你可以做出更改并将其提交为一个拉取请求。

或者,您可以克隆项目,本地进行修改,提交它,然后按照通常的方式发送一个拉取请求。

一旦变更合并到+master+分支,它会自动发布。

我希望你会发现这些指南有用,并且我期待你的反馈。我们可以共同努力,消除编写文档的痛苦!