轻量级doxygen html输出

时间:2014-04-12 08:32:52

标签: doxygen

doxygen是否是一个更轻量级的HTML后端,它不会在页面上填充大量的div和表格?在查看css文件时,输出看起来很臃肿。可以写另一个后端。我问是否已经存在。

我需要这个的原因

  1. 这样可以更轻松地将dox与网站的其他部分集成。

  2. 我使用hyphenate.js让我的“相关页面”看起来很棒。但是该脚本需要知道它应该使用哪些标签。使用较少的膨胀标记会更容易。

  3. Doxygen缺乏关于如何使用Firefox Web Developer工具进行逆向工程的输出标记来修改1k行CSS文件的完整文档。较少的膨胀标记减少了对文档的需求,并且使得Dimitri更容易维护文档。

  4. 较少的膨胀标记使页面更具可移植性。

2 个答案:

答案 0 :(得分:3)

使用doxygen,您可以以html格式,tex格式,XML(您可以随后根据需要解析),RTF,手册页或Docbook导出数据。

html输出支持带有 HTML_STYLESHEET 属性的自定义页眉,页脚和样式表(CSS),这可能是您想要的。您可以根据需要重写这些并调整输出。

如果没有什么让你满意,那么你可能会开始考虑使用自己的脚本语言手动解析上面的一个输出,并自己生成所需的格式(如果这适合你)或直接通过doxygen源控制输出生成(https://github.com/doxygen/

资料来源:http://www.doxygen.nl/manual/output.html

答案 1 :(得分:1)

您需要做的事情实际上取决于您最终想要达到的目标。

有输入过滤器',例如:ftp://ftp.rsa.com/pub/dsg/public/doxygen/doxyfilt.pl和'输出过滤器,例如:http://www.bigsister.ch/doxygenfilter/doxygenfilter.html。编写自定义过滤器应该完全符合您的要求。使用现有的代码并忍受它的限制将更快,并可能提供编写自己的程序的想法(如果您希望这样做)。

您可以使用您反对的输出尝试此网站http://www.dirtymarkup.com/,看看它建议的其中一个工具是否会"清理"代码足够你喜欢而不删除太多功能(IE:能够点击链接并扩展/收缩章节)。

如果你真的想要它' raw'试试HTML2Text https://pypi.python.org/pypi/html2text,然后你就可以把它重新摔回来了。使用Text2HTML http://txt2html.sourceforge.net/。这将剥离它,然后给你一些最小的HTML功能(保留链接)。

有很多' HTML< - >文本'转换器,在许多语言中,使用搜索引擎来查找自己的源;一个最适合你的。

以下是来自信誉良好的网站的工具列表:http://www.w3.org/Tools/html2things.html

以下是将语言转换为HTML的替换列表:http://www.w3.org/Tools/Prog_lang_filters.html。更多信息:http://www.w3.org/Tools/Filters.html