涉及的技术与工具:
这些技术,除了Ruby与Git较为熟悉,其他的我也仅知皮毛。但没关系,这些链接是给喜欢深入钻研技术的人研究之用,如果仅仅想拥有一个独立blog,可以略过。
为了应用更加普遍,以下操作在WIN7下进行(实际上推荐Unix和Linux环境)。
下面正式开始:
第一步:
首先,需要注册GitHub,注册完成后,GitHub提供了一套基本的git操作入门教程。请照着做一遍,截图很详细,讲解很清晰。
注意:如果git命令出现以下错误:
ssh: connect to host github.com port 22: Bad file number
fatal: The remote end hung up unexpectedly
说明你的22端口被占用或阻止,请在C:\Users\USERNAME\.ssh\
下新建一个config文件,在里面写入:
Host github.com
User username@email.com
Port 443
Hostname ssh.github.com
请把username@email.com
换成你的GitHub注册邮箱。
第二步:
若认真完成第一步之后,应该已经安装好了git与github的环境,甚至知道怎么上传源代码了呢 :)。那么第二步主要针对Ruby环境了,请点击下载rubyinstaller与DevKit。先安装rubyinstaller,各种下一步即可。然后解压DevKit(路径不能有中文)例如解压到F:\DevKit
下。然后进入Git Bash,输入(每输一行请回车,后文不再说明):
cd f:/DevKit
ruby dk.rb init
ruby dk.rb install
gem install rdiscount --platform=ruby
若安装成功,则Ruby环境搭建完成。
第三步:
重头戏来了,安装Octopress框架,还是以F:
下为例,进入Git Bash,输入:
cd f:
git clone git://github.com/imathis/octopress.git octopress
注意:若这一步下载失败(显示fatal: unable to connect to github.com
)
请换为以下命令:
git clone https://github.com/imathis/octopress.git octopress
继续,安装一些重要工具:
cd octopress
ruby --version # Should report Ruby 1.9.2
gem install bundler
bundle install
rake install
注意:上述安装如果出现fatal或error,请检查第二步中ruby的版本是否为1.9.2,如果是最新的1.9.3版本,可能会出现一些冲突。如果出现,请将bundle install
换成bundle update
。
第四步:
到此为止,在本地就可以看到blog的雏形了,我们简单写一篇blog试试,输入:
rake new_post["the first blog"]
在octopress/source/_post
目录下可以看到生成了一个这样形式的文件:2012-04-22-the-first-blog.markdown
。markdown格式是当下很流行的一种轻量级标记语言,请看这里的详细介绍。可用记事本打开生成的markdown文件,也可以尝试用dillinger工具来写一篇简单的博文。
好了,在本地预览一下效果吧:
rake generate
rake preview
成功之后,在浏览器中输入http://localhost:4000/
看看,是不是看见一个示例的blog了?
注意:上述过程中可能会出现GBK编码错误,请打开Ruby的安装路径,例如我安装在了F:盘下。寻找以下文件
F:\Ruby192\lib\ruby\gems\1.9.1\gems\jekyll-0.11.0\lib\jekyll\convertible.rb
将第29行的
self.content = File.read(File.join(base, name))
改为
self.content = File.read(File.join(base, name), :encoding => "utf-8")
第五步:
最后一步,要把本地文件部署到GitHub服务器上去。首先需要申请一个自己喜欢的二级域名:
- 登录GitHub,点击右上角的
Create a New Repo
。 - 在
Repository name
中写下yourname.github.com,其中yourname你起。 - 点击
Create repository
,创建完成。
打开Git Bash,进入octopress路径下:
rake setup_github_pages
然后填入git@github.com:pezy/pezy.github.com.git
,这句话来自下图所示:
注意:如果此步出现警告,请参考这个解决方法;然后敲入发布命令:
rake deploy
最后别忘了提交源代码:
git add .
git commit -a -m 'comment'
git push origin source
好了,等上一杯咖啡的时间,再打开yourname.github.com看看,是否已经成功了呢?
五步之后:
这仅仅是一个开端,后续的一切需要自己摸索,但是就算是这样默认的主题,已经很不错了。再做几个提示吧:
- 修改主页基本信息 - 请打开
octopress\_config.yml
,可以在里面进行配置。切忌,每项信息前有一个空格。 - 做一些基本的修饰 - 请参考官方文档。
- 每次提交新文章的步骤 - 在本地预览请重复第四步,修改满意了,请重复第五步(从发布命令开始)即可。
- 侧边栏的新浪微博咋加 - 参考这里。
- 博客文章的分享咋弄的 - 参考这里,在最后那部分。
- 那个评论是怎么加上的 - 参考这里。
- 我想让博客脱胎换骨! - 参考这里。
好了,更多的新奇让咱们共同去探索吧!如有疑问,请留言!
Free Blog, Just Enjoying!
额外的探索:
关于如何嵌入代码,可以看一楼的评论。
另外标签云的做法参考了一个日本人的博客,方法很简单,看代码就能看懂。可在这里直接下载代码。
参考资料:
[1] 思考的轨迹
[2] 程序猎人的博客
[3] Sinosmond’s Blog
[4] Blog of GangMax
[5] Octopress help
[6] T.I.D.
转自:http://pezy.me/blog/2012/04/22/5-step-to-blog/