Skip to content

Commit 709d8d1

Browse files
phodalphodal
committed
change Github to GitHub
1 parent d9e5ec8 commit 709d8d1

19 files changed

+2591
-2845
lines changed

‎Makefile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
include_dir=build
22
source=chapters/*.md
3-
title='Github 漫游指南'
3+
title='GitHub 漫游指南'
44
filename='github-roam'
55

66

‎README.md

Lines changed: 4 additions & 2689 deletions
Large diffs are not rendered by default.

‎build/author.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<p>
2-
<h1>Github 漫游指南</h1>
3-
<p>项目首页: <a href="https://github.com/phodal/github-roam">Github 漫游指南</a></p>
4-
<p>By <a href="https://www.phodal.com">Phodal Huang</a>(微博、知乎、Github、SegmentFault: @<a href="http://weibo.com/phodal">phodal</a>)
2+
<h1>GitHub 漫游指南</h1>
3+
<p>项目首页: <a href="https://github.com/phodal/github-roam">GitHub 漫游指南</a></p>
4+
<p>By <a href="https://www.phodal.com">Phodal Huang</a>(微博、知乎、GitHub、SegmentFault: @<a href="http://weibo.com/phodal">phodal</a>)
55
</p>
66
<p>微信公众号</p>
77
<img src="./img/qrcode.jpg" alt=""/>

‎build/metadata.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<dc:title>Github 漫游指南</dc:title>
1+
<dc:title>GitHub 漫游指南</dc:title>
22
<dc:creator>Phodal Huang</dc:creator>
33
<dc:rights>Creative Commons Attribution Non-Commercial Share Alike 3.0</dc:rights>
44
<dc:language>zh-CN</dc:language>

‎build/title.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
1-
% Github 漫游指南
1+
% GitHub 漫游指南
22
% Phodal Huang

‎chapters/01-prelude.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,28 @@
11
#前言
22

3-
我的Github主页上写着加入的时间——``Joined on Nov 8, 2010``，那时才大一，在那之后的那长日子里我都没有过到。也许是因为我学的不是计算机，到了今天——``2015.3.9``，我也发现这其实是程序员的社交网站。
3+
我的GitHub主页上写着加入的时间——``Joined on Nov 8, 2010``，那时才大一，在那之后的那长日子里我都没有过到。也许是因为我学的不是计算机，到了今天——``2015.3.9``，我也发现这其实是程序员的社交网站。
44

5-
过去，曾经有很长的一些时间我试过在Github上连击，也试着去了解别人是如何用好这个工具的。当然粉丝在Github上也是很重要的。
5+
过去，曾经有很长的一些时间我试过在GitHub上连击，也试着去了解别人是如何用好这个工具的。当然粉丝在GitHub上也是很重要的。
66

7-
在这里，我会试着将我在Github上学到的东西一一分享出来。
7+
在这里，我会试着将我在GitHub上学到的东西一一分享出来。
88

9-
##我与Github的故事
9+
##我与GitHub的故事
1010

1111
在我大四找工作的时候，试图去寻找一份硬件、物联网相关的工作(ps: 专业是电子信息工程)。尽管简历上写得满满的各种经历、经验，然而并没有卵用。跑了几场校园招聘会后，十份简历(ps: 事先已经有心里准备)一个也没有投出去——因为学校直接被拒。我对霸面什么的一点兴趣都没有，千里马需要伯乐。后来，我加入了Martin Flower所在的公司，当然这是后话了。
1212

13-
这是一个残酷的世界，在学生时代，如果你长得不帅不高的话，那么多数的附加技能都是白搭(ps: 通常富的是看不到这篇文章的)。在工作时期，如果你上家没有名气，那么将会影响你下一份工作的待遇。而，很多东西却会改变这些，Github就是其中一个。
13+
这是一个残酷的世界，在学生时代，如果你长得不帅不高的话，那么多数的附加技能都是白搭(ps: 通常富的是看不到这篇文章的)。在工作时期，如果你上家没有名气，那么将会影响你下一份工作的待遇。而，很多东西却会改变这些，GitHub就是其中一个。
1414

15-
注册Github的时候大概是大一的时候，我熟悉的时候已经是大四了，现在已经毕业一年了。在过去的近两年里，我试着以几个维度在Github上创建项目:
15+
注册GitHub的时候大概是大一的时候，我熟悉的时候已经是大四了，现在已经毕业一年了。在过去的近两年里，我试着以几个维度在GitHub上创建项目:
1616

1717
1. 快速上手框架来实战，即demo
1818
2. 重构别人的代码
1919
3. 创建自己可用的框架
2020
4. 快速构建大型应用
2121
5. 构建通用的框架
2222

23-
###Github与收获
23+
###GitHub与收获
2424

25-
先说说**与技能无关的收获**吧，毕业设计做的是一个《[最小物联网系统](https://github.com/phodal/iot)》，考虑到我们专业老师没有这方面知识，答辩时会带来问题，尽量往这方面靠拢。当我毕业后，这个项目已经有过百个star了，这样易上手的东西还是比较受欢迎的(ps: 不过这种硬件相关的项目通常受限于Github上硬件开发工程师比较少的困扰)。
25+
先说说**与技能无关的收获**吧，毕业设计做的是一个《[最小物联网系统](https://github.com/phodal/iot)》，考虑到我们专业老师没有这方面知识，答辩时会带来问题，尽量往这方面靠拢。当我毕业后，这个项目已经有过百个star了，这样易上手的东西还是比较受欢迎的(ps: 不过这种硬件相关的项目通常受限于GitHub上硬件开发工程师比较少的困扰)。
2626

2727
毕业后一个月收到PACKT出版社的邮件(ps: 他们是在github上找到我的)，内容是关于Review一本[物联网](iot)书籍，即在《[从Review到翻译IT书籍](http://www.phodal.com/blog/review-it-books-with-translate-book/)》中提到的《Learning Internet of Things》。作为一个四级没过的"物联网专家"，去审阅一本英文的物联网书籍。。。
2828

@@ -34,9 +34,9 @@
3434

3535
也因此带来了其他更多的东西，当然不是这里的主题。在这里，我们就不讨论各种骚扰邮件，或者中文合作。从没有想象过，我也可以在英语世界有一片小天地。
3636

37-
这些告诉我们，Github上找一个你擅长的主题，那么会有很多人找上你的。
37+
这些告诉我们，GitHub上找一个你擅长的主题，那么会有很多人找上你的。
3838

39-
###Github与成长
39+
###GitHub与成长
4040

4141
过去写过一篇《[如何通过github提升自己](http://www.phodal.com/blog/use-github-grow-self/)》的文章，现在只想说三点:
4242

@@ -54,13 +54,13 @@
5454

5555
然后就会相信: **那些没有写测试的项目都是在耍流氓**
5656

57-
##为什么你应该深入Github
57+
##为什么你应该深入GitHub
5858

5959
上面我们说的都是我们可以收获到的东西，我们开始尝试就意味着我们知道它可能给我们带来好处。上面已经提到很多可以提升自己的例子了，这里再说说其他的。
6060

6161
###方便工作
6262

63-
我们可以从中获取到不同的知识、内容、信息。每个人都可以从别人的代码中学习，当我们需要构建一个库的时候我们可以在上面寻找不同的库和代码来实现我们的功能。如当我在实现一个库的时候，我会在Github上到相应的组件:
63+
我们可以从中获取到不同的知识、内容、信息。每个人都可以从别人的代码中学习，当我们需要构建一个库的时候我们可以在上面寻找不同的库和代码来实现我们的功能。如当我在实现一个库的时候，我会在GitHub上到相应的组件:
6464

6565
- Promise 支持
6666
- Class类(ps:没有一个好的类使用的方式)
@@ -70,9 +70,9 @@
7070

7171
###获得一份工作
7272

73-
越来越多的人因为Github获得工作，因为他们的做的东西正好符合一些公司的要求。那么，这些公司在寻找代码的时候，就会试着邀请他们。
73+
越来越多的人因为GitHub获得工作，因为他们的做的东西正好符合一些公司的要求。那么，这些公司在寻找代码的时候，就会试着邀请他们。
7474

75-
因而，在Github寻找合适的候选人，已经是一种趋势。
75+
因而，在GitHub寻找合适的候选人，已经是一种趋势。
7676

7777
###扩大交际
7878

‎chapters/02-github-fundamentals.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
#Git基本知识与Github使用
1+
#Git基本知识与GitHub使用
22

33
##Git
44

@@ -65,7 +65,7 @@ $git status
6565
可以看到状态的变化是从黄色到绿色，即unstage到add。
6666
6767
68-
##Github
68+
##GitHub
6969
7070
Wiki百科上是这么说的
7171
@@ -101,21 +101,21 @@ jQuery[^jQuery]在发布版本``2.1.3``，一共有152个commit。我们可以
101101
- Build: Update commitplease dev dependency
102102
- ...
103103
104-
###Github与Git
104+
###GitHub与Git
105105
106106
> Git是一个分布式的版本控制系统，最初由Linus Torvalds编写，用作Linux内核代码的管理。在推出后，Git在其它项目中也取得了很大成功，尤其是在Ruby社区中。目前，包括Rubinius、Merb和Bitcoin在内的很多知名项目都使用了Git。Git同样可以被诸如Capistrano和Vlad the Deployer这样的部署工具所使用。
107107
108108
> GitHub可以托管各种git库，并提供一个web界面，但与其它像 SourceForge或Google Code这样的服务不同，GitHub的独特卖点在于从另外一个项目进行分支的简易性。为一个项目贡献代码非常简单：首先点击项目站点的“fork”的按钮，然后将代码检出并将修改加入到刚才分出的代码库中，最后通过内建的“pull request”机制向项目负责人申请代码合并。已经有人将GitHub称为代码玩家的MySpace。
109109
110-
###在Github创建项目
110+
###在GitHub创建项目
111111
112112
接着,我们试试在上面创建一个项目:
113113
114-
![Github Roam](./img/github-roam-create.jpg)
114+
![GitHub Roam](./img/github-roam-create.jpg)
115115
116116
就会有下面的提醒:
117117
118-
![Github Roam](./img/project-init.jpg)
118+
![GitHub Roam](./img/project-init.jpg)
119119
120120
它提供多种方式的创建方法:
121121
@@ -139,9 +139,9 @@ git push -u origin master
139139
140140
如果你完成了上面的步骤之后,那么我想你想知道你需要怎样的项目。
141141
142-
##Github流行项目分析
142+
##GitHub流行项目分析
143143
144-
之前曾经分析过一些Github的用户行为，现在我们先来说说Github上的Star吧。(截止: 2015年3月9日23时。)
144+
之前曾经分析过一些GitHub的用户行为，现在我们先来说说GitHub上的Star吧。(截止: 2015年3月9日23时。)
145145
146146
用户 | 项目名 | Language | Star | Url
147147
-----|---------- |----------|------|----

‎chapters/03-build-github-project.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
#构建Github项目
1+
#构建GitHub项目
22

3-
##如何用好Github
3+
##如何用好GitHub
44

5-
如何用好Github,并实践一些敏捷软件开发是一个很有意思的事情.我们可以在上面做很多事情,从测试到CI,再到自动部署.
5+
如何用好GitHub,并实践一些敏捷软件开发是一个很有意思的事情.我们可以在上面做很多事情,从测试到CI,再到自动部署.
66

77
###敏捷软件开发
88

‎chapters/04-create-project-documents.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,13 @@
99

1010
通常这个会在项目的最上方会有一个项目的简介，如下图所示：
1111

12-
![Github Project Introduction](./img/github-intro.png)
12+
![GitHub Project Introduction](./img/github-intro.png)
1313

1414
##README
1515

16-
README通常会显示在Github项目的下面，如下图所示：
16+
README通常会显示在GitHub项目的下面，如下图所示：
1717

18-
![Github README](./img/readme-example.png)
18+
![GitHub README](./img/readme-example.png)
1919

2020
通常一个好的README会让你立马对项目产生兴趣。
2121

‎chapters/06-refactor-project.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
或许你应该知道了，重构是怎样的，你也知道重构能带来什么。在我刚开始学重构和设计模式的时候，我需要去找一些好的示例，以便于我更好的学习。有时候不得不创造一些更好的场景，来实现这些功能。
44

5-
有一天，我发现当我需要我一次又一次地重复讲述某些内容，于是我就计划着把这些应该掌握的技能放到Github上，也就有了[Artisan Stack](https://github.com/artisanstack) 计划。
5+
有一天，我发现当我需要我一次又一次地重复讲述某些内容，于是我就计划着把这些应该掌握的技能放到GitHub上，也就有了[Artisan Stack](https://github.com/artisanstack) 计划。
66

77
每个程序员都不可避免地是一个Coder，一个没有掌握好技能的Coder，算不上是手工艺人，但是是手工人。
88

‎chapters/07-find-github-project.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
#如何在Github"寻找灵感(fork)"
1+
#如何在GitHub"寻找灵感(fork)"
22

33
> 重造轮子是重新创造一个已有的或是已被其他人优化的基本方法。
44
@@ -55,7 +55,7 @@
5555

5656
####寻找
5757

58-
在Github上搜索了一个看到了下面的几个结果:
58+
在GitHub上搜索了一个看到了下面的几个结果:
5959

6060
- [https://github.com/then/promise](https://github.com/then/promise)
6161
- [https://github.com/reactphp/promise](https://github.com/reactphp/promise)

‎chapters/08-analytics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
#Github用户分析
1+
#GitHub用户分析
22

33
##生成图表
44

‎chapters/09-streak-your-github.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
#Github连击
1+
#GitHub连击
22

33
##100天
44

5-
我也是蛮拼的，虽然我想的只是在Github上连击100~200天，然而到了今天也算不错。
5+
我也是蛮拼的，虽然我想的只是在GitHub上连击100~200天，然而到了今天也算不错。
66

77
![Longest Streak](./img/longest-streak.png)
88

@@ -81,9 +81,9 @@
8181

8282
##200天的Showcase
8383

84-
今天是我连续泡在Github上的第200天，也是蛮高兴的，终于到达了:
84+
今天是我连续泡在GitHub上的第200天，也是蛮高兴的，终于到达了:
8585

86-
![Github 200 days](./img/github-200-days.png)
86+
![GitHub 200 days](./img/github-200-days.png)
8787

8888
故事的背影是: 去年国庆完后要去印度接受毕业生培训——就是那个神奇的国度。但是在去之前已经在项目待了九个多月，项目上的挑战越来越少，在印度的时间又算是比较多。便给自己设定了一个长期的goal，即100~200天的longest streak。
8989

@@ -223,11 +223,11 @@
223223

224224
给你一年的时间，你会怎样去提高你的水平？？？
225225

226-
![Github 365](./img/github-365.jpg)
226+
![GitHub 365](./img/github-365.jpg)
227227

228-
正值这难得的sick leave（万恶的空气），码文一篇来记念一个过去的366天里。尽管想的是在今年里写一个可持续的开源框架，但是到底这依赖于一个好的idea。在我的[Github 孵化器](http://github.com/phodal/ideas) 页面上似乎也没有一个特别让我满意的想法，虽然上面有各种不样有意思的ideas。多数都是在过去的一年是完成的，然而有一些也是还没有做到的。
228+
正值这难得的sick leave（万恶的空气），码文一篇来记念一个过去的366天里。尽管想的是在今年里写一个可持续的开源框架，但是到底这依赖于一个好的idea。在我的[GitHub 孵化器](http://github.com/phodal/ideas) 页面上似乎也没有一个特别让我满意的想法，虽然上面有各种不样有意思的ideas。多数都是在过去的一年是完成的，然而有一些也是还没有做到的。
229229

230-
尽管一直在Github上连击看上去似乎是没有多大必要的，但是人总得有点追求。如果正是漫无目的，却又想着提高技术的同时，为什么不去试试？毕竟技术非常好、不需要太多练习的人只是少数，似乎这样的人是不存在的。大多数的人都是经过练习之后，才会达到别人口中的“技术好”。
230+
尽管一直在GitHub上连击看上去似乎是没有多大必要的，但是人总得有点追求。如果正是漫无目的，却又想着提高技术的同时，为什么不去试试？毕竟技术非常好、不需要太多练习的人只是少数，似乎这样的人是不存在的。大多数的人都是经过练习之后，才会达到别人口中的“技术好”。
231231

232232
这让我想起了充斥着各种气味的知乎上的一些问题，在一些智商被完虐的话题里，无一不是因为那些人学得比别人早——哪来的天才？所谓的天才，应该是未来的智能生命一般，一出生什么都知道。如果并非如此，那只是说明他练习到位了。
233233

@@ -241,7 +241,7 @@
241241

242242
虽说算法很重要，但是编码才是基础能力。算法与编程在某种程度上是不同的领域，算法编程是在编程上面的一级。算法写得再好，如果别人很难直接拿来复用，在别人眼里就是shit。想出能work的代码一件简单的事，学会对其重构，使之变得更易读就是一件有意义的事。
243243

244-
于是，在某一时刻在Github上创建了一个组织，叫[Artisan Stack](https://github.com/artisanstack)。当时想的是在Github寻找一些JavaScript项目，对其代码进行重构。但是到底是影响力不够哈，参与的人数比较少。
244+
于是，在某一时刻在GitHub上创建了一个组织，叫[Artisan Stack](https://github.com/artisanstack)。当时想的是在GitHub寻找一些JavaScript项目，对其代码进行重构。但是到底是影响力不够哈，参与的人数比较少。
245245

246246
####重构
247247

@@ -261,7 +261,7 @@
261261

262262
从测试开始的TDD，会保证方法是可测的。从功能到测试则可以提供工作次效率，但是只会让测试成为测试，而不是代码的一部分。
263263

264-
测试是代码的最后一公里。所以，尽可能的为你的Github上的项目添加测试。
264+
测试是代码的最后一公里。所以，尽可能的为你的GitHub上的项目添加测试。
265265

266266
####编码的过程
267267

@@ -274,7 +274,7 @@
274274

275275
放到当前的场景就是：
276276

277-
1. 我想在Github上连击365天。对应于每一个时候段的目标都应该是可以衡量、测试的——即每天都会有Contributions。
277+
1. 我想在GitHub上连击365天。对应于每一个时候段的目标都应该是可以衡量、测试的——即每天都会有Contributions。
278278
2. 分解就是一个痛苦的过程。理想情况下，我们应该会有每天提交，但是这取决于你的repo的数量，如果没有新的idea出现，那么这个就变成为了Contributions而Commit。
279279
3. 一步步实现
280280

@@ -288,7 +288,7 @@
288288

289289
**创造是一种知识的再掌握过程。**
290290

291-
回顾一下写echoesworks的过程，一开始我需要的是一个网页版的PPT，当然这类的东西已经有很多了，如impress.js、bespoke.js等等。分析一下所需要的功能：markdown解析器、键盘事件处理、Ajax、进度条显示、图片处理、Slide。我们可以在Github上找到各式各样的模块，我们所要做的就是将之结合在一样。在那之前，我试着用类似的原理写（组合）了[Lettuce](https://github.com/phodal/lettuce)。
291+
回顾一下写echoesworks的过程，一开始我需要的是一个网页版的PPT，当然这类的东西已经有很多了，如impress.js、bespoke.js等等。分析一下所需要的功能：markdown解析器、键盘事件处理、Ajax、进度条显示、图片处理、Slide。我们可以在GitHub上找到各式各样的模块，我们所要做的就是将之结合在一样。在那之前，我试着用类似的原理写（组合）了[Lettuce](https://github.com/phodal/lettuce)。
292292

293293
组合相比于创造过程是一个更有挑战性的过程，我们需要在这过程去设计胶水来粘合这些代码，并在最终可以让他工作。这好比是我们在平时接触到的任务划分，每个人负责相应的模块，最后整合。
294294

@@ -312,7 +312,7 @@
312312

313313
###其他
314314

315-
是时候写这个小结了。从不会写代码，到写代码是从0到1的过程，但是要从1到60都不是一件容易的事。无论是刷Github也好(不要是自动提交)，或者是换工作也好，我们都在不断地练习。
315+
是时候写这个小结了。从不会写代码，到写代码是从0到1的过程，但是要从1到60都不是一件容易的事。无论是刷GitHub也好(不要是自动提交)，或者是换工作也好，我们都在不断地练习。
316316

317317
而练习是要分成不同的几个步骤，不仅仅局限于技术：
318318

‎github-roam.epub

29 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)