收集关于Github的一些资料

注册GitHub后你就会有0.3G的免费空间，不过只能创建公开项目，这也满足代码分享的目的，我最喜欢的倒是它的代码展示方式，可以直接浏览你的代码，代码是经过高亮、添加行号处理过的，十分漂亮，体验一流，比如这个Webpy托管的地方。而作为想要了解你代码的人，可以选择直接在线浏览自己感兴趣的，也可以直接下载压缩包，或者直接使用Git clone到本地。
因为GitHub是基于Git版本控制系统，所以你上传修改代码什么的，都需要使用Git工具。我这里主要是用来分享和展示代码，所以不想在版本控制方面做过多的阐述，下面就简单讲解一下怎么在GitHub上新建一个项目，还有把自己的代码传上去。下面的前提是你已经注册了GitHub和下载安装了Git——Git下载、Windows版本下载。
上传分享代码
1.在GitHub上建立项目
登录GitHub后，你可以在右边靠中那里找到一个按钮“New Repository”，点击过后，填入项目名称、说明和网址过后就可以创建了，然后会出现一个提示页面，记下类似git@github.com:XXX/XXX.git的地址，这个就是你这个项目的地址了。
2.配置Git以及上传代码
安装Git成功后，如果是Windows下，选择Git Bash，在命令行中完成一切，可能开始有点麻烦，不过就那几条命令行，用几次就记住啦。首先初始设置Git：
1 git config --global user.name "Your Real Name" 2 git config --global user.email you@email.address

然后开始进行最麻烦的一步了，你需要上传文件到GitHub的Git系统上，得需要一个SSH密匙来认证，下面就开始生成密钥和提交密钥。打开Git Bash,创建SSH key:
1 ssh-keygen -C 'your@email.address' -t rsa

然后要你输入SSH密匙的存放位置，可以不管，直接回车使用默认路径。再输入你想要的密码，SSH key就生成了。现在你需要将这个Key提交到GitHub，首先打开Key保存的位置，里面会有三个文件，找到id_rsa.pub，用文本编辑器打开，复制里面的全部字符。到GitHub，在右上方工具栏里找到Account Settings。在这个页面上有一个SSH Public Keys标签，选择Add another public key。Title可以随便填一个，Key就粘贴刚才的字符，提交。
完成这些工作后，就可以上传自己的代码了。找到自己要分享上传的代码文件夹，右击选择Git Bash，或者在Git Bash中进入这个文件夹。建立一个仓库：
1 git init

选择要添加进仓库的文件：
1 git add .

一般如果你想分享这个文件夹里的所有代码，就在 add后面加“.”，上面的例子就是这样，如果传指定的，只需要把“.”改为文件名即可，现在只是选择了要加入仓库的文件，下面才是添加进入仓库：
1 git commit -m 'Test'

-m后面跟一个参数，表示说明，将代码提交到GitHub后，将会在代码文件信息上显示这个说明，如下图标记的地方。
搞了这么久，现在才开始把本地仓库上传到GitHub了，下面两行命令搞定问题：
1 2 git remote add origin git@github.com:XXX/XXX.git 3 git push -u origin master

这个git@github.com:XXX/XXX.git就是上面创建项目是生成的地址。现在打开你的项目网址，你就可以发现你的代码已经展示出来了。如果你要更新代码的话，就重复上面的吧。
如果提交了敏感信息，比如代码中设置的自己的密码什么的忘删除就上传上去了怎么办？重新修改过后上传依然有历史记录，而使用Git删除历史记录貌似很麻烦，于是就采用删除项目吧，删除了再重新上传。删除项目需要在GitHub网站上右上方找到admin按钮，进去后右边最下面有个删除的按钮，这样就可以删除了。
一些可能遇到的问题解决：
如果输入$ git remote add origin git@github.com:djqiang（github帐号名）/gitdemo（项目名）.git
提示出错信息：fatal: remote origin already exists.
解决办法如下：
1、先输入$ git remote rm origin
2、再输入$ git remote add origin git@github.com:djqiang/gitdemo.git 就不会报错了！
3、如果输入$ git remote rm origin 还是报错的话，error: Could not remove config section ‘remote.origin’. 我们需要修改gitconfig文件的内容
4、找到你的github的安装路径，我的是C:\Users\ASUS\AppData\Local\GitHub\PortableGit_ca477551eeb4aea0e4ae9fcd3358bd96720bb5c8\etc
5、找到一个名为gitconfig的文件，打开它把里面的[remote "origin"]那一行删掉就好了！
如果输入$ ssh -T git@github.com
出现错误提示：Permission denied (publickey).因为新生成的key不能加入ssh就会导致连接不上github。
解决办法如下：
1、先输入$ ssh-agent，再输入$ ssh-add ~/.ssh/id_key，这样就可以了。
2、如果还是不行的话，输入ssh-add ~/.ssh/id_key 命令后出现报错Could not open a connection to your authentication agent.解决方法是key用Git Gui的ssh工具生成，这样生成的时候key就直接保存在ssh中了，不需要再ssh-add命令加入了，其它的user，token等配置都用命令行来做。
3、最好检查一下在你复制id_rsa.pub文件的内容时有没有产生多余的空格或空行，有些编辑器会帮你添加这些的。
如果输入$ git push origin master
提示出错信息：error:failed to push som refs to …….
解决办法如下：
1、先输入$ git pull origin master //先把远程服务器github上面的文件拉下来
2、再输入$ git push origin master
3、如果出现报错 fatal: Couldn’t find remote ref master或者fatal: ‘origin’ does not appear to be a git repository以及fatal: Could not read from remote repository.
4、则需要重新输入$ git remote add origingit@github.com:djqiang/gitdemo.git
使用git在本地创建一个项目的过程
$ makdir ~/hello-world    //创建一个项目hello-world
$ cd ~/hello-world       //打开这个项目
$ git init             //初始化
$ touch README
$ git add README        //更新README文件
$ git commit -m ‘first commit’     //提交更新，并注释信息“first commit”
$ git remote add origin git@github.com:defnngj/hello-world.git     //连接远程github项目
$ git push -u origin master     //将本地项目更新到github项目上去

————————————————————————————————————————————————————————————————————————————
本文在Windows7下测试成功。

安装和设置Git

下载Git for 
Windows，采用默认安装，安装完成后就可以在本地使用Git了。

但要将内容放到Github上，必须先在Github网站上注册个账户，然后在本机使用Git创建SSH Key。操作如下：

在Git Bash上输入命令:
ssh-keygen -C "username@email.com" -t rsa

Note: “username@email.com”需要更换成你在Github上注册的Email地址或者是Username

这样会在用户目录(C:\Users\用户名)下产生一个.ssh文件夹，里面为对应的SSH 
Keys，其中id_rsa.pub是Github需要的SSH公钥文件。

到c:\Users\用户名\.ssh\目录找到id_rsa.pub（可能位置不一定对，但是确认是以.pub结尾的文件），并用记事本打开复制全部内容。

Note：建议私钥公钥的名称最好写成"id_rsa"，这样连接Github的时候会找这个文件，如果文件名已定，之后改名也行。

在github网站选择“Account Settings”>>“SSH Public Keys”>>“Add another 
public key”，将刚才复制的内容粘贴到key文本框内。

这样就可以直接使用Git和GitHub了。

Note：建议在Git Bash中输入“ssh -v git@github.com”测试能够正常连接github

安装Ruby环境

下载RubyInstaller和DevKit。

因为Octopress需要的Ruby版本为1.9.2，所以选rubyinstaller-1.9.2-p290.exe，DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe。

先安装RubyInstaller，然后解压缩DevKit(路径中不能有中文)。

在“Start Command Prompt with Ruby”命令行中进入DevKit解压缩的目录，然后运行以下命令:
ruby dk.rb init
ruby dk.rb install
gem install rdiscount --platform=ruby

如果安装成功，就可以使用一些Ruby的工具了，也为后面搭建博客提供了基础环境。

安装Octopress

先通过Git从Github上克隆一份Octopress（在Git Bash上输入命令）
git clone git://github.com/imathis/octopress.git octopress

然后安装一些依赖的工具（后面都是在Start Command Prompt with Ruby中输入）

cd octopress
ruby --version # Should report Ruby 1.9.2
gem install bundler
bundle install 

安装Octopress默认的Theme

rake install

配置Octopress

将octopress的文件夹下的_config.yml的编码改成UTF-8：

保存（或另存为）时选择编码格式为UTF-8

修改_config.yml，批改url、title、subtitle、author等等。

到Ruby的安装目次\lib\ruby\gems\1.9.1\gems\jekyll-0.11.2\lib\jekyll\找到convertible.rb这个文件，批改self.content 
= File.read（File.join（base， name））为self.content = File.read（File.join（base， 
name）， :encoding => "utf-8"）。

写博文

最简单的方式：复制octopress\source\_posts下某个文件，例如2012-07-30-the-first-post.markdown，修改文件名和文件中的内容

或者，命令行中输入rake 
new_post["title"]，会创建一个新的Post，新文件在source/_post下，文件名如下面的格式:2012-07-31-title.markdown。该文件可以直接打开修改。

写文章时，可以使用Markdown和Octopress 
Plugins等工具对内容进行格式排版。

预览效果

在修改设置或者写完文章后，想看看具体效果，可以通过如下命令来完成:

rake generate
rake preview

将博客部署到Github上

在预览的效果符合自己的预期后，就可以通过如下命令将内容部署到Github上了。

如果是第一次部署，需要在Github上创建一个username.github.com的repository

在github网站选择“Create a New Repo”,如图

填写对应的内容即可

note：Repository 
name填写username.github.com，username一定要和github的username一致，建好的博客代表的是你这个github账户的主页即page

配置octopress与github的连接：

进入Octopress目录：

rake setup_github_pages

按照提示填入你的github项目网址，比如：

git@github.com:Username/yourname.github.com.git

note：可以按照上面的修改，也可以在github的项目页中找地址

分发到github上：

rake deploy

第一次运行时，会询问是否建立对github的授权，输入：yes。然后将站点更新的内容推送到github上。

补充一点：

最后的但并不是最重要的，我们需要将修改的日志同步到github上，因此下面的3个命令也是必须的。

git status

git add .

git commit -m 'your message'

git push origin source

大功告成！
——————————————————————————————————————————————————————————————————————

 
 

  
  
1 Git简介 
  
  
2 为什么使用Github Pages
  
  
3 创建Github Pages 
  
  
3.1 安装git工具. 
  
  
3.2 两种pages模式
  
  
3.3 创建步骤
  
  
3.4 常用命令
  
  
4 使用Jekyll搭建博客
  
  
4.1 什么是jekyll
  
  
4.2 jekyll本地环境搭建
  
  
4.3 jekyll目录结构
  
  
4.4 Jekyll-Bootstrap创建博客
  
  
4.5 Jekyll 写博过程
  
  
4.6 个性化博客
  
  
5 使用Markdown
  
  
5.1 简介
  
  
5.2 基本语法
  
  
5.3 Notepad++支持Markdown语法高亮

  
  
1 Git简介
  
  
Git是一个开源的分布式版本控制系统，用以有效、高速的处理从很小到非常大的项目版本管理。
  
  
GitHub可以托管各种git库的站点。
  
  
GitHub Pages免费的静态站点，三个特点：免费托管、自带主题、支持自制页面和Jekyll。
  
  
2 为什么使用Github Pages
  
  
1. 搭建简单而且免费；
  
  
2. 支持静态脚本；
  
  
3. 可以绑定你的域名；
  
  
4. DIY自由发挥，动手实践一些有意思的东西git,markdown,bootstrap,jekyll；
  
  
5. 理想写博环境，git+github+markdown+jekyll；
  
  
3 创建Github Pages
  
  
3.1 安装git工具
  
  
http://windows.github.com/
  
  
http://mac.github.com/
  
  
3.2 两种pages模式
  
  
1. User/Organization Pages 个人或公司站点
  
  
1) 使用自己的用户名，每个用户名下面只能建立一个；
  
  
2) 资源命名必须符合这样的规则username/username.github.com；
  
  
3) 主干上内容被用来构建和发布页面
  
  
2. Project Pages 项目站点
  
  
1) gh-pages分支用于构建和发布；
  
  
2) 如果user/org pages使用了独立域名，那么托管在账户下的所有project pages将使用相同的域名进行重定向，除非project pages使用了自己的独立域名；
  
  
3) 如果没有使用独立域名，project pages将通过子路径的形式提供服务username.github.com/projectname；
  
  
4) 自定义404页面只能在独立域名下使用，否则会使用User Pages 404；
  
  
5) 创建项目站点步骤：
  
  

   
   
$ git clone https://github.com/USERNAME/PROJECT.git PROJECT
   
   
$ git checkout --orphan gh-pages
   
   
$ git rm -rf .
   
   
$ git add .
   
   
$ git commit -a -m "First pages commit"
   
   
$ git push origin gh-pages
  
  
  
  
3. 可以通过User/Organization Pages建立主站，而通过Project Pages挂载二级应用页面。
  
  
3.3 创建步骤
  
  
第一步：创建个人站点
  
  

  
  
第二步：设置站点主题
  
  
进入资源-setting
  
  

  
  
 更新你的站点
  
  
  
  
  
 选择主题并发布
  
  

  
  
3.4 常用命令
  
  

   
   
$ git clone git@github.com:username/username.github.com.git //本地如果无远程代码，先做这步，不然就忽略
   
   
$ cd .ssh/username.github.com //定位到你blog的目录下
   
   
$ git pull origin master //先同步远程文件，后面的参数会自动连接你远程的文件
   
   
$ git status //查看本地自己修改了多少文件
   
   
$ git add . //添加远程不存在的git文件
   
   
$ git commit * -m "what I want told to someone"
   
   
$ git push origin master //更新到远程服务器上
  
  
  
  
4 使用Jekyll搭建博客
  
  
4.1 什么是jekyll
  
  
Jekyll是一种简单的、适用于博客的、静态网站生成引擎。它使用一个模板目录作为网站布局的基础框架，支持Markdown、Textile等标记语言的解析，提供了模板、变量、插件等功能，最终生成一个完整的静态Web站点。说白了就是，只要安装Jekyll的规范和结构，不用写html，就可以生成网站。[jekyll介绍][jekyll on github][jekyllbootstrap]。
  
  
Jekyll使用Liquid模板语言，{{page.title}}表示文章标题，{{content}}表示文章内容。我们可以用两种Liquid标记语言：输出标记（output markup）和标签标记 (tag markup)。输出标记会输出文本（如果被引用的变量存在），而标签标记不会。输出标记是用双花括号分隔，而标签标记是用花括号-百分号对分隔。[Liquid模板语言] [Liquid模板变量参考]。
  
  
jekyll与github的关系：GitHub Pages一个由 GitHub 提供的用于托管项目主页或博客的服务，jekyll是后台所运行的引擎。
  
  
4.2 jekyll本地环境搭建
  
  
1. 下载最新的RubyInstaller并安装(我下载的是rubyinstaller-1.9.3-p194.exe)，设置环境变量，path中配置C:\Ruby193\bin目录，然后在命令行终端下输入gem update --system来升级gem；
  
  
2. 下载最新的DevKit，DevKit是windows平台下编译和使用本地C/C++扩展包的工具。它就是用来模拟Linux平台下的make,gcc,sh来进行编译。但是这个方法目前仅支持通过RubyInstaller安装的Ruby，并双击运行解压到C:\DevKit。然后打开终端cmd，输入下列命令进行安装：
  
  

   
   
cd C:\DevKit
   
   
ruby dk.rb init
   
   
ruby dk.rb install
  
  
  
  
3. 完成上面的准备就可以安装Jekyll了,因为Jekyll是用Ruby编写的,最好的安装方式是通过RubyGems(gem):
  
  

   
   
gem install Jekyll
  
  
  
  
并使用命令检验是否安装成功
  
  

   
   
jekyll --version
  
  
  
  
4. 安装Rdiscount，这个用来解析Markdown标记的包，使用如下命令：
  
  

   
   
gem install rdiscount
  
  
  
  
5. 运行本地工程：
  
  
cd 到工程目录，启动服务：
  
  

   
   
jekyll --server
  
  
  
  
4.3 jekyll目录结构
  
  
 _posts： _posts中的数据文档，通过注入_layouts定义的模板，通过jekyll --server最终生成的静态页面在_sites目录。目录是用来存放你的文章的，一般以日期的形式书写标题。
 _layouts：_layouts中的模板一般指向了_includes/themes中的模板。目录是用来存放模板的，在这里你可以定义页面中不同的头部和底部。
 _includes：
  
  

   
   
1) _includes/JB中有一些常用的工具，用于列表显示、评论等；
   
   
2) _includes/themes中可参看主题的相关html文档。
   
   
3) _includes/themes中的主题一般包含default.html、post.html和page.html三个文档。default.html定义了网站的最上层框架（模板），post.html和page.html是其子框架（模板）。
   
   
4) 生成好的html子页面通过default.html的{{ content }}变量调用，生成整个页面。
  
  
  
  
 assets 渲染页面的CSS和JS文档在assets/themes中
 _config.yml 站点生成需要用到_config.yml配置文件，站点的全局变量在_config.yml中定义，用site.访问；页面的变量在YAML Front Matter中定义，用page.访问，更多的模板变量可参考模板数据。
 index.html是你的页面首页。
  
  
4.4 Jekyll-Bootstrap创建博客
  
  
1. 创建个人站点，即创建一个新资源，格式为username.github.com；
  
  
2. 安装Jekyll-Bootstrap：
  
  

   
   
$ git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.com
   
   
$ cd USERNAME.github.com
   
   
$ git remote set-url origin git@github.com:USERNAME/USERNAME.github.com.git
   
   
$ git push origin master
  
  
  
  
3. 访问创建好的个人站点：username.github.com
  
  
4. 在本地测试查看效果：
  
  

   
   
cd USERNAME.github.com
   
   
jekyll --server
  
  
  
  
4.5 Jekyll 写博过程
  
  
1、 配置_config.yml：
  
  
1) 修改标题：title : My Blog =)
  
  
2) 修改个人信息：
  
  

   
   
author :
   
   
name : Name Lastname
   
   
email : blah@email.test
   
   
github : username
   
   
twitter : username
   
   
feedburner : feedname
  
  
  
  
3) 引用：_config.yml中的键值均引用到其他页面{{ site.title }}；
  
  
2、 写文章
  
  
按照_config.yml的格式permalink: /:categories/:year/:month/:day/:title，可以修改格式，创建markdown格式文件，就可以当初博客发布了。
  
  
3、 发布
  
  
本地预览修改：运行jekyll –server，预览http:127.0.0.1:4000。
  
  
发布到github上：通过命令提交或者客户端提交。
  
  
4.6 个性化博客
  
  
Github Page完成了博客的主要功能，写作、发布、修改，这些都是相对静态的东西，就是你自己可以控制的事情，还有一些动态的东西Github Pages无法支持，比如说文章浏览次数、文章的评论等，还有一些个性化的东西，像个性化页头页尾、代码高亮可以把博客整的更漂亮一点，其实这写都可以通过第三方应用来实现，个性化自己的博客。
  
  
加上Disqus云评论:
  
  
注册http://disqus.com/
  
  

   
   
修改_config.yml:
   
   
comments :
   
   
provider : disqus
   
   
disqus :
   
   
short_name : tiansj
  
  
  
  
5 使用Markdown
  
  
5.1 简介
  
  
Markdown 的宗旨是实现「易读易写」。可读性，无论如何，都是最重要的。
  
  
Markdown 的语法全由一些符号所组成，这些符号经过精挑细选，其作用一目了然。格式撰写的文件可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。
  
  
资料：[搭建环境]
  
  
5.2 基本语法
  
  
 使用一个或多个空行分隔内容段来生成段落 <p>。
 标题（h1~h6）格式为使用相应个数的“#”作前缀，比如以下代码表示 h3：
  
  
### this is a level-3 header ###
  
  
 使用“>”作为段落前缀来标识引用文字段落。这其实是 email 中标记引用文字的标准方式：
  
  
> 引用的内容
  
  
> 这个记号直接借鉴的邮件标准
  
  
 使用“*”“+”“-”来表示无序列表；使用数字加“.”表示有序列表。如：
  
  
1. I am ordered list item 1...
  
  
2. So I should be item 2!?
  
  
 使用 4 个以上 空格或 1 个以上 的 tab 来标记代码段落，它们将被<pre> 和 <code> 包裹，这意味着代码段内的字体会是 monospace家族的，并且特殊符号不会被转义。
 使用 [test](http://example.net "optional title") 来标记普通链接。
 使用 ![img](http://example.net/img.png "optional title") 来标记图片。
  
  
引号内的 title 文字是可选的，链接也可以使用相对路径。
  
  
 使用 * 或 _ 包裹文本产生 strong 效果：
  
  
_语气很重的文本_ 以及 **语气更重的文本**
  
  
5.3 Notepad++支持Markdown语法高亮
  
  
1. 下载userDefineLang.xml
  
  
2. 将 userDefineLang.xml 放置到此目录：C:\Users\Administrator\AppData\Roaming\Notepad++
  
  
3. 重启 Notepad++，在语言菜单下可以看到自定义的 Markdown 高亮规则