AsciiDoc是编写文档的极佳工具,但关于它的信息却远远不够。
今天,我很兴奋地宣布一个新的AsciiDoc资源,http://asciidoctor.org[asciidoctor.org]。除了作为http://github.com/asciidoctor[Asciidoctor项目]及其集成的项目页面,这个网站还通过教育和倡导帮助推广AsciiDoc。
一个新纪元的黎明 照片版权: bartvandorp
该网站的主要亮点是一系列新的AsciiDoc指南:
-
链接:/docs/what-is-asciidoc-why-use-it/[什么是AsciiDoc?我们为什么需要它?]
这些指南的目的是回答你关于AsciiDoc的问题,并迅速让你熟悉语法。它们遵循一套推荐的规范来呈现AsciiDoc,帮助你创建更一致的文档,最大化你的写作生产力。
如果你看到想要进行的改变,为指南做贡献很简单!
指南是用AsciiDoc编写的,并且托管在GitHub上 https://github.com/asciidoctor/asciidoctor.org 。如果你在指南中看到想要进行的更改,只需在右手边的列中寻找*编辑*按钮并点击它。那会带你进入GitHub的一个编辑器,在那里你可以做出更改并将其提交为一个拉取请求。
或者,您可以克隆项目,本地进行修改,提交它,然后按照通常的方式发送一个拉取请求。
一旦变更合并到+master+分支,它会自动发布。
我希望你会发现这些指南有用,并且我期待你的反馈。我们可以共同努力,消除编写文档的痛苦!