进行文档开发,需要先准备 GitBook 环境:
- Node.js
- npm 一般会和 Node.js 一起安装
- 安装 gitbook 命令行工具,运行命令
npm install gitbook-cli -g
- 安装 gitbook,运行命令
gitbook install
进行正式开发前最好能先熟悉一下 GitBook,流程如下:
- Fork 文档仓库 cocos2d-x-docs
- clone 仓库到本地,进行改动
- 使用
gitbook serve
命令测试改动在 GitBook 中的效果 - 提交 pull request 到 cocos2d/cocos2d-x-docs 仓库
- 我们会 review 这个 PR,并将内容合并到主仓库
- 改动中文文档,请将改动限制在 zh/ 目录
- 避免使用过大的图片,过大的图片会造成加载缓慢,甚至加载失败
- 文档书写规范请参考:中文文档格式规范
- 代码块要以一种特殊的方式包裹,可以模仿已有代码块的包裹方式.
- 例如 C++ 代码块:
{% codetabs name="C++", type="cpp" -%} auto mySprite = Sprite::create("mysprite.png", Rect(0,0,40,40)); {%- endcodetabs %}
- 例如 C++ 代码块:
文档的开发,Cocos2d-x 开源社区的建设,期待你的加入!