scala - 链接到 scaladoc 的来源？

Question

我需要从我的 scaladoc 链接到 github 上的源代码。我用 sbt 的 doc 构建这些文档任务。

有两个问题 - 首先，我不喜欢为我的 .scala 创建几个嵌套的空目录。文件，所以我通常将它们全部打包在一起 - 比如 src/main/scala/org.rogach.scallop而不是 src/main/scala/org/rogach/scallop .有没有办法在不拆分该目录的情况下使指向文档的链接工作？

其次，当我将此行放入 build.sbt 时:

scalacOptions in (Compile, doc) ++=
  Opts.doc.sourceUrl("https://raw.github.com/Rogach/scallop/master/src/main/scala/")

文档包含指向源的链接，但所有这些链接都指向源根 url，而不是文件本身。我究竟做错了什么？

Answer 1

来自 scaladoc help 的输出:

-doc-source-url <url>        A URL pattern used to build links to template
                             sources; use variables, for example:
                               €{TPL_NAME} ('Seq'),
                               €{TPL_OWNER} ('scala.collection'),
                               €{FILE_PATH} ('scala/collection/Seq')

(是的，这是欧元符号。)

如果您的所有源都在一个包中定义，则类似以下内容应作为 sourceUrl 的参数:

https://raw.github.com/Rogach/scallop/master/src/main/scala/€{TPL_OWNER}.€{TPL_NAME}.scala