如何在 LDoc 中创建表格?

我如何使用 LDoc 和 lua-discount 生成表格? 是否需要特殊配置或版本?

我正在使用 LDoc 为用 Lua 编写的游戏生成文档。它基本上可以工作,但它使用的是 markdown.lua,它默认情况下不支持 markdown 表格。所以我将其切换到使用 lua-discount。但它仍然不能生成表格。

  • LDoc 文档确实指定了我可以使用 lua-discount,并且它提供了对表格的支持。
  • 我尝试使用一个示例表格来隔离问题。
  • 使用表格直接调用 lua-discount 得到相同的结果。
  • LDoc 和 lua-discount 都是使用 luarocks 安装的,没有指定版本号。
  • 我尝试切换到 lunamark,但忘记安装它,所以它默认返回到 lua-discount。所以我知道它正在检测 lua-discount。

我的 LDoc 配置:

title='一个游戏'
readme='manuals'
format='discount'
file={ 'src', 'tests', 'library/library/library.c' }
dir='docs'
no_summary=true
kind_names={ topic='手册', module='API' }

我将 markdown 文件放在手册文件夹中。为了测试,我从 PHP markdown 文档(https://michelf.ca/projects/php-markdown/extra/)中取出了表格,lua-discount 应该支持,然后将其放在自己的文件中,并在其上下留有空行:


第一标题  | 第二标题
------------- | -------------
内容单元格  | 内容单元格
内容单元格  | 内容单元格

它生成了:


    第一标题  | 第二标题
——————– | ——————–
内容单元格  | 内容单元格
内容单元格  | 内容单元格

但应该生成:

<table>
<thead>
<tr>
  <th>第一标题</th>
  <th>第二标题</th>
</tr>
</thead>
<tbody>
<tr>
  <td>内容单元格</td>
  <td>内容单元格</td>
</tr>
<tr>
  <td>内容单元格</td>
  <td>内容单元格</td>
</tr>
</tbody>
</table>
点赞
用户10152911
用户10152911

我曾经在discord.gg/code寻求帮助,有人发现我是在不同的地方使用了discount,与文档不同。原来,lua-discount有两个完全不同的版本!http://asbradbury.org/projects/lua-discount/(luarocks版本)和https://github.com/craigbarnes/lua-discount

Luarocks的版本可能已经过时,或者根本就不支持表格。

所以为了解决这个问题,我必须:

  • 下载使用CMake的分叉版本的存储库(https://github.com/squeek502/lua-discount)。
  • 添加Discount到空的Discount文件夹中。
  • 设置LUA_DIR。
  • 制作lua-discount(在Visual Studio 2019命令提示符下运行)。
  • 将发布的dll副本复制到Luarocks中。
  • 删除已安装到Program Files的discount。
2019-06-30 03:41:35