如何合并来自 SBT 多项目的文档？答案

【问题标题】：How to merge documentation from SBT multi-projects?如何合并来自 SBT 多项目的文档？
【发布时间】：2013-04-16 14:51:22
【问题描述】：

我正在为一些 SBT 项目生成 ScalaDoc HTML 文件（在 Multi-Project configuration 中）。如果我在 SBT 控制台中执行 doc，文档会很好地生成，但它会部署在每个项目的独立目录中。由于所有项目都相互关联（就包名称而言），我想生成一个唯一的 ScalaDoc 目录作为输出。值得一提的是，由于一些涉及的宏需要双重编译过程，我无法将所有源代码放在一起。有什么解决办法吗？

【问题讨论】：

嗨，天哪！你看过github.com/sbt/sbt-unidoc，一个“跨多个项目统一scaladoc/javadoc的sbt插件”吗？免责声明：我从未尝试过，我认为它只是简化了同时在所有源上运行 scaladoc；他们证明它与-Ymacro-no-expand兼容。
我将它添加到我的待办事项中，因为它对我们的案例来说似乎真的很有趣。谢谢！

标签： scala sbt scaladoc

【解决方案1】：

不幸的是，scaladoc 不能用于单独编译，因为它不能合并生成的文档。必须同时为所有来源生成文档。宏问题的解决方案是使用-Ymacro-no-expand 在scaladoc 生成期间不扩展宏。另见https://issues.scala-lang.org/browse/SI-6812

【讨论】：

我没有发现 Scala 问题！谢谢马克。