当前分布式版本控制系统（DVCS）相当流行，收集一些有用链接：

• Git
  • WIKI: http://git.or.cz/gitwiki/
  • BOOK: http://progit.org/book/ （*）
  • Hosting: http://github.com/
• Mercurial(hg)
  • WIKI: http://mercurial.selenic.com/wiki/Mercurial/
  • BOOK: http://hgbook.red-bean.com/ （*）
  • Hosting: http://www.bitbucket.org/

（*）：希望大家有空参与开源图书的翻译工作，可惜我现在没空

2009 年 4 月 1 日 CentOS 在邮件列表里宣布了 Release for CentOS-5.3 i386 and x86_64 。

CentOS 5.3 提供了 i386 和 x86_64 两个硬件平台的安装光盘镜像文件下载，提供了 CD 和 DVD 两种形式的安装介质，下载地址为：

• http://isoredirect.centos.org/centos/5/isos/i386/
• http://isoredirect.centos.org/centos/5/isos/x86_64/

Release Notes: http://wiki.centos.org/Manuals/ReleaseNotes/CentOS5.3

一些软件公司想对开发文档的更新和维护做改善，下面是一些邮件回复的摘要：

DOCBOOK 的确是个好东西，使用单一源文件可以生成各种格式的文件。不过，有利就有弊，对一般人而言 DOCBOOK 的学习成本比较高。DOCBOOK 在国外技术文档方面大行其道，但据我所知目前国内使用 DOCBOOK 的团队寥寥无几。从向我提问 CDBE 的人员数目可见一斑。

不过也有例外，若您的软件团队是专门搞 xml/xsl/xslt 开发的，那就不会惧怕写 xml 文件了，否则推广起来可不那么容易，不然软件世界里也就不会有 JSON 之类的文件格式了，呵呵

如果贵团队坚持要使用 DOCBOOK，我举双手赞成，不过我建议：

• 最好能雇佣一名（或多名，取决于您团队的规模）懂 DOCBOOK 的文档管理员做专职文档整理等工作
• 对于熟悉图形界面编辑器（如：WORD）的人员还是先从使用 http://www.xmlmind.com/xmleditor/ 开始
• 重要的是大家要坚持使用 DOCBOOK，我想半年之后大家也就习惯了，甚至可以直接编辑 xml 文件了

下面我再说说其他技术文档的解决方案，这种方案的核心是使用 类WIKI 的文档语法，也有学习 类WIKI 语法的成本，但似乎简单的多了。

类WIKI 语法的复杂程度也不一样，和 DOCBOOK 最贴近的是 ASCIIDOC，当然它相对其他类 WIKI 语法也较复杂

• http://www.methods.co.nz/asciidoc/ — Python
• http://sourceforge.net/projects/jasciidoc/ — Java

下面是一些轻量级的文本格式

• markdown — http://markdown.infogami.com/ – Perl/PHP/Python/Ruby/…
• reStructuredText — http://docutils.sourceforge.net/rst.html – Python
• txt2tags — http://txt2tags.sourceforge.net/ – Python

说明：

1. 若您的团队人员习惯编写纯文本文件的文档，可以选择上述一种文本格式（包括 AsciiDoc）并坚持使用，这些文件格式都可以转换成 HTML 甚至 DOCBOOK。然后将文档像程序代码一样提交到 CVS/Subversion/git/…
2. 若您的团队人员喜欢在线的协作方式，建议使用有利于管理的直接存储文本文件的 WIKI 系统（据我所知如下三种 WIKI 系统在国外的软件开发团队中使用的最多）
   • Perl 语言的 http://ikiwiki.info/ – MarkDown语法+Subversion/git/…
   • PHP 语言的 http://www.dokuwiki.org – dokuwiki语法+内置的版本控制
   • Python 语言的 http://moinmoin.wikiwikiweb.de/ – Moin语法+内置的版本控制
3. 若您的工作组偏爱基于关系数据库的在线 WIKI 系统，可使用的系统：
   • Deki – http://www.mindtouch.com/
   • MediaWiki – http://www.meidawiki.org/
4. 若您的团队使用 trac — http://trac.edgewall.org/ 做 ITS (Issue Tracking System) 和 VCS(Version Control System) ，那么建议使用 trac wiki 书写开发文档，因为 trac wiki 可以和 trac 的 ITS 融合。

如果您找到其他更好的方案，别忘了和我分享噢

参考链接

• rpath Linux：http://www.rpath.com/
• TurnKey：http://www.turnkeylinux.org/

• JeOS = “Just enough Operating System”
  • Ubuntu Server Edition JeOS：http://cdimage.ubuntu.com/jeos/
  • Orange JeOS：http://orangejeos.sourceforge.net/
    • http://www.rkosecurity.com/oj_download.html

最近在 RasHost VPS 买了个 D128 型的 VPS 试用，准备用它建几个支持 PHP 的虚拟主机站点，将操作过程记录如下，一方面做个备忘，另一方面也为具有相同需求的朋友做个参考。

文章在 Apache2, SuExec, PHP5 and FastCGI for Virtual Domains on Ubuntu 8.04

2008 年 6 月 24 日 CentOS 在邮件列表里宣布了 Release for CentOS-5.2 i386 and x86_64 。

CentOS 5.2 提供了 i386 和 x86_64 两个硬件平台的安装光盘镜像文件下载，提供了 CD 和 DVD 两种形式的安装介质，下载地址为：

• http://isoredirect.centos.org/centos/5/isos/i386/
• http://isoredirect.centos.org/centos/5/isos/x86_64/

Release Notes: http://wiki.centos.org/Manuals/ReleaseNotes/CentOS5.2

将我的 《DokuWiki 使用指南》 更新到了 V3.0，适用于 dokuwiki-2008-05-05 版本。

同时制作了使用 DokuWiki S5 插件 的 DokuWiki 使用指南 (Slide 版)。

希望对大家有用

链接

经过大家去年大半年的努力 http://symfony-project.cn/cooperate/book/start，2007年11月《symfony 权威指南》已经翻译完毕。应博文视点李冰的要求，我参加了《The Definitive Guide to symfony》中译稿的校对工作。

• 2007年12月，经过大家的努力，初稿基本校对完毕
• 经过编辑的努力，排版稿已经出炉，我正在做最后一次校对

相信一个月之内，《symfony 权威指南》就会面市了。

将本站升级到 dokuwiki 2008-05-05，并更新了一些插件。