Julia 相当于 R 的帮助页面和小插图？

Question

来自 R 背景，刚开始学习 Julia，我想知道 Julia 中的文档如何，以及是否有类似于 R 的帮助页面和小插图。

此外，在 R 中，可以使用 roxygen 注释块记录函数，Julia 中是否也有类似的东西？

Answer 1

我认为最好通过例子来理解事情是如何运作的。我将评论 DataFrames.jl 是如何记录的，因为这是一个非常标准的方法：

1. 函数是使用文档字符串记录的，这里是函数文档字符串的示例names；然后可以通过帮助系统以交互方式发现这些文档字符串（按?）
2. 为包生成文档的标准方法是使用Documenter.jl；顺便说一句：该软件包有一个很棒的维护人员团队，他们非常乐于助人和响应迅速；在这里，您有一个指向 make.jl 文件的链接，该文件被执行以生成文档；特别注意doctest=true确保所有按照 Documenter.jl 规则正确注释的代码示例都产生预期输出的选项
3. 为了设置包文档的自动生成，您需要在 GitHub 上设置 CI 集成；再次 - 有很多方法可以做到；一个标准的方法是使用 GitHub Actions；在这里，您有一个指向 ci.yml 规范文件部分的链接，该文件可确保将文档构建为 CI 的一部分；然后在任何公关中，例如这个（我提供了一个指向当前打开的与文档相关的公关的链接），您可以在报告 CI 结果的部分中看到在运行测试后还生成了文档。这里 您可以看到使用此工具链生成的文档的样子（例如，请注意，在底部您可以切换要动态阅读的包的版本，这向您表明这里的所有内容都非常集成 - 而不仅仅是一堆PDF 或 HTML 文件）。

我希望这会帮助你开始。我已经向您指出了 GitHub 上托管的包通常使用的所有基本部分（即这不是唯一的方法，但它是最常用的标准方法）。

要掌握上述所有细节，您需要仔细阅读 Julia 手册和 Documenter.jl 中的文档。不幸的是，编写合适的文档并不容易（在任何编程语言中）。好消息是 Julia 有一个非常优秀的工具链，可以很好地支持这个过程。