BLOG

DVCS

当前分布式版本控制系统(DVCS)相当流行,收集一些有用链接:

(*):希望大家有空参与开源图书的翻译工作,可惜我现在没空 :-(

, ,
· 2009/09/04 16:11 · 103 Comments

CentOS 5.3 Released

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

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

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

· 2009/03/31 22:24 · 1 Comment

Software Document Development

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

是否使用 DOCBOOK

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

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

两种解决方案

DOCBOOK 方案

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

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

轻量级的解决方案

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

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

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

说明:

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

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

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

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

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

CentOS 5.2 Released

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

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

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

《DokuWiki 使用指南》 更新 V3

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

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

希望对大家有用 :-)

Download Citrix XenServer 4.1 Trial

Citrix XenServer 4.1 Trial License Keys

Enterprise Edition 30-day trial license key for Enterprise Edition right-click and save
Standard Edition 30-day trial license key for Standard Edition right-click and save

Citrix XenServer 4.1 Installation ISOs

These downloads may be used for any edition of Citrix XenServer. All editions other than Express Edition require a license key.

In order to run Windows guests, the system must have processors with Intel VT or AMD Virtualization support, and for Intel VT systems, it must be possible to enable this feature in the system's BIOS.

Software downloaded from this page may be used only in accordance with Citrix End User License Agreement (EULA).

May be used to validate the authenticity of the file.

Product CD Image (ISO) MD5 Checksum
Linux Guest Support CD Image (ISO) MD5 Checksum
XenCenter installer (MSI) MD5 Checksum

Citrix XenServer 4.1 Documentation

Release Notes The release notes cover any known issues with this release of XenServer. Please read them before installing the product. Read HTML PDF
Installation Manual The installation guide walks you through how to install the software on a physical machine to convert it into a XenServer virtualization platform. Read HTML PDF
Guest Installation Manual Once you have installed a XenServer system, this guide will show you how to install guest operating systems such as Windows or Linux. Read HTML PDF
Administrator's Guide The comprehensive reference manual for all the powerful features provided by your XenServer system, including the command-line interface documentation. Read HTML PDF
SDK Guide Tutorial for using the XenAPI Software Development Kit to develop your own applications to control XenServer hosts via various programming languages and shell scripts. Read HTML PDF
XenAPI Specification Specifications and example code samples for the XenAPI, to be read in conjunction with the guide above. Read HTML

Citrix XenServer 4.1 supplemental CDs and files

Software downloaded from this page may be used only in accordance with Citrix End User License Agreement (EULA).

May be used to validate the authenticity of the file.

Software Development Kit(ZIP) MD5 Checksum
Driver Development Kit(ISO) MD5 Checksum

Citrix XenServer 4.1 source CDs

为《symfony 权威指南》校稿

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

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

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

升级 sinosmond.com

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

blog.txt · 最后更改: 2007/11/30 08:09 由 osmond
Recent changes RSS feed Creative Commons License Donate Driven by DokuWiki