[Ubuntu] 使用 Github 架設 Octopress Blog

前言

  最近寫 blog 時發現用 Markdown 語法來寫作效率快很多,可以省去一些無謂的排版精力,無奈 Blogger 不支援 Markdown,在網路上搜尋了一番找到了 Octopress,然而我並沒有使用 Github 的經驗,所以在這邊記錄一下我當初所遇到的問題。

操作

安裝環境:Ubuntu 16.04

前置步驟

1
2
3
4
5
apt-get install ruby-dev
apt-get install nodejs
apt-get install rbenv
gem install bundler
rbenv rehash

將 Octopress 給 git clone 下來

1
2
3
4
git clone https://github.com/imathis/octopress
cd octopress
bundle install
rake install

輸入 Github Page 連結

先到 https://github.com/new 新建一個 Repository

Repository name 內輸入 username.github.io

記得不要勾選 initialize this repository with a README

送出後你會得到一個 [email protected]:username/username.github.io.git 的格式

回來 Ubuntu 輸入指令並將剛剛獲得的 SSH 位置給填進去

1
rake setup_github_pages

生成靜態網頁並上傳到 Github Page

1
2
rake generate
rake deploy

如果你 rake deploy 時遇到 Public Key 的問題,請你參考 伺服器上的 Git - 生成 SSH 公開金鑰

生成完公開金鑰後,到 https://github.com/settings/keys 新增 SSH Key

以上步驟都完成後,試著訪問 username.github.io 你應該可以看到一個初步的 Blog

指定域名

要綁定頂級域名的話,新增兩筆 A 記錄分別指到 192.30.252.153192.30.252.154

次級域名只需要新增一個 CNAME 記錄即可

新增完畢後回到主機上建立 CNAME 檔案即可

1
echo 'downager.com' >> source/CNAME

編輯網站設定

編輯 /octopress 底下的 _config.yml 來修改設定

1
nano _config.yml

# ----------------------- #
#      Main Configs       #
# ----------------------- #

url: http://downager.com
title: Downager's 工作手札
subtitle: 記錄安裝上遇到的疑難雜症
author: Downager
simple_search: https://www.google.com/search
description:

# Default date format is "ordinal" (resulting in "July 22nd 2007")
# You can customize the format as defined in
# http://www.ruby-doc.org/core-1.9.2/Time.html#method-i-strftime
# Additionally, %o will give you the ordinal representation of the day
date_format: "ordinal"

新增文章

1
rake new_post["XXXXXXXXXX"]

新增完畢後到 source/_posts/ 底下去編輯 YYYY-MM-DD-XXXXXXXXXX.markdown

1
vim source/_posts/YYYY-MM-DD-XXXXXXXXXX.markdown

編輯完成後將文章發布

1
2
rake generate
rake deploy

上傳 Blog 原始文件到 Github

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

參考資料