Maven 2 使用maven创建文档 我正好在重读Maven。我们的团队在上一次看到这一点时有一个糟糕的经历，因为这是在maven从1.x重新构建到2.x的时期，所以我们需要的很多依赖项没有转移到新的存储库中。然而，我现在有时间重新考虑

我对使用maven和LaTeX或DocBook创建文档感兴趣，我想知道是否有人有任何经验可以分享，项目/模块结构，好的插件可以使用，等等

非常感谢：-）

编辑：

---

我只是想澄清一下，我想写一篇技术文章/一本书，我想要的产品可能是PDF。

您可以使用mvn site命令（即使用）轻松地用Maven创建一个站点（包含文档）

这个插件创建技术报告（如Javadoc、单元测试报告、代码覆盖率…），但也可以用于创建“真实站点”。 你有更多关于这方面的细节

基本上，您可以使用（几乎是简单易懂的纯文本）或基于XML的格式来编写页面

2年前，我使用XDoc格式和SiteMaven插件为我开发的一个应用程序创建了一个完整的用户指南。在全球范围内，这是相当容易创建的

---

我希望这对你有帮助

目前还没有官方或半官方的插件可以处理LaTeX或DocBook，但您可以做的（除了使用上述站点插件外）是配置exec插件，以便在站点生命周期内（即在构建项目网站的同时）处理LaTeX/DocBook源

例如，类似

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>exec-maven-plugin</artifactId>
  <executions>
    <execution>
    <id>latex</id>
    <goals>
      <goal>exec</goal>
    </goals>
    <phase>site</phase>
      <configuration>
          ...
      </configuration>
    </execution>
  </executions>
</plugin>

org.codehaus.mojo
execmaven插件
乳胶
执行官
网站
...

DocBook是Doxia的众多支持输入之一，Doxia是maven用来生成文档的引擎。请参阅：

---

事实上，Doxia网站回答了您的确切问题：

我已经成功地使用了Maven插件Docbkx。你应该试一试

---

你绝对应该看看这本书。它可能适合你的需要。Doxia对DocBook的支持是次优的。事实上，上次我尝试它时，它产生了一些新的东西——据我所知——不是DocBook

我提到的Maven Docbkx插件支持世界上所有的定制（通过插件参数，或者XSLT覆盖，如果你喜欢的话）+它提供了一些机制来将它与Maven构建集成。（例如将Maven pom属性包含到文档中的处理说明。）

---

请注意，我们的目标是拥有一个插件，防止您自己手动组装一个处理链。所以这个插件既可以转换为FO，也可以转换为PDF

我最近使用docbook和maven的docbkx插件为我的maven多模块项目实现了项目文档。我现在有它自动生成html和pdf文件，每次我建立项目网站。我认为docbkx真的很棒，所以我建议你用它

这是真的-您可以使用maven站点和doxia插件创建一个非常好的站点。事实上，我正在使用这两种方法来生成我的项目站点，但是doxia对docbook的支持非常有限，并且不允许您模块化文档，例如，包括主文档中的部分文档。所以对于大型参考手册，我使用的是docbkx

如果你想看一眼，我的项目是。您可以下载源代码并查看其实质。当然，如果您对此设置有任何疑问，我将非常乐意提供帮助

干杯

---

卡洛斯

虽然这个问题已经很老了，但我想介绍一下最新情况。如果你想在你的文档中使用LaTeX，你应该使用maven插件来生成文档。有几个maven插件正在这样做，但是很多插件不再维护。 有一个新的maven插件，它不需要或更少的配置就可以工作，生成的PDF（或PS或DVI）可以作为工件发布

---

看看：

为什么这个问题被否决了这么多？如果有latex格式的文档，是否有其他方法来构建它？