安装和设置Git
下载Git for
Windows,采用默认安装,安装完成后就可以在本地使用Git了。
但要将内容放到Github上,必须先在Github网站上注册个账户,然后在本机使用Git创建SSH Key。操作如下:
在Git Bash上输入命令:
ssh-keygen -C "[email protected]" -t rsa
Note: “[email protected]”需要更换成你在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 [email protected]”测试能够正常连接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项目网址,比如:
[email protected]: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
大功告成!
不同的操作系统安装方法是不一样的,建议学Ruby用Linux,有条件的话也可以用MAC,用windows。会遇到很多问题:windows:到https://www.ruby-lang.org/下载安装包,安装好,不要忘记改环境变更量。
https://rubygems.org/pages/download 下载rubygems安装包,解压cd 到子文件夹下setup.rb
http://www.runoob.com/ruby/ruby-tutorial.html
上面的链接里讲的很详细,你可以按照这个SOP来安装,Linux和windows的都有。
不懂的可以问我,我都安装过。
对于新入门的开发者,如何安装Ruby和Ruby
Gems
的运行环境可能会是个问题,本页主要介绍如何用一条靠谱的路子快速安装
Ruby
开发环境。
此安装方法同样适用于产品环境!
系统需求
首先确定操作系统环境,不建议在
Windows
上面搞,所以你需要用:
Mac
OS
X
任意
Linux
发行版本(Ubuntu,CentOS,
Redhat,
ArchLinux
...)
强烈新手使用
Ubuntu
省掉不必要的麻烦!
以下代码区域,带有
$
打头的表示需要在控制台(终端)下面执行(不包括
$
符号)
步骤0
-
安装系统需要的包
#
For
Mac
#
先安装
[Xcode]开发工具,它将帮你安装好
Unix
环境需要的开发包
步骤1
-
安装
RVM
RVM
是干什么的这里就不解释了,后面你将会慢慢搞明白。
$
curl
-L
期间可能会问你sudo管理员密码,以及自动通过homebrew安装依赖包,等待一段时间后就可以成功安装好
RVM。
然后,载入
RVM
环境(新开
Termal
就不用这么做了,会自动重新载入的)
$
source
~/.rvm/scripts/rvm
检查一下是否安装正确
$
rvm
-v
rvm
1.22.17
(stable)
by
Wayne
E.
Seguin
Michal
Papis
步骤2
-
用
RVM
安装
Ruby
环境
$
rvm
install
2.0.0
同样继续等待漫长的下载,编译过程,完成以后,Ruby,
Ruby
Gems
就安装好了。
步骤3
-
设置
Ruby
版本
RVM
装好以后,需要执行下面的命令将指定版本的
Ruby
设置为系统默认版本
$
rvm
2.0.0
--default
同样,也可以用其他版本号,前提是你有用
rvm
install
安装过那个版本
这个时候你可以测试是否正确
$
ruby
-v
ruby
2.0.0p247
(2013-06-27
revision
41674)
[x86_64-darwin13.0.0]
$
gem
-v
2.1.6
这有可能是因为Ruby的默认源使用的是cocoapods.org,国内访问这个网址有时候会有问题,网上的一种解决方案是将远替换成淘宝的,替换方式如下:
$gem
source
-
要想验证是否替换成功了,可以执行:
$
gem
sources
-l
正常的输出结果:
CURRENT
SOURCES
到这里就已经把Ruby环境成功的安装到了Mac
OS
X上,接下来就可以进行相应的开发使用了。