tmyam's blog

time run off...

mac下使用github+Octopress搭建博客

我的第一篇博文
(mac 版本 10.8.5)

1.git配置

  • 申请github账号
  • 配置git环境

配置用户信息

1
2
git config --global user.email "xxx@xxx.com"
git config --global user.name "xxx"

可以使用 git config --list 查看配置的信息

生成证书

1
ssh-keygen -t rsa -C "xxx@xxx.com"

登录github
拷贝~/.ssh/id_rsa.pub的内容,在github的Account SettingsSSH Keys里,点Add SSH Keys,将内容粘贴到”Key”中,并输入”Title”.

2.安装ruby

使用Octopress需要最低Ruby版本为1.9.3,所以必须安装ruby。

  • 如果没有安装了XCode及Command Line Tools则需要先安装apple-gcc42。
  • 使用RVM安装ruby最新版本

安装rvm. 参考链接

1
\curl -L https://get.rvm.io | bash -s stable --ruby

由于国内被墙的缘故,可能遇见 curl: (7) couldn't connect to host 错误.可以使用下面的方式

1
\curl https://rawgithub.com/wayneeseguin/rvm/master/binscripts/rvm-installer | bash -s stable --ruby

查看网络上最新的ruby版本

1
rvm list known

安装ruby

1
rvm install ruby-2.0.0-p247

如果遇到以下错误

Error running ‘requirements_osx_port_libs_install autoconf automake libtool pkgconfig apple-gcc42 libiconv libyaml libffi readline libxml2 libxslt libksba openssl curl-ca-bundle sqlite3 zlib gdbm ncurses’, please read /Users/xxx/.rvm/log/1371125385_package_install_autoconf_automake_libtool_ pkgconfig_apple-gcc42_libiconv_libyaml_libffi_readline_libxml2_libxslt_libksba_openssl_curl-ca-bundle_sqlite3_zlib_gdbm_ncurses.log

可以尝试使用下面的语句解决. 参考链接

1
rvm autolibs brew

如果遇到以下错误

Error running ‘requirements_osx_brew_libs_install autoconf automake libtool pkg-config libyaml readline libksba openssl’, please read /Users/zrshz/.rvm/log/1381463190_ruby-2.0.0-p247/package_install_autoconf_automake_libtool_pkg-config_libyaml_readline_libksba_openssl.log

Requirements installation failed with status: 1.

可以先安装homebrew

1
2
sudo su
curl -L http://github.com/mxcl/homebrew/tarball/master | tar xz --strip 1 -C /usr/local

修改权限

1
sudo chown -R `whoami` /Library/Caches/Homebrew/

之后重新安装就行了。

使用

1
rvm use ruby-2.0.0-p247

可以使用 rvm list 查看安装的ruby的状态。

3.部署blog

  • 创建git的blog

    1. 点击github主页的 Tab Repositories,点击 New 按钮,创建一个public的仓库。
    2. 仓库的名称必须为 your_username.github.com ,其中your_username是需要修改的地方,然后点击 Create repository 按钮。
    3. 点击右侧的 ”Settings” 图标,在 “GitHub Pages” 栏,点击 Automatic Page Generator 按钮。
    4. 内容不需要填,直接点击 Continue to Layouts 按钮。
    5. 接着是选择模板,直接点击 PUBLISH 按钮即可。大约十分钟之后可以看到生成的静态页面,不过这个页面是没什么用的。

  • 配置Octopress

1
2
3
4
5
6
cd blog               # 想要安装的Octopress的文件夹
git clone https://github.com/imathis/octopress.git
cd octopress
gem install bundler   # 安装依赖
bundle install        
rake install          # 安装Octopress默认的主题
  • 部署
1
rake setup_github_pages

执行完后会要求输入仓库地址,照着写就行了git@github.com:your_username/your_username.github.com.git,其中your_username是需要修改的地方。

可以执行以下命令生成页面和预览博客

1
2
rake generate      # 生成文件(public文件夹下)
rake preview      # 生成本地预览,地址 http://localhost:4000
  • 上传到github
1
rake deploy        # 会先将public下的文件复制到_deploy下,然后将_deploy下的内容push到GitHub的master分支上

如果出现ERROR: Repository not found.错误,可以使用下面的方法解决。

1
2
3
4
rm -rf _deploy     # 在octopress目录下
git clone https://github.com/your_username/your_username.github.com.git "_deploy"       # 注意修改your_username
rake generate   # 再次执行
rake deploy       

这样就可以看到上传的主题博客了。

4.备份资源文件

在octopress目录下

1
2
3
git add .
git commit -m 'your message'
git push origin source

更新 Octopress

1
2
3
4
5
git remote add octopress git://github.com/imathis/octopress.git
git pull octopress master     # Get the latest Octopress
bundle install                # Keep gems updated
rake update_source            # update the template's source
rake update_style             # update the template's style


参考

http://firestudio.cn/blog/2013/01/05/ru-he-tong-guo-github-yu-octopress-lai-da-jian-zi-ji-de-bo-ke/

评论