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

cubieboard文档计划

本帖最后由 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

支持!我有空搞一搞~哈哈:lol

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 :)
页: [1] 2
查看完整版本: cubieboard文档计划