git+github+markdown+jekyll blog系列（二）

2015-04-09

作者：tomfans
本文地址：http://f-olivia.github.io/ruby/2015/04/09/jekyll/
转载请注明出处

#####三、准备工作

（一）工具介绍：git、github、jekyll、markdown

git：是一个开源的分布式版本控制系统，非常高效的项目版本管理工具。
GitHub：是一个基于Git的非常流行的开源项目托管库。利用GitHub，可以让全球各地的程序员们一起协作开发。GitHub提供了一种功能，叫GitHub Pages，利用这个功能，我们可以为项目建立网站，当然，这也意味着我们可以通过GitHub Pages 建立自己的网站。
Jekyll：是一个简单的，针对博客设计的静态网站生成器。使用GitHub和Jekyll，我们可以打造自己的独立博客，你可以自由地定制网站的风格，且是免费的。
markdown：是一种适用于网络的书写语言。严格的说它就是一种标记语言。

（二）环境配置：我的工作环境是win7系统，因此遵从简单原则，我选择 RailsInstaller来搭建ruby环境（包含Ruby、Rails、Bundler、Git、Sqlite、TinyTDS、SQL Server support和DevKit。），然后来配置git和github；进而安装jekyll。

安装ruby，上面已经说过了，推介用RailsInstaller（我下载的是railsinstaller-3.1.0.exe），具体步骤：（请参考）

1）、注册git用户，请登录 github，如图1： Alt text

2）、安装步骤就不在这里说了，一路next下去。

3）、安装完会自动弹出git和shh的设置提示，哦，在做这个之前先要注册一个git用户，所以，就有了1）步骤

 ---
 # Rails Environment Configuration.

 Your git configuration is incomplete.
 user.name and user.email are required for properly using git and services such
 as GitHub (https://github.com/).
	
  Please enter your name, for example mine is: Wayne E. Seguin
 name > F-olivia
 Setting user.name to F-olivia
	
  Please enter your email address, for example mine is: wayneeseguin@gmail.com
 email > xxxx@163.com
 Setting user.email to xxxx@163.com
 DL is deprecated, please use Fiddle
	
 git:
     user.name:  F-olivia
     user.email: xxxx@163.com
     version:    git version 1.9.4.msysgit.2

 ruby:
     bin:        D:/RailsInstaller/Ruby2.0.0/bin/ruby.exe
     version:    ruby 2.1.5p273 (2014-11-13 revision 48405) [i386-mingw32]

 rails:
     bin:        D:/RailsInstaller/Ruby2.0.0/bin/rails.bat
     version:    Rails 4.1.8

4）、填写github注册时的用户名和邮箱，就完成了公钥和密钥的生成，在C:\Documents and Settings\用户名下(C:\Users\xieax.ssh)，有个隐藏目录名为.ssh，id_rsa.pub文件就是公钥，id_rsa就是密钥。

 ---
 ssh:
 public_key_location: C:\Users\xieax/.ssh/id_rsa.pub
 public_key_contents: ssh-rsa AAAAB3NzaC1yc2E........
 .............lGB3Nz F-olivia <xxxx@163.com>


 NOTES:
  		
 Your public ssh key (id_rsa.pub) has been automatically generated and copied to your clipboard.

5）、ssh密钥与github账户做关联，把4）步骤中文件id_rsa.pub复制，然后登录github找到“Account Settings” > Click “SSH Keys” > Click “Add SSH key”，把密钥串粘贴，如图1： Alt text

6）、验证git连接，在开始菜单里找到RailsInstaller –> Git Bash，执行它，就打开了下面的命令窗口，以后的操作都是在这个窗口下进行的；输入命令：ssh -T git@github.com

 ---
 $ ssh -T git@github.com
 1.The authenticity of host 'github.com (207.97.227.239)' can't be established.
 2.RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
 3.Are you sure you want to continue connecting (yes/no)?

选择yes

 Hi F-olivia! You've successfully authenticated, but GitHub does not provide shell access.

后续设置账户信息，看个人意愿了，我没有做这一步

 ---
 1. git config --global user.name "你的名字"
 2. git config --global user.email "your_email@youremail.com"

好了，git与github连接成功了，革命的道路走了一半了，继续加油！

安装jekyll，这个比较繁琐，要安装一堆包（directory_watcher、liquid、open4、maruku和classifier，由于jekyll默认包是maruku来解析markdown，这里用kramdown），具体如下：

科普一下，Ruby是一种脚本语言，Gem是基于Ruby的一些开发工具包，Rails也算是一组Gem，专门用来做网站的。而目前最好gem包是淘宝的。

1）、查看gem包，命令：gem soruces -l

 ---
 C:\Sites>gem soruces -l
 ERROR:  While executing gem ... (Gem::CommandLineError)
 		Unknown command soruces

2）、更换成淘宝包

 ---	
 C:\Sites>gem sources -a http://ruby.taobao.org/
 http://ruby.taobao.org/ added to sources
	
 C:\Sites>gem sources -l
 *** CURRENT SOURCES ***
	
 http://ruby.taobao.org/

3）、安装jekyll，命令：gem install jekyll

 ---
 C:\Sites>gem install jekyll
 Fetching: liquid-2.6.1.gem (100%)
 Successfully installed liquid-2.6.1
 Fetching: kramdown-1.5.0.gem (100%)
 Successfully installed kramdown-1.5.0
 ......
 Installing ri documentation for yajl-ruby-1.1.0-x86-mingw32
 Done installing documentation for blankslate, celluloid, classifier-reborn, colorator, fast-stemmer, ffi, hitimes, jekyll, jekyll-coffeescript, jekyll-gist, jekyll-paginate, jekyll-sass-converter, jekyll-watch, kramdown, liquid, listen, mercenary, parslet, posix-spawn, pygments.rb, rb-fsevent, rb-in
 otify, redcarpet, safe_yaml, timers, toml, yajl-ruby after 9 seconds
 27 gems installed

根据安装成功列表，可以和上面需要的包对照一下，如需安装的，用命令gem install 包名执行。

ok，

markdown安装，windows下只能用MarkdownPad，这个更简单了，百度一个，一路next下去。

好了，今天就到这里，明天继续，开始创建自己的blog。

ruby 4