Doxygen for jsp pages?
我需要在Java+JSP(1)中记录一个(相当大的)项目。别让我开始)。
对于中间层(ALL。Java类),我只使用doXEGEN来生成.html和.pdf文档,但是我的主管要求我对JSP页面的文档进行文档化和集成。
Afaik Not Doxygen和JavaDoc直接适用于此工作。我错了吗?
我唯一能想到的方法是在JSP页面中插入EDCOX1 0,然后编译.jsp in .java文件,然后应用DoXEGEN…但有点太复杂了…
JSPDOC就是为此而创建的
JSPDOC能够浏览JSP的集合。原理与JavaDoc非常相似,您可以向每个JSP添加一个注释部分,如下所示:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 | <% /** <doc> <name>directory2.jsp</name> <category>System</category> <summary>List all jsp files with category and summary</summary> <history><date>10/08/01 us</date> Gilbert Brault creation</action> </history> <history><date>10/25/01 us</date> Gilbert Brault adapted pharos:foreach switch itCounter to Integer (was int before)</action> </history> <outline> <ul> <li> if refresh set or new session, list all jsp files of the server and parse them </li> <li> List files according to the following criteria <ul> <li> creation order (item #) column </li> <li> file name (no case sensitive) </li> <li> category of processing </li> </ul> </li> </ul> </outline> <todo> <ul> <li> display modification date and allow ordering by dates </li> </ul> </todo> <copyright>Schneider-Electric 2001</copyright> </doc> */ |
您可以使用三种服务浏览此收藏集:-目录->列出所有带注释的JSP-文档->提供JSP结构的摘要,包括上述文档-jspskleton:呈现HTML并将JSP嵌入为文本
参见:http://jspdoc.sourceforge.net/