通过网络几篇文章整理的大致全面的教程。
1.安装Octopress
确保安装了git
和ruby1.9.3
,通过brew
安装rbenv
然后用rbenv
安装ruby
。
安装brew
先卸载MacPorts
sudo prot -f uninstall installed
sudo rm -fr \
再安装brew
curl -L http://github.com/mxcl/homebrew/tarball/master | tar xz –strip 1 -C /usr/local
export PATH=/usr/local/bin:$PATH
安装成功后通过brew install
查看brew版本
安装ruby
brew install rbenv
brew install ruby-build
rbenv install 1.9.3-p0
rbenv rehash
最后安装Octopress
git clone git://github.com/imathis/octopress.git octopress
cd octopress
gem install bundler
rbenv rehash
bundle install
rake install
配置Octopress
编辑 config.yml
文件的url
,title
,subtitle
,author
。
最好把里面的twitter相关的信息全部删掉,否则由于GFW的原因,将会造成页面load很慢。同理,修改定制文件/source/_includes/custom/head.html 把google的自定义字体去掉。
安装支持新浪微博和Dribbble的Octopress的Greyshade主题
我现在用的就是greyshade主题 http://www.sgxiang.com
cd octopress
git clone git@github.com:allenhsu/greyshade.git .themes/greyshade
echo "\$greyshade: color;" >> sass/custom/_colors.scss //替换 color 为自定义的链接高亮颜色
rake "install[greyshade]"
在_config.yml中加入
weibo_user: xsxiang # 微博数字 ID 或域名 ID
dribbble_user:
weibo_share: true # 是否开启微博分享按钮
关于greyshade主题的头像问题,有两种途径可以设置头像
- 在_config.yml文件中设置一个email,然后到gravatar网站上添加该email并上传一张头像
- 将需要使用的图片放到/source/images下。然后把/source/_includes/header.html文件中的img替换成 《img alt=“Profile Picture” src=“/images/tx.png” style=“width:160px;”》
配置Disqus插件
Disqus是octopress内置的comments功能,编辑config.yml
文件可以打开该功能,找到以下内容修改
#Disqus comments
disqus_short_name:
disqus_show_comment_count: false
填入注册disqus账号的名称,并将false修改为true。【disqus要和自己的username.github.com关联上】
2.配置github相关
在本机创建ssh
cd ~/.ssh
ssh-keygen -t rsa -C 你注册github时的email
弹出Enter file in which to save the key (/Users/twer/.ssh/id_rsa):
直接按空格
弹出Enter passphrase (empty for no passphrase):
输入你github账号的密码。Enter same passphrase again:
再次输入你的密码。
打开~/.ssh下的id_rsa.pub文件复制里面的全部内容。
登陆github,选择Account Settings–>SSH Public Keys 添加ssh,把剪切板的内容复制到key输入框内直接保存。
测试shh:
ssh git@github.com
输出
PTY allocation request failed on channel 0
Hi username! You've successfully authenticated, but GitHub does not provide shell access.
Connection to github.com closed.
代表成功
建立一个仓库
登陆github创建一个仓库 ,仓库名称为username.github.com比如我的是sgxiang.github.com
3.部署博客到github
利用octopress的一个配置rake任务来自动配置上面创建的仓库:可以让我们方便的部署GitHub page。在终端输入如下命令:
rake setup_github_pages
弹出之后输入git@github.com:your_username/your_username.github.com.git
不要用提示的io,我的是git@github.com/sgxiang/sgxiang.github.com.git
输入以下命令部署博客
rake generate
rake deploy
如果无法push到仓库的master分支,尝试在项目目录的.git/config中添加
[branch "master"]
remote = origin
merge = refs/heads/master
博客的source需要单独提交,执行如下命令就可以将source提交到仓库的source分支下
git add .
git commit -m 'Initial source commit'
git push origin source
部署前可以在本地预览,输入rake preview
之后在浏览器输入http://localhost:4000/
来访问
4.写博客
通过命令
rake new_post["myTitle"]
文章生成在目录下的source/_posts
目录下。文章是markdown格式的。可以通过 Mou 软件来编辑保存。
关于markdown的格式可以参考这篇文章:http://wowubuntu.com/markdown/
写完后就可以部署更新文章到github上了
rake generate
git add .
git commit -am "Some comment here."
git push origin source
rake deploy
参考文章
- http://m.blog.csdn.net/blog/duck_genuine/7736037
- http://www.imallen.com/blog/2013/10/16/deploying-octopress-to-qiniu.html
- http://beyondvincent.com/blog/2013/08/03/108-creating-a-github-blog-using-octopress/
- http://blog.devtang.com/blog/2012/02/10/setup-blog-based-on-github/
- http://www.imallen.com/blog/2013/05/12/add-support-for-weibo-and-dribbble-to-greyshade.html
- http://xautjzd.github.io/blog/2013/07/18/add-navigator/
- http://xautjzd.github.io/blog/2013/07/18/congfig-disqus-plugin/
- http://gilguan.github.io/blog/2013/10/16/zai-macshang-shi-yong-octopressda-jian-githubbo-ke/