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

Question

我目前正在为一个新的应用程序开发lua脚本，该应用程序要求扩展名为xx_lua。我已经让luadoc在.lua扩展上工作得很好，我知道我可以简单地将文件重命名为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提交一个补丁，并针对您的情况改进它:)