Ubuntu上使用octopress+github建立个人博客

萝らか妹 提交于 2019-12-04 17:42:04

(转载本文时请表明原文链接:http://fzyz999.github.io/blog/2013/04/10/ubuntushang-shi-yong-octopressjian-li-bo-ke/,顺便欢迎有兴趣的朋友看看我的github博客:http://fzyz999.github.io)

关于本文

  初用octopress,感觉很适合我。不许要操心管理网站的问题,也不会受到广告等等的烦恼。关于octopress的中文资料不多,我就尝试尝试把octopress的文档整理翻译一下。本文并非是文档的正式翻译,只是单纯介绍一下Ubuntu上使用octopress+github建立个人博客的基本流程,部分内容为方便就直接翻译了原文。如果有误,欢迎指正。

  我的操作系统是Ubuntu 12.10,octopress版本是2.0

关于github

github是一个全球性的代码托管平台,支持github Pages服务。这个服务可以为个人、组织或项目建立静态主页。github为用户提供项目托管、git、pages等用于项目开发的功能。我们使用的就是其pages服务。相对于其他提供免费博客的网站,github的最大优点是无任何广告且提供git版本管理工具对博客进行管理。但劣势是需要一定的命令行操作,对于普通用户有一定门槛。也因此,octopress+github被成为最适合hack的建博方式。

Step 1 注册github

打开github.com,输入用户名、邮箱、密码,然后点sign up for free即可注册完成。

Step 2 安装octopress

(1)安装git和ruby

在终端中执行:

sudo apt-get install git ruby ruby-dev

(2)准备octopress

执行

git clone git://github.com/imathis/octopress.git octopress
cd octopress    # 如果你使用RVM, 你会被询问你是否信任 .rvmrc 文件 (选择 yes).
ruby --version  # 这条命令应该输出 Ruby 1.9.3

然后安装依赖

gem install bundler
rbenv rehash    # 如果你使用 rbenv, 执行 rehash 以运行 bundle 命令
bundle install

最后安装默认主题

rake install

Step 3 部署到github上

(1)建立一个新的github项目

点击【Create a New Repository】,然后以 用户名/用户名.github.io 的格式建立一个新项目。 (2)部署

首先运行

rake setup_github_pages

这条命令会询问你刚才建立的项目的地址,按提示输入,然后就会生成一些用于部署的文件。 接着执行

rake generate
rake deploy

这两条命令会生成博客内容,然后添加到git中,自动执行git commit然后推送到主分支(master branch)。几分钟后,你会收到github通知你你的提交已经被接受并发布了你的网站的email。

不要忘记把为你的博客提交source(Don’t forget to commit the source for your blog)

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

Step 4 发布博客

你发布的文章被放在source/_posts目录下,并按照Jekyll的命名规则命名:YYYY-MM-DD-post-title.markdown。这个名字会被用于生成url且日期会被用于为文章按时间排序。 但这样比较麻烦,于是Octopress提供了一个rake task来自动按照正确的命名规则建立博文,并生成基本内容。

格式是:

rake new_post["title"]

官网给出这样的样例:

rake new_post["Zombie Ninjas Attack: A survivor's retrospective"]
# 这条命令会创建 source/_posts/2011-07-03-zombie-ninjas-attack-a-survivors-retrospective.markdown文件

会生成如下内容的文件:

---
layout: post
title: "Zombie Ninjas Attack: A survivor's retrospective"
date: 2011-07-03 5:59
comments: true
external-url:
categories:
---

你可以在这里设置评论功能开关,设置分类。如果你的博客有多个作者共用,你可以在文件中添加【author:Your Name】。如果你在编辑一个草稿,你可以添加【published: false】以使其在生成博客内容时被自动忽略。

Step 5 生成 & 预览

rake generate   # 在公开目录中生成博文和页面
rake watch      # 查看 source/ and sass/ 的改动
rake preview    # 在浏览器中输入 http://localhost:4000 即可预览。

Step 6 推送到github

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

然后过几分钟,github就会自动更新你的博客了。

注意:执行rake deploy前一定要先rake generate一下

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!