这是 WHODO 项目的 Manifests 版本库。 WHODO 项目中的每个文档使用独立的 Git 版本库进行维护,通过本 Manifests 版本库的 XML 文件组织在一起, 并使用源自 Android 项目的名为 repo 的工具进行管理。
-
WHODO 项目中各个文档的版本库位于 GitHub 下以
doc-
前缀开头的版本库。一个文档对应一个唯一的版本库,例如 docbook_howto 文档对应于 doc-docbook_howto 版本库 。
-
WHODO 项目编译后文档版本库,见 doc 版本库 。
主要用于 Web 页面展示: http://www.worldhello.net/doc/ 。
-
Manifests 版本库 以及 Android repo 工具将各个零散版本库组织一起。
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