我工作的公司已经开始使用Confluence来记录软件开发和相关流程。我们正在研究使用在 wiki 上创建的内容来创建用户手册,作为用于硬拷贝的 PDF 和用于基于 Web 的手册的 HTML。我想知道是否有人对这个特定的工作流程有任何建议?
干杯。
我工作的公司已经开始使用Confluence来记录软件开发和相关流程。我们正在研究使用在 wiki 上创建的内容来创建用户手册,作为用于硬拷贝的 PDF 和用于基于 Web 的手册的 HTML。我想知道是否有人对这个特定的工作流程有任何建议?
干杯。
Confluence 用户指南是我找到的关于如何创建技术文档的最佳资源:
http://confluence.atlassian.com/display/DOC/Developing+Technical+Documentation+on+Confluence+Wiki
基本上概述了 Atlassian 如何使用他们自己的产品来创建其文档(非常自我参考的圈子)。
首先,我认为使用 Confluence 的优势在于它是在线的,并且可以同时被很多人更改。所以通过打印出来,你失去了这里的一些优势。
Confluence 提供了一些开箱即用的机制,您应该检查它们是否足以满足您的需求。
因此,请执行以下操作:
Browse > Advanced > HTML Export and PDF Export
Browse > Space Admin > PDF Layout and PDF Stylesheet
(从未尝试过)。Browse > Advanced > XML Export
和使用其他一些技术以您想要的形式导出。如果第一个实验足够,则工作流程很简单,类似于上面的四点。如果没有,使用 XML 格式构建自己的导出器可能需要做很多工作。
还有一点:所有这一切的前提条件是您要发布的内容恰好存在于一个空间中。因此,您可能需要通过包含或排除页面来调整您的空间
我过去有过以下经历...
eg. .hide { display: none; }
.