Maven Doxia Apt格式的格式代码

Maven Doxia Apt格式的格式代码,maven,documentation,apt,doxia,Maven,Documentation,Apt,Doxia,我目前正在为我们的一个项目编写文档。为了简单起见,我们选择使用几乎纯文本(APT)格式,请参见此处的更多信息: APT是一种很好的文档格式,因为它使用了最少的语法,因此在不了解APT的情况下创建和更改文档非常容易 然而,我找不到一种好的方式来格式化代码。是否有可用于包含某些源代码的代码标记或类似标记?我知道我可以使用FML,但这不太理想 谢谢我最终使用了《Doxia宏指南》中的snippet宏: 它将代码片段文件中的代码逐字放入一个框中。但是,它不提供语法 doxia include宏的1.0

我目前正在为我们的一个项目编写文档。为了简单起见,我们选择使用几乎纯文本(APT)格式,请参见此处的更多信息:

APT是一种很好的文档格式,因为它使用了最少的语法,因此在不了解APT的情况下创建和更改文档非常容易

然而,我找不到一种好的方式来格式化代码。是否有可用于包含某些源代码的代码标记或类似标记?我知道我可以使用FML,但这不太理想


谢谢

我最终使用了《Doxia宏指南》中的snippet宏:


它将代码片段文件中的代码逐字放入一个框中。但是,它不提供语法

doxia include宏的1.0版不在maven central,但以下版本为:

皮肤突出显示现成的语法。你可以找到一个例子。有关Fluido中语法突出显示的信息:“源代码部分通过Google code Prettify增强,用户可以从Fluido网站上选择启用行号渲染(默认禁用)”

对于那些仍然想知道如何在APT中截取代码的人:

     This is regular text
+---------------------
This is a code snippet
+---------------------
      More regular text

语法正确。Fluido确实强调了使用开箱即用,正如其他人提到的那样

然而,Doxia在站点插件3.3中的一个变化破坏了Fluido。修复了此问题,但尚未发布

变通办法

  • 使用site.xml
    
    $(文档).ready(函数(){
    $(“div.source pre”).addClass(“prettyprint”);
    预打印();
    });
    
  • 使用站点插件3.2
  • 构建包含MSKINS-86修复程序的未发布Fluido 1.4,并使用它代替1.3.1

  • 刚刚看到这个插件:但是,hightlight功能似乎不适用于java或xml。还有一个项目:。但是,我无法构建pom.xml,因为缺少依赖项:项目构建错误:无法解决的构建扩展:Plugin org.apache.maven.plugins:maven site Plugin:3.0-beta-3或其一个依赖项无法解析:无法在central()中找到工件org.tinyjee:doxia include macro:jar:1.0这个项目也有同样的问题:对于那些仍然想知道如何在APT中生成代码片段的人来说:+--------------您在示例中提供的链接页面似乎是用xdoc创建的,而不是用APT创建的(请参阅)。您是否知道一个使用Fluido/Google代码美化APT的示例?(我的项目似乎无法实现……也许我也应该求助于xdoc)@evandor Maven Fluido Skin项目本身使用APT;网站是使用APT()创建的。
    +---------------------
    code
    +---------------------