Documentation 谷歌代码维基在项目文档中的最佳使用

Documentation 谷歌代码维基在项目文档中的最佳使用,documentation,google-code,Documentation,Google Code,我最近将我的项目从sourceforge转移到Google代码。我对与svn集成的GoogleCodeWiki很感兴趣,但我不确定使用它来提供项目文档的最佳方式 对于我的项目,文档可以出现在三个地方:(1)在wiki上,(2)在我正在开发的桌面应用程序中(使用wxPython),以及(3)在项目网站上(基于Drupal) 我喜欢使用GoogleCodeWiki作为文档的主要来源,然后在桌面应用程序和项目网站上自动合并这些文档 有人对此有什么建议吗?Wiki文件位于Subversion中--只需s

我最近将我的项目从sourceforge转移到Google代码。我对与svn集成的GoogleCodeWiki很感兴趣,但我不确定使用它来提供项目文档的最佳方式

对于我的项目,文档可以出现在三个地方:(1)在wiki上,(2)在我正在开发的桌面应用程序中(使用wxPython),以及(3)在项目网站上(基于Drupal)

我喜欢使用GoogleCodeWiki作为文档的主要来源,然后在桌面应用程序和项目网站上自动合并这些文档


有人对此有什么建议吗?

Wiki文件位于Subversion中--只需
svn签出即可http://yourproject.googlecode.com/svn/wiki yourwiki
,您将获得一个易于更新的
yourwiki
SVN存储库(只需偶尔在其中
SVN up
,例如在crontab中)


Wiki文件的格式是一种格式,因此您可以编写脚本将其转换为纯ReST,并从中转换为其他用途所需的任何其他格式——或者,在系统上编写ReST,将其转换为您喜欢的任何格式(可能包括Google的Wiki格式;-),然后上传…

Nit:语法实际上是谷歌自己设计的。据我所知,能够将.wiki语法解析为其他格式的库非常少,但这个答案非常正确,因为其余的可以无限转换。如果您已经在使用Python,您可以在Sphinx构建系统下用ReST编写文档,然后将其编译为静态HTML,该HTML由Google的SVN服务器提供,而不是使用Google的特殊语法。感谢您的澄清——我将相应地编辑我的答案!