生成FreeMarker FTL库的HTML文档
|
我有一个想随产品一起提供的FreeMarker库,我正在寻找一种基于FTL文件中的注释(以Javadoc方式)为其生成HTML文档的方法。
例如,我库中的一个典型函数写为:
<#--
MyMacro: Does stuff with param1 and param2.
- param1: The first param, mandatory.
- param2: The second param, 42 if not specified.
-->
<#macro MyMacro param1 param2=42>
...
</#macro>
我没有找到关于该主题的任何内容,可能是因为FreeMarker中没有标准的注释编写方式(例如Javadoc中的@param
或@returns
)。
我不介意为此使用自己的解决方案,但是我热衷于使用现有的系统(例如Doxia(因为我正在使用Maven来构建项目)或Doxygen),而不是从头开始编写东西。
理想情况下,我只想编写注释解析代码,然后依靠其他方法检测宏并生成doc结构。
如果有帮助,我愿意更改评论的格式。
没有找到相关结果
已邀请:
1 个回复
荤碗
是正常的FreeMarker
对象):
为您的给定示例宏生成:
然后,您如何解析注释;-) 更新:在我的备份中找到了一个名为ѭ8的东西,并将其上传到GitHub。也许这就是您要寻找的...