在LDoc中创建表?

时间:2019-06-30 01:08:43

标签: lua markdown

如何使用LDoc和lua-discount生成表? 我需要一些特殊的配置或版本吗?

我正在使用LDoc为Lua编写的游戏生成文档。它在大多数情况下都有效,但是它使用markdown.lua,默认情况下不支持markdown表。因此,我将其切换为使用lua-discount。但是它仍然不会生成表。

  • LDoc文档确实指定了我可以使用lua-discount,并且它提供了对表的支持。
  • 我尝试使用示例表来找出问题所在。
  • 直接在表中调用lua-discount会产生相同的结果。
  • LDoc和lua-discount都是使用没有任何版本号的luarocks安装的。
  • 我尝试切换到lunamark,但忘记安装它,因此它默认恢复为lua-discount。所以我知道它正在检测lua折扣。

我的LDoc配置:

if (mydata$year >= 1992) {
  mydata$location_1 <- sub("Ethiopia", "Ethiopia (-1992)", mydata$location_1)
} else mydata$location_1 <- sub("Ethiopia", "Ethiopia (1993-)", mydata$location_1)

我将markdown文件放置在manuals文件夹中。为了进行测试,我从应该接受lua-discount支持的PHP markdown文档(https://michelf.ca/projects/php-markdown/extra/)中获取了表格,并将其放在自己的文件中,并在其上方和下方都有空白行:

title='A game'
readme='manuals'
format='discount'
file={ 'src', 'tests', 'library/library/library.c' }
dir='docs'
no_summary=true
kind_names={ topic='Manuals', module='API' }

它生成了:


First Header  | Second Header
------------- | -------------
Content Cell  | Content Cell
Content Cell  | Content Cell

但应生成:



    First Header  | Second Header
——————– | ——————–
Content Cell  | Content Cell
Content Cell  | Content Cell


1 个答案:

答案 0 :(得分:0)

我被引导到discord.gg/code寻求帮助,那里的某人注意到我使用的折扣与记录的有所不同。原来,有2种完全不同的lua-discount版本! http://asbradbury.org/projects/lua-discount/(来自luarocks的版本)和https://github.com/craigbarnes/lua-discount

luarocks上的版本已经过时,或者从未真正支持表。

因此,要解决此问题,我必须:

  • 下载使用CMake(https://github.com/squeek502/lua-discount)的存储库的分支版本。
  • 在空的折扣文件夹中添加折扣。
  • 设置LUA_DIR。
  • 进行lua折扣(与Visual Studio 2019命令提示符配合使用)。
  • 将发行版dll复制到luarocks。
  • 删除折扣,该折扣已安装到程序文件中。