如何从Emacs Lisp文档生成HTML？

Question

Emacs称自己为自我记录.这意味着您可以使用Emacs来读取在Emacs-Lisp文件中编码的文档.

有没有一种简单的方法可以将此文档导出为HTML,以便可以将文档放在网站上？我知道FSF在http://www.gnu.org/software/emacs/manual/emacs.html上发布文档,但并不是所有的Emacs模块都列在那里.

更新:我对elisp文件中的文档感兴趣,而不是texinfo文件.我还想要功能和"主要模式"的文档.在Emacs文档查看器中,这都是很好的超链接,如果它保存在HTML中会很棒.

Answer 1

我不认为文档是“在 Emacs-Lisp 文件中编码的”。它们存储为 texinfo 文档，可以导出为 HTML（我认为 GNU 文档站点就是这样生成的）。texi2html可以将 texinfo 文件转换为 HTML。

函数的文档字符串直接存储在 elisp 文件中。如果您想要这些，您必须遍历函数列表、获取文档字符串并创建 HTML 文件。我认为只需几行 elisp 就可以做到。

Xah Lee在这里评论了他们应该如何使用 HTML。