Создание таблиц в LDoc? - PullRequest
       24

Создание таблиц в LDoc?

0 голосов
/ 30 июня 2019

Как мне сгенерировать таблицы с LDoc и lua-discount? Нужна ли какая-то специальная конфигурация или версия?

Я использую LDoc для генерации документации для игры, написанной на Lua. Он работает по большей части, но использует markdown.lua, который по умолчанию не поддерживает таблицы уценок. Поэтому я переключил его на использование lua-discount. Но он все еще не генерирует таблицы.

  • В документации LDoc указано, что я могу использовать lua-discount и что она поддерживает таблицы.
  • Я попытался использовать пример таблицы, чтобы изолировать проблему.
  • Вызов lua-discount напрямую из таблицы дает тот же результат.
  • LDoc и lua-discount были установлены с использованием luarocks без номера версии.
  • Я попытался перейти на lunamark, но забыл установить его, поэтому по умолчанию он вернулся на lua-discount. Итак, я знаю, что это обнаружение lua-скидки.

Моя конфигурация LDoc:

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' }

Я помещаю файлы уценки в папку руководств. Для тестирования я взял таблицу из документации по разметке PHP (https://michelf.ca/projects/php-markdown/extra/),, которую должна поддерживать lua-discount) и поместил ее в отдельный файл с пустыми строками над и под ней:


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

Сгенерировано:



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


Но должно сгенерировать:

<table>
<thead>
<tr>
  <th>First Header</th>
  <th>Second Header</th>
</tr>
</thead>
<tbody>
<tr>
  <td>Content Cell</td>
  <td>Content Cell</td>
</tr>
<tr>
  <td>Content Cell</td>
  <td>Content Cell</td>
</tr>
</tbody>
</table>

1 Ответ

0 голосов
/ 30 июня 2019

Меня направили на discord.gg/code за помощью, и кто-то там заметил, что я использовал скидку не так, как было задокументировано. Оказывается, есть 2 совершенно разные версии lua-скидки! http://asbradbury.org/projects/lua-discount/ (версия от luarocks) и https://github.com/craigbarnes/lua-discount.

Версия на luarocks либо устарела, либо никогда не поддерживала таблицы.

Итак, чтобы решить эту проблему, мне пришлось:

  • Скачать разветвленную версию репозитория, использующего CMake (https://github.com/squeek502/lua-discount).
  • Добавить скидку в пустую папку скидок.
  • Установить LUA_DIR.
  • Сделать lua-discount (работает с командной строкой Visual Studio 2019).
  • Скопируйте dll выпуска в luarocks.
  • Удалить скидку, которая была установлена ​​в Program Files.
Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...