使用码云和博客园学习简易教程

有了《使用开源中国（码云）托管代码》和《使用博客园进行学习》, 不少同学可以使用使用码云和博客园来学习了，也有不少同学还是误用。我以一周的学习过程为例，写一个step by step的教程。

我们以Linux（Ubuntu）环境下的学习为例，需要你掌握别出心裁的Linux命令学习法中的内容。

首先在Ubuntu中安装配置git，user.name中最好有学号信息:

sudo apt-get install git
git config --global user.name "20155200rocedu"  
git config --global user.email "rocedu@qq.com"

我在码云上建立了课程组织BESTI.IS.Java2017,大家可以在组织中创建自己的学习项目:

现在助教和课代表已经是管理员了，参考2016-2017-2 《Java程序设计》课程学生博客和代码托管链接尽快把同学们加为“开发者”：

我们可以在组织中通过点击“新建项目”建立自己的学习项目了，项目名称中一定要体现学号信息，语言和.gitignore都选择Java：

建好的学习项目如下图所示：

我们在Ubuntu中通过git clone https://git.oschina.net/bestiisjava2017/ljp20155200_JavaProgramming.git 来克隆我们的学习项目，
需要注意的是，项目链接有两种方式HTTPS和SSH两种，我们选择复制HTTPS的链接，这样不需要公私钥对，只要码云的用户名和口令就行了。想用SSH的可以自己学习。

如上图，参考《Java学习笔记(第8版)》学习指导建立教材学习项目目录，我们先使用mkdir src,mkdir bin建立src和bin目录。我们通过vi src/Hello.java或atom src/Hello.java编辑代码，输入以下程序：

1 public class Hello {
2     public static void main(String []args){
3         System.out.println("Hello Java World!");
4     }
5 }

下面我们编译运行Hello.java程序。最简单的办法是到src目录中使用javac Hello.java,Java Hello进行编译和运行。这时Hello.java和Hello.class都在src目录中，如下图我们通过javac -d bin src/Hello.java把Hello.class产生在bin目录中，通过cd bin,java Hello,cd ..来运行Hello.class 并保证工作目录是项目根目录：

代码编译运行没有问题了，我们通过git add .,git commit把刚才的工作纳入版本控制，通过"git push"把我们的工作推送到码云上。

到码云上我们可以看到本地的代码和脚本已经上传到网站上了。

编译运行我们可以通过vim run.sh写一个脚本简化，以后可以使用Ant,Gradle等让编译自动化。

#!/bin/sh

javac -d bin src/Hello.java
cd bin
java Hello
cd ..

注意要用chmod +x run.sh给脚本加上执行权限。脚本测试没有问题，我们使用git add .,git commit -m "add run script" 把脚本纳入版本控制中。

我们使用vim src/Hello.java编辑Hello.java代码，加入一行打印己学号姓名的代码：

1 public class Hello {
2     public static void main(String []args){
3         System.out.println("Hello Java World!");
4         System.out.println("Hello 20155200 rocedu!");
5     }
6 }

通过脚本进行编译、运行的结果如下：

没有问题，我们使用git add .,git commit -m "print student id and name" 把新加代码提交到版本控制系统中。

这样，参考积极主动敲代码，使用JUnit学习Java中的学习方法就可以进行实践学习了。遇到问题参考《使用JDB调试Java程序》，《Intellj IDEA 简易教程》进行调试。

我们每周的学习要通过在博客园发博客，码云也是博客写作，预览的好平台，同时也把博客的写作纳入了版本控制。

我们先运行mkdir docs,touch docs/java_homework_week1.md创建docs目录和空文件“java_homework_week1.md”。

我们通过git add ., git commit -m "init docs with empty java_homework_week1.md"把作业博客纳入版本控制。

我们通过git push把作业推送到码云上：

在码云上我们看到了docs文件夹：

点击docs文件夹，打开“java_homework_week1.md”，点击“编辑”就可以写作业了：

为了规范作业，我在2016-2017-2 《Java程序设计》教学进程中给出了作业模板的Markdown 内容，作业提交要严格按模板提交，我们先把模板拷贝过来，并进行提交：

提交说明是“拷贝作业模板”，这等价于 git commit -m "拷贝作业模板", 点击“提交到master”按钮。

要养成写一段完整文档提交一次的习惯。

作业模板包含以下要素，不要遗漏:

教材学习内容总结
教材学习中的问题和解决过程
代码调试中的问题和解决过程
代码托管
上周考试错题总结
其他（感悟、思考等，可选）
学习进度条
参考资料

我们给几个简单的例子，点击“编辑”：

首先把标题中的“学号”改成自己的学号，方便老师识别作者，然后把“第X周”改成“第一周”

要注意模板中“教材学习内容总结”，以前不少同学写作业在此浪费了大量时间，写总结要：

尽量简单的总结一下本周学习内容
尽量不要抄书，浪费时间
看懂就过，看不懂，学习有心得的记一下

这样才能体现差异化，当然你也可以预测老师会考什么，在此列出来备查，一定不能长篇大论，内容却千篇一律。
比如我们总结出了三个要点，在提交信息中写“完成学习要点”，然后点击“提交到master”按钮。

我们的学习模板参考了邹欣老师(博客,微博,豆瓣)设计的进度条，进度条用好对学习的促进作用非常大的，实践一年来效果不太好，主要各种原因造成学习数据乱填。

为此我设计了一节“代码托管”，要求学生有两个截图：

代码提交过程截图：运行 git log --pretty=format:"%h - %an, %cd : %s" 并截图
代码量截图：运行 find src -name "*.java" | xargs cat | grep -v ^$ | wc -l 并截图

后来我写了个脚本直接把这个过程自动化了：

#!/bin/sh
clear
echo "//==========Today====================================="
echo "code summary infomation:"
find . -name "*.java" -mtime 0 | xargs cat | grep -v ^$ | wc -l 
echo "documents summary infomation:"
find . -name "*.md" -mtime 0 | xargs cat | grep -v ^$ | wc -l 
echo ""

echo "//==========This Week================================="
echo "code summary infomation:"
find . -name "*.java" -mtime -7| xargs cat | grep -v ^$ | wc -l 
echo "documents summary infomation:"
find . -name "*.md" -mtime -7| xargs cat | grep -v ^$ | wc -l 
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-0 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-1 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-2 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-3 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-4 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-5 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-6 days"`
echo ""
echo ""

echo "//==========All================================="
echo "code summary infomation:"
find . -name "*.java"| xargs cat | grep -v ^$ | wc -l 
echo "documents summary infomation:"
find . -name "*.md"| xargs cat | grep -v ^$ | wc -l 
echo "commit history:"
git log --pretty=format:"%h - %an,%ci: %s "

在“代码托管”部分贴这个脚本的截图就可以了。可以看出自己每天，本周，这学期写了多少文档，多少代码。

“代码托管”的链接要改成自己的学习项目链接：