2002-2006 年陆续用 DocBook 及 FreeMind 撰写了一些技术文章, 并在 2006 年将这些历史文章重新整理,尝试建立一个名为 WHODO 的项目,以期像 The Linux Documentation Project 一样建立一种易于维护的开放文档平台。
但技术的发展一日千里,一方面作为标记语言 DocBook 在易用性上被 Markdown、reStructuredText、AsciiDoc 等超越, 另一方面诸如 维基百科 等平台的成功,指明了知识共享的正确方向。
为了向下兼容,此次博客平台迁移,也将 WHODO 项目及相关文档迁移到新的平台,并将原来一个 SVN 版本库拆分为多个独立的 Git 版本库。
-
WHODO 项目编译后文档版本库,见 doc 版本库 。
主要用于 Web 页面展示: http://www.worldhello.net/doc/ 。
-
WHODO 项目中各个文档的版本库位于 GitHub 下以 doc 开头的版本库。
一个文档对应一个唯一的版本库,例如 docbook_howto 文档对应于 doc-docbook_howto 版本库 。
-
采用 Android repo 工具将各个零散版本库组织一起,见 Manifests 版本库 。
Repo 工具的用法,以及编译 WHODO 文档的过程如下:
-
下载 repo 脚本。
$ curl -L -k https://github.com/ossxp-com/repo/raw/master/repo > ~/bin/repo $ chmod a+x ~/bin/repo
-
创建工作区目录。
$ mkdir whodo $ cd whodo
-
Repo 初始化及下载 manifests.git 库。
$ repo init -u git://github.com/gotgit/manifests.git
-
下载所有相关版本库并检出到工作区。
$ repo sync $ ls -F doc/ src/
-
编译网页。(编译所需工具太繁杂,尚未整理)
$ repo start whodo $ make -C src
-
更新后的 HTML 文件在 doc 版本库 中提交。
$ cd doc $ git add -A $ git commit
-
推送至 GitHub 服务器。
$ repo config repo.pushurl ssh://git@github.com/github/ $ repo push