如何从Emacs Lisp文档生成HTML?

时间:2011-05-18 08:04:29

标签: html emacs documentation

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

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

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

2 个答案:

答案 0 :(得分:1)

我认为文档不是“在Emacs-Lisp文件中编码”。它们存储为texinfo文档,可以导出为HTML(我认为GNU文档站点是如何生成的)。 texi2html可以将texinfo文件转换为HTML。

函数的文档字符串直接存储在elisp文件中。如果你想要那些,你将不得不遍历函数列表,获取文档字符串并创建一个HTML文件。我认为它应该在几行elisp中可行。

Xah Lee评论here他们应该如何使用HTML。

答案 1 :(得分:1)

部分答案可能是简单地使用/扩展现有的Lisp自动文档生成器。以下是一些可以帮助您的链接: