使用LuaDoc与除.lua以外的扩展名

我目前正在为一个新应用程序开发 lua 脚本,该应用需要扩展名为 xx_lua。对于 .lua 扩展名,我已经成功使用 luadoc,我知道我可以简单地将文件重命名为 lua 扩展名,创建文档,然后将它们重命名回来,但是我个人更喜欢一个更优雅的解决方案。

luadoc 是否能够查看其他扩展名?我已尝试调用 luadoc_start *.xx_lua,但即使路径中有很多该扩展名的文件,也没有输出。

原文链接 https://stackoverflow.com/questions/3685725

点赞
stackoverflow用户169828
stackoverflow用户169828

如果修改 luadoc 是一个选项,那么你可以这样做。我刚刚快速查看了 3.0.1 版本(此时写作时的最新版本),在 src/luadoc/taglet/standard.lua 中的第 406 行有:

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

"%.lua" 模式在另外两个位置中也被使用 (同一文件,第 316 行) 以及在 src/luadoc/doclet/html.lua:53 中,但最后一个似乎不相关。我认为正确的做法应该是创建一个全局参数来代替硬编码的 ".lua",并在使用时进行调用。也许你甚至可以提交一个补丁到 luadoc 中,并为将来的程序员提供更好的帮助 :)

2010-09-11 09:57:10