lua - 将 LuaDoc 与 .lua 以外的扩展名一起使用

Question

我目前正在为一个需要扩展名的新应用程序开发 lua 脚本xx_lua。我的 .lua 扩展名的 luadoc 工作正常，我知道我可以简单地将文件重命名为 lua 扩展名创建文档并将它们重命名，但我个人更喜欢更优雅的解决方案。

是否可以让 luadoc 查看其他扩展。我试过打电话

luadoc_start *.xx_lua

但即使路径中有大量具有该扩展名的文件，也会导致没有输出。

Answer 1

如果修改 luadoc 是一个选项，那么您可以这样做。我刚刚快速浏览了 3.0.1 版本（在撰写本文时是最新版本），在 src/luadoc/taglet/standard.lua 中有第 406 行：

local patterns = { "%.lua$", "%.luadoc$" }

模式“%.lua”用于另外两个位置（同一个文件，第 316 行）和 src/luadoc/doclet/html.lua:53，最后一个似乎不相关。在我看来，正确的做法是为文件扩展名创建一个全局参数并使用它而不是硬编码的“.lua”。也许您甚至可以向 luadoc 提交一个补丁，并在您的情况下为未来的程序员改进它:)