scala - 使用 SBT 在 Scaladoc 中自动包含 javascript

Question

我正在研究一个数学函数库。作为 的一部分Scaladoc，我想包括每个函数的公式。例如

/**
 * Sum squared function:
 * \(f(x) = \sum_i^n x_i^2\)
 */
def sumSquared[T](x: Seq[T]) = x.map(xi => xi * xi).sum

我正在使用MathJax来显示公式。如果我手动编辑生成的 html 以包含所需的 MathJax javascript，它会起作用，但我想自动执行此操作。

到目前为止，我发现的唯一解决方案是：

• 有没有办法在 Scaladoc 中包含数学公式？
• 使用 doc 任务生成 scaladoc 后如何运行 bash 脚本？

如果这些是唯一的选项，那没关系，但是我想只使用 sbt（没有外部脚本）来做到这一点。有没有办法通过scalacOptions在How to ScalaDoc中设置来做到这一点？

Answer 1

我添加了一个答案Is there a way to include math formulas in Scaladoc? 使用完成这项工作的 sbt 任务，但仍在使用 MathJax。

我不知道任何代码实际上会将乳胶公式替换为生成的 api 文件中的图像