类似于Wiki的用于编写规范和文档的工具[关闭]


9

我正在寻找一个Wiki或类似Wiki的系统来编写和管理软件项目的规范和文档。

我知道有很多Wiki实现可用,但是是否有一些特别适合此类任务的实现?

实际上,它不必是Wiki,而仅仅是一个可以轻松编写和浏览规格和文档并支持变更跟踪的系统。


1
您是否正在使用特殊平台?例如微软的TFS?
Saeed Neamati 2011年

按照@Saeed的要求,您的团队/组织已经为知识管理和共享建立了哪些基础架构?另外,您目前编写规范和文档的流程是什么?
汤玛斯·欧文斯

Answers:


6

我们正在使用LaTeX和SVN。由于LaTeX文档只是文本文件,因此与某些二进制或部分二进制格式不同,它可以很好地与版本控制一起使用。

通过将代码与代码控制结合使用,您将获得习惯于使用版本控制的所有优点(和缺点)。

LaTeX进行了一些设置(定义自己的样式/类),但是一旦完成,它就非常好-您可以只专注于内容而不是内容(而不是像往常一样不断调整)所见即所得(WYSIWYG),但最后仍会获得一个光滑,专业的PDF文档。


4

就个人而言,我真的很喜欢Tiddly Wiki

它具有相当完整的Wiki语法,是一个自包含的html文件,并且无需服务器即可与各种Web浏览器一起很好地工作。

它甚至具有可扩展的插件体系结构,该体系结构使您可以添加插件来执行各种有趣的事情,例如加密小提琴手或添加脚注。


3

对于Microsoft平台,您正在寻找与SharePoint进行TFS(Team Foundation Server)集成。通过创建一个新的团队项目,您可以选择一个涵盖软件开发过程几乎每个方面的模板。它为您提供了一个门户,您可以在其中定义团队成员,分配他们的角色和安全权限,上载,共享和编辑与您的项目相关的文档和规范,并使用它做很多其他有趣的事情。

对于其他平台,我认为您可以使用类似GitHub的东西(尽管我不确定)。



0

您可以尝试Sphinx,将文档签入您选择的源代码管理基础架构中。这具有源代码控制和相对轻量级的标记语言reStructuredText的优点,该语言易于学习,并且可以很好地进行转换(转换为HTML,PDF等)。

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.