Documentation 将Confluence wiki内容转换为硬拷贝/web用户手册的工作流？

我工作的公司已经开始使用它来记录软件开发和相关过程。我们正在研究使用wiki上创建的内容来创建用户手册，例如纸质版的PDF和基于web的手册的HTML。我想知道是否有人对这个特定的工作流程有任何建议

---

干杯。

首先，我认为使用Confluence的优势在于它是在线的，可以同时被许多人更改。所以通过打印出来，你失去了一些优点

汇流提供了一些开箱即用的机制，您应该检查它们是否足够

以下各点也是如此：

获取现有（小）wiki空间并将该wiki空间导出为HTML和PDF。请参见

Browse>Advanced>HTML导出和PDF导出中的菜单项

有一些选项可以选择是否包含（分层）页面

如果你想调整它，在

浏览>空间管理>PDF布局和PDF样式表中有一些选项（从未尝试过）

对于HTML，您当然可以首先调整Confluence导出的样式表

如果这还不够，可以使用

Browse>Advanced>XML export

为自己构建导出，并使用其他一些技术以您想要的形式导出

如果第一个实验足够，那么工作流程是直接的，类似于上面的四点。否则，使用XML格式构建自己的导出器可能需要做很多工作

还有一点：每一个必要条件是，您要发布的内容正好位于一个空间中。因此，您可能必须通过包含或排除页面来调整您的空间

我过去有过以下经历

• 我发现没有办法调整导出（PDF）中页面的顺序
• PDF的布局很奇怪（即使是一个wiki页面），但这可能同时也发生了变化。对于我所做的一个讲座（在合流中创建内容），我通过CSS、Opera中的打印预览和按正确顺序收集PDF的组合打印出来
• HTML格式还可以，如果很容易隐藏我不想在HTML版本中显示的内容（

  eg..hide{display:none；}

  ）

---

汇流用户指南是我找到的关于如何创建技术文档的最佳资源：

基本上概述了Atlassian dogfoods如何创建自己的产品文档（非常自我参考的循环）