cubieboard文档计划

hipboi · 发表于 2013-3-12 19:30:05

本帖最后由 hipboi 于 2013-3-12 21:05 编辑

经过大家在qq群讨论和普遍反映cubieboard文档不足，我新建了一个cubieboard的user guide项目。项目地址在：

https://github.com/cubiebook/cubiebook

新建这个项目的目的在于希望大家通过开放的，共同协作的方式能够写一本关于cubieboard的书，最终希望能出版。

如何参与：

直接在github网页上操作的方法：
1.注册并登录github，打开 https://github.com/cubiebook/cubiebook
2.点击右上角fork，完成后你会被带到 https://github.com/你的用户名/cubiebook 页面
3.点击任何一个README.md，转到README.md页面，点击edit进入编辑页面。
4.在编辑页面你可以在code和preview之间切换，编辑code，在preview看结果，他的语法类似wiki。
5.编辑完成之后，在commit summary里填入改动的原因，如果改动描述文字较多，还可以在Extended description里面写更多的。然后点commit change。
6. commit change 之后，回到 https://github.com/你的用户名/cubiebook 页面，点击pull request，向cubiebook的管理小组申请加入你的改动。你会被带到new pull request 页面，在title里简单描述写上你都改了什么，然后点send pull request。管理小组会审核你的pull request，通过了github会告诉你。

下载到本地编辑的方法：
windows:
1.首先注册一个github帐号，如果没有的话。登录后在
https://github.com/cubiebook/cubiebook
页面点右上角的fork按钮，这样你就有了你的cubiebook的仓库
下载并安装github for windows
http://windows.github.com/

2.下载并安装markdownpad，我们用这个来编辑我们的文章。下载普通版的就好了，蓝色的那个。
http://markdownpad.com/

3.打开github for windows，

点击clone，下载你的cubiebook仓库。下载完成后，鼠标右键-> open in explorer：

用markdownpad打开编辑：

编辑完之后，保存，退出markdown
打开github for window，双击cubiebook repository，你会看到显示你的改动窗口。

在uncommited changes里面填上改动的简要介绍。添加简介完成后，点commit

出现unsynced commits
点击 sync 就同步到github服务器上去了。

打开 https://github.com/你的用户名/cubiebook 页面，点击pull request，向cubiebook的管理小组申请加入你的改动。你会被带到new pull request 页面，在title里简单描述写上你都改了什么，然后点send pull request。管理小组会审核你的pull request，通过了github会告诉你。

hipboi · 发表于 2013-3-12 20:44:11

本帖最后由 hipboi 于 2013-3-12 21:06 编辑

下载到本地编辑的方法：
Linux：
1. 首先注册一个github帐号，如果没有的话。登录后在
https://github.com/cubiebook/cubiebook
页面点右上角的fork按钮，这样你就有了你的cubiebook的仓库
然后命令行运行
git clone https://github.com/你的用户名/cubiebook.git

2. 安装ReText，linux下的编辑器
sudo apt-get install retext

3. 使用ReText编辑
cd cubiebook
retext README.md
按ctrl+shift+E，打开实时预览模式

开始编辑。

4. 编辑完成之后，提交。
git add
git commit
git push origin master
这样就把你的改动保存到github上面了。

5.在 https://github.com/你的用户名/cubiebook 页面，点击pull request，向cubiebook的管理小组申请加入你的改动。你会被带到new pull request 页面，在title里简单描述写上你都改了什么，然后点send pull request。管理小组会审核你的pull request，通过了github会告诉你。

play4fun · 发表于 2013-3-20 13:21:05

支持！我有空搞一搞~哈哈

kenchowcn · 发表于 2013-3-30 10:28:24

fork一下！

blessed · 发表于 2013-5-6 13:47:36

支持楼主！看了一下，放资料上去的人不是很多啊

cokeboy · 发表于 2013-5-6 16:06:53

支持，已fork

matson · 发表于 2013-5-6 22:24:46

提了一个错误的pull request, hipboi帮我取消掉，我重新提过

ishz2013 · 发表于 2013-5-15 19:11:31

很好，跟随楼主！！！

siriux · 发表于 2013-5-16 10:24:14

mark....

yzyyou · 发表于 2013-6-26 17:06:29

fork,edit

		自动登录	找回密码
密码			立即注册