🤓 Asciidork

用 Rust 编写的 Asciidoc 解析器/后端

安装

# requires rust/cargo toolchain
cargo install asciidork-cli

git clone https://github.com/jaredh159/asciidork
cd asciidork
cargo build --release --bins

# vvvv -- OPTIONAL: or use rel path to `./target/release/asciidork` instead
sudo cp ./target/release/asciidork /usr/local/bin

用法

# read the friendly manual
asciidork --help

# parse/convert/print from a file
asciidork --input test.adoc

# without a --input arg, it reads from stdin
echo "foo _bar_ *baz*" | asciidork
asciidork < test.adoc

# don't include enclosing document structure by passing `--embedded`
asciidork --input test.adoc --embedded

# send output to a file (alternatively just redirect stdout)
asciidork --input test.adoc --embedded --output test.html

# print information about perf (did i mention it's written in Rust btw?)
asciidork --input test.adoc --print-timings

# print pretty html (requires `pretter` -- install w/ `npm i -g prettier`)
asciidork --input test.adoc --embedded --format dr-html-prettier

WASM

Asciidork 解析器和 dr-html 后端编译成 WASM 以在浏览器中运行！（我提到它是用 Rust 编写的吗？）NPM 包即将推出，但现在您可以在以下位置查看其运行情况

https://asciidork-playground.vercel.app

请确保打开开发者工具以查看计时信息。

注意事项

[!WARNING] Asciidork 还不完整。它实现了 Asciidoc 的大多数文档行为，但有几个未完成区域，缺少错误处理，有很多边缘情况！目前仅将其视为技术预览。

已知的 未完成或未实现 区域包括

• CSV 表格
• STEM
• 源代码高亮显示
• 包含指令
• 所有实体引用

欢迎 PR！ 👍