Использование 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 и улучшить его для будущих программистов в вашей ситуации:)