原文链接 译者:carvendy
片段宏指南
当你使用Maven生成你的web项目,你有一部分动态选项是包括一些源码片段在你的源码页中。
一个片段是一个源码文件的部分,有指定格式的注释。
这个功能受到汇集的片段宏启发,被Maven的Doxia项目提供一种通过 Maven Site Plugin的方式。
在你的文档中包含源码片段,首先在源文档中想要包含的行加入注释,然后参考文档文件片段的id。每个片段必须分配一个id,和id在源文档中必须唯一。如果你想包含实体文件,那么id参数不需要。
在各种源文件里面这些例子,正如在APT文档格式相应的宏。
想得到更多信息和例子请看Doxia宏指南。
源码片段
Java
// START SNIPPET: snip-id public static void main( String[] args ) { System.out.println( "Hello World!" ); } // END SNIPPET: snip-id
XML
<!-- START SNIPPET: snip-id --> <navigation-rule> <from-view-id>/logon.jsp</from-view-id> <navigation-case> <from-outcome>success</from-outcome> <to-view-id>/mainMenu.jsp</to-view-id> </navigation-case> </navigation-rule> <!-- END SNIPPET: snip-id -->
JSP
<%-- START SNIPPET: snip-id --%> <ul> <li><a href="newPerson!input.action">Create</a> a new person</li> <li><a href="listPeople.action">List</a> all people</li> </ul> <%-- END SNIPPET: snip-id --%>