为 lua 生成文档时出错答案

【问题标题】：Error generating documentation for lua为 lua 生成文档时出错
【发布时间】：2023-03-29 21:40:02
【问题描述】：

我正在尝试为我的 lua 项目生成文档

我有我的lua 安装文件夹，其中有luafilesystem 和lualogging 但是当我尝试使用luadoc-start.bat 生成文档时，我收到一条错误消息，提示找不到lfs 模块

我认为lfs 的意思是luafilesystem

所以我的问题是如何安装和配置luadoc 工具的依赖项？

我正在使用这个工具作为这篇文章说How to use LuaDoc with LuaForWindows

我想知道这是否正确？

我看到了来自manual 的安装说明，但对我来说它看起来模棱两可

谢谢

【问题讨论】：

请发布您安装 luafilesystem (lfs) 的位置以及您的 Lua 路径。
我已经使用 lua for windows.exe 安装了 lua，该可执行程序设置了所有东西，所以我在 C:\Program Files (x86)\lua\5.1 中安装了 lua，并且我在同一个文件中安装了 lfs手动目录，我尝试使用 luarocks 安装它，但它不起作用，我也得到一个错误
我的问题是我正在制作电晕游戏，我想为我的代码生成文档，但我没有对 lua 安装做任何事情
从控制台启动 Lua 交互式解释器并执行require "lfs"。会发生什么？

标签： lua documentation-generation luadoc

【解决方案1】：

从控制台，启动 Lua 交互式解释器并确实需要“lfs”。如果它显示“找不到模块 lfs”，那么您的安装不正确。创建一个仅打印 hello 的 Lua 脚本并将其保存在您选择的文件夹中，将文件命名为“mytest.Lua”。从 Wondows 控制台，CD 到该文件夹并启动 Lua 并需要“mytest”。如果可行，请将 lfs 文件复制到同一文件夹并尝试 require "lfs"。如果它有效，您现在可以从该文件夹运行 luadoc。如果没有，则您缺少一些 lfs 文件，例如 DLL。

注意：lfs 是作为 DLL 提供的 Lua 模块；没有 .lua 文件。当您执行require "lfs" 时，Lua 将首先尝试查找与package.path 中的模式之一匹配的给定名称的任何模块（尝试print(package.path)），然后如果没有匹配，它将对@987654325 中的所有模式执行相同操作@。密切注意键入 require lfs 命令后收到的错误消息：它应该指出它尝试了哪些模式，在哪些文件夹中。

【讨论】：

它可以工作，但 luafile 系统不是 lua 模块，所以我将如何需要它？
和 lua 日志记录和 lfs 对与 lua 5.1 兼容的 lua doc 的依赖项我如何为 lua 5.2 生成文档？
@tony 是什么让你说你不能使用 Lua 5.1 为 Lua 5.2 生成文档？
我认为我必须使用相同的版本谢谢@scholli 帮助我尝试一下
所以我按照你对 lua 5.2 所说的做了，我还为 lua 5.1 安装了 exe，现在这两个版本似乎都可以工作，但我得到的是尝试将全局模块称为 nil 值的错误