erlang - rebar3 为多个应用程序生成 edoc

Question

如果我有这样的 OTP 布局:

foo/
  - apps/
    - bar1/
      - src/
    - bar2
      - src/

如何为两者生成 edoc bar1和bar2 ？

如果我运行:

rebar3 edoc

我得到的是单独的.html文件位于 bar1/doc和bar2/doc ，并且它们之间的链接都不起作用(即导出类型未正确链接)。

谢谢。

Answer 1

编写了一个名为 medoc 的 rebar3 插件，它将确保 edoc 生成的文档正确链接并更新目录:

https://github.com/drozzy/medoc

运行方式:

rebar3 medoc

至于标准的edoc，这似乎还不是一个功能。一个中间解决方案是在您的钢筋配置中使用它:

{edoc_opts, [{dir, "doc"}]}

但这不会正确更新目录(即您只会看到一个应用程序的目录)。