Поскольку мой опыт работы с HTML довольно рудиментарный (и довольно старый), я не уверен, что мое требование реалистично.
Допустим, что у меня есть довольно много файлов, содержащих исходный код Lua, и все они имеют расширение ".lua" и доступны в отдельном подкаталоге. Я бы хотел создать статический файл index.html, который при загрузке в браузере отобразил бы список файлов исходного кода lua в раскрывающемся списке. Как только один из файлов исходного кода выбран, мне бы хотелось, чтобы файл загружался в "область" на той же странице и был довольно напечатан, то есть с подсветкой синтаксиса в браузере. Мне было интересно, могу ли я использовать что-то вроде google-code-prettyfy для части, выделяющей синтаксис? Кроме того, я не знаю, можно ли загрузить внешний файл исходных файлов lua и отобразить в пределах определенной области html-страницы как отображаемую. Если да, то оценил бы, как именно.
Инструмент, подобный LDoc, может использоваться для выполнения большого количества того, что вы хотите, так как Doxygen будет использоваться для набора исходного кода на языке C.
Оба они в значительной степени обусловлены включением специально отформатированных комментариев, которые содержат документацию.
Я знаю, что Doxygen может сбрасывать исходный код в сгенерированный набор документов, я не помню о LDoc. Оба активно развиваются.
Не обязательно плохая идея использовать оба инструмента в проекте, особенно если у вас есть исходный код C, реализующий модули Lua. Вы можете использовать Doxygen для создания общего дерева документов для вашего модуля двигателя и C, а LDoc - для документирования частей Lua. Это должно быть возможно с небольшой осторожностью и конфигурацией обоих инструментов, чтобы заставить их хорошо играть вместе.