#katex #latex #docs #attributes #rustdoc

horrible-katex-hack

通过滥用 doc(html_favicon_url) 属性,使 rustdoc 能够使用 KaTeX 的一种方法

4 个版本

0.1.3 2019年4月4日
0.1.2 2019年4月4日
0.1.1 2019年4月4日
0.1.0 2019年4月4日

#15 in #katex

BSD-2-Clause 许可协议

4KB

此包是使用 rustdoc 与 $\LaTeX$ 数学的一个示例。

此示例滥用 #[doc(html_favicon_url = ..)] 属性将 KaTeX 脚本注入到生成的文档中。

这样,它可以在 docs.rs 和使用 cargo doc 时工作,无需额外设置。

用法

查看此包 lib.rs 的源代码,并复制包含 <link><script> 标签的 doc 属性。

然后,对于内联数学,写入 $`\frac 1 2 + 3`$,它将渲染为 $\frac 1 2 + 3$。

或者,写入

```math
\int_{-\infty}^\infty f(x)\,dx
```

对于显示数学,它将渲染为

\int_{-\infty}^\infty f(x)\,dx

无运行时依赖