这里是 Ceph 文档中文版的源码,编译好的位于: https://github.com/drunkard/ceph-readable-doc
词语的翻译应该尽量一致,请参考: doc:`/translation-convention`。
尽量遵守原文档的书写风格,如缩进、不超过 80 列宽、等。
有些风格是中文版特有的,如:
本项目的更新是对照着 Ceph 项目原文和 doc/ 目录相关的 commit 历史进行的,这样就无需挨篇对照。
以下只是大致步骤,路径不同时还需修改脚本:
- mkdir /git && cd /git
- git clone https://github.com/ceph/ceph.git
- git clone https://github.com/{你的github用户名}/ceph-Chinese-doc.git
- cd /git/ceph-Chinese-doc/ && ./update-doc.sh
- # update-doc.sh 脚本用了 git 和 tig 命令,最好先检查下安装了没。
- # 对照着 tig 里的 commit 历史开始更新中文文档!
- # 从最下面的 commit 开始翻译!!!
- # 更新一或多个 commit 后提交到 git 库:
- ./commit-updated.sh
- git push origin
- vi update-doc.sh # 更新 SYNC_START 变量
然后可以在 github 上向我反馈您的更新 :-)
- eselect python set python2.7
- ln -sf /usr/bin/python2.7 /usr/bin/python
这些文档从 ceph 源码中的 doc/ 目录翻译而来,结构未变,所以您仍然可以用原文档的构建方法构建此文档。只需用此库替换 ceph 源码库的 doc 目录,具体步骤如下:
- mkdir /git && cd /git
- git clone https://github.com/ceph/ceph.git
- git clone https://github.com/drunkard/ceph-Chinese-doc.git
- cd /git
- ln -s /git/ceph-Chinese-doc /git/ceph/doc
- cd /git/ceph
- ./admin/build-doc html man
- cd /git/ceph
- ./admin/serve-doc
来源: http://www.tuicool.com/articles/M7NF7b7