在外部文件中漂亮打印 Lua 源代码，而不将其嵌入 HTML 文件中答案

【问题标题】：Pretty-print Lua source-code in external file, without embedding it in the HTML file在外部文件中漂亮打印 Lua 源代码，而不将其嵌入 HTML 文件中
【发布时间】：2013-10-25 18:37:08
【问题描述】：

由于我在 HTML 方面的经验相当初级（而且相当陈旧），我不确定我的要求是否切合实际。

假设我有很多包含 Lua 源代码的文件，并且所有文件都具有“.lua”扩展名并在特定的子目录中可用。我想做的是创建一个静态 index.html 文件，当它在浏览器中加载时，会在下拉列表中显示 lua 源代码文件的列表。一旦选择了其中一个源代码文件，我希望该文件被加载到同一页面上的“区域”中，并且打印得非常漂亮，即在浏览器中具有语法高亮显示。我想知道是否可以将google-code-prettyfy 之类的东西用于语法高亮部分？另外，我不清楚是否可以加载外部 lua 源代码文件，并在渲染时显示在 html 页面的某个区域内。如果是，将不胜感激详细说明如何部分。

【问题讨论】：

这与 Lua 无关，除非“加载 Lua 文件”是指“执行 Lua 文件”，就像在 HTML 页面中执行嵌入的 Javascript 脚本一样。 Lua 源代码只是文本文件，就在网页中呈现它们而言。
“加载 Lua 文件”更多的是“包含”Lua 源代码，用于美化和显示代码，而不是执行 Lua 源代码。将它们视为文本文件就足够了，只是我想在运行时“包含”并美化它们。
@LorenzoDonati，就我个人而言，我不认为关于如何记录和呈现 Lua 源代码的讨论完全是题外话。 Lua 对代码着色提出了自己的挑战。
@RBerteig 好的，公平点。在我看来，从 OP 的措辞看来，问题在于网页和漂亮程序之间的交互，而 Lua 只是一个示例（因此 Lua 标记可能具有误导性）。确实，你说的很有道理，所以我不再反对将这个问题也标记为 Lua。

标签： html lua syntax-highlighting pretty-print

【解决方案1】：

像LDoc 这样的工具可以用来完成很多你想要的事情，就像Doxygen 用于C 语言源工具包一样。

两者都受到包含带有文档的特殊格式的 cmets 的强烈驱动。

我知道 Doxygen 可以将源代码折叠到生成的文档集中，我不记得 LDoc。两者都在积极开发中。

在一个项目中同时使用这两种工具不一定是个坏主意，尤其是当您有实现 Lua 模块的 C 源代码时。您可以使用 Doxygen 为您的引擎和 C 模块构建整体文档树，并使用 LDoc 构建 Lua 部分的文档。应该可以对这两种工具稍加注意和配置，以使它们一起玩得很好。

【讨论】：

谢谢@RBerteig。我希望能够对任何 Lua 代码进行语法高亮显示，例如，一旦将其上传到网站。我相信 LDoc 和 LuaDoc 需要对源代码进行一些注释/注释，不是吗？我将检查 LDoc（以及 LuaDoc），看看它们是否可用于生成任何有用的 HTML 文件，如果它们没有 cmets，则包含漂亮的打印代码（语法高亮、行号等）。但是，它仍然需要这个离线（批量转换）阶段。