我想向你介绍一种最简单的方法,可以直接在浏览器中将任何本地或远程的AsciiDoc文件渲染成HTML!
你需要做的就是安装https://chrome.google.com/webstore/detail/asciidoctorjs-live-previe/iaalpfgpbocpdfblpnhhgllgbdbchmia[Chrome 扩展程序]或者https://addons.mozilla.org/fr/firefox/addon/asciidoctorjs-live-preview/[Firefox 插件]。然后,只需访问AsciiDoc文件,你就可以预览它的HTML版本!
它是如何工作的
Chrome扩展程序和Firefox附加组件使用https://github.com/asciidoctor/asciidoctor.js[Asciidoctor.js]在浏览器内将AsciiDoc渲染为HTML。两者都提供了一个切换按钮,用以在HTML输出和AsciiDoc源码之间切换。
在这里,你可以看到一个本地的AsciiDoc文件在Chrome内部被渲染。

Tip
|
你可以通过这个扩展程序在GitHub上查看任何AsciiDoc文件,它通过Asciidoctor.js的镜头显示!只需在GitHub的网页界面中导航到文件(试试这篇博客文章 https://github.com/asciidoctor/asciidoctor.org/blob/master/news/introducing-asciidoctor-js-live-preview.adoc),然后点击文件预览上方的Raw按钮。看起来好多了,不是吗? |
未来
当前,我们正在使用基于https://github.com/asciidoctor/asciidoctor.js[Asciidoctor.js],该版本是基于https://github.com/asciidoctor/asciidoctor[Asciidoctor] 0.1.2的。我们计划将新发布的https://github.com/asciidoctor/asciidoctor[Asciidoctor] 0.1.4交叉编译到Javascript,以支持最新最好的特性!
我们也正在努力添加一些很酷的新功能:
-
使用http://markitup.jaysalvat.com/[MarkItUp!]的基于浏览器的编辑器
-
实时重新加载以在本地文件更改时自动刷新
-
还有更多……
贡献
我们始终欢迎补丁、更好的文档、功能请求、宣传或您能提供的任何帮助。