Documents, back compatible for worldhello.net.
HTML Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_layouts
agile_python
bcp
bug_tracking
cvs_vs_starteam
dns_howto
docbook_howto
email_howto
freemind
health
inn_howto
mailinglist
makefile_howto
my.record
nightlybuild
personal_firewall
pgp
program_rules
python
raspi-memo
search_engine
svn_hooks
website_howto
whodo_howto
wiki_howto
.gitignore
Makefile
Makefile.tmpl
README.md
_config.yml
index.md

README.md

2002-2006 年陆续用 DocBookFreeMind 撰写了一些技术文章, 并在 2006 年将这些历史文章重新整理,尝试建立一个名为 WHODO 的项目,以期像 The Linux Documentation Project 一样建立一种易于维护的开放文档平台。

但技术的发展一日千里,一方面作为标记语言 DocBook 在易用性上被 Markdown、reStructuredText、AsciiDoc 等超越, 另一方面诸如 维基百科 等平台的成功,指明了知识共享的正确方向。

为了向下兼容,此次博客平台迁移,也将 WHODO 项目及相关文档迁移到新的平台,并将原来一个 SVN 版本库拆分为多个独立的 Git 版本库。

Repo 工具的用法,以及编译 WHODO 文档的过程如下:

  1. 下载 repo 脚本。

    $ curl -L -k https://github.com/ossxp-com/repo/raw/master/repo > ~/bin/repo
    $ chmod a+x ~/bin/repo
    
  2. 创建工作区目录。

    $ mkdir whodo
    $ cd whodo
    
  3. Repo 初始化及下载 manifests.git 库。

    $ repo init -u git://github.com/gotgit/manifests.git
    
  4. 下载所有相关版本库并检出到工作区。

    $ repo sync
    $ ls -F
    doc/ src/
    
  5. 编译网页。(编译所需工具太繁杂,尚未整理)

    $ repo start whodo
    $ make -C src
    
  6. 更新后的 HTML 文件在 doc 版本库 中提交。

    $ cd doc
    $ git add -A
    $ git commit
    
  7. 推送至 GitHub 服务器。

    $ repo config repo.pushurl ssh://git@github.com/github/
    $ repo push