3

正如标题所说，如何在 ubuntu/linux 中使用 luadoc？我使用批处理文件在 Windows 中生成了文档，但在 ubuntu 中没有成功。有任何想法吗？

luadoc
Usage: /usr/bin/luadoc [options|files]
Generate documentation from files. Available options are:
  -d path                      output directory path
  -t path                      template directory path
  -h, --help                   print this help and exit
      --noindexpage            do not generate global index page
      --nofiles                do not generate documentation for files
      --nomodules              do not generate documentation for modules
      --doclet doclet_module   doclet module to generate output
      --taglet taglet_module   taglet module to parse input code
  -q, --quiet                  suppress all normal output
  -v, --version                print version information
4

1 回答 1

2

首先，我对 Luadoc 几乎没有经验，但对 Ubuntu 和 Lua 有很多经验，所以我的所有观点都基于我刚刚完成的 luadoc 知识和快速安装。据我所知，Luadoc 是一个 Lua 库（因此也可以在 Lua 脚本和 bash 中使用）。要制作文档（在 bash 中），您只需运行

luadoc file.lua

（其中 file 是您要为其创建文档的文件的名称）

选项 -d 和 -t 用于选择要放置文件的位置以及要使用的模板（恐怕我对此一无所知：P）。例如（对于 -d）：

luadoc file.lua -d ~/Docs

据我所知，关于实际选项几乎没有其他解释（因为您的代码片段解释了它们做得足够好）。

现在，看看你在运行时遇到的错误（lua5.1: ... could not open "index.html" for writing），我建议一些事情。一，如果您编译了源代码，那么您可能在某个地方犯了错误，例如没有安装依赖项（我会对此感到惊讶，因为否则您根本无法做到）。如果你这样做了，你可以尝试从 repos 中获取它

sudo apt-get install luadoc

这也将安装依赖项。这可能是问题所在，因为我的 luadoc 工作副本从 /usr/bin 使用命令运行良好

./luadoc

这意味着您的 luadoc 很奇怪，或者您正在做一些有趣的事情（我无法从您所说的内容中解决）。我认为您已经安装了 lua5.1（考虑到错误），所以与此无关。

我给你的建议是尝试跑步

luadoc file.lua

在包含任何旧 lua 文件的 file.lua 目录中（尽管最好是其中至少包含少量数据的文件）并查看它是否在同一文件夹中生成 index.html（不要使用 -d 更改目录，以进行测试目的）。如果这不起作用，则使用 apt-get 从存储库重新安装它。如果这样做并尝试 luadoc file.lua 不起作用，则回复错误，因为更大的问题（可能）。

于 2013-07-14T19:22:12.393 回答