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