Reference Page setup-ghost-for-github-pages
前言
用 Setup Ghost 作為 Ghost 部落格的第一篇文章也滿別具意義的, 不過在最一開始 Survey 時選用架設 Blog 的 Framework 是 Octopress , 但隨著架設完後一邊試用的體悟, 發現整個操作還真是
SuckGeek啊! 只好再廣泛的涉略一下後選用了 Ghost。
雖然 Octopress 與其同為支援 Ｍarkdown 的語法, 但選用Ghost的最大好處是後台已經整合了 Markdown的即視編輯器 (可能還稱不上殺手應用, 但已深得我心)
Before Install Node.js
Ghost 是用 Node.js 打造, 所以在執行過程中需要啟動 Node.js
而在 Mac 環境上安裝軟體套件目前常見的方式是透過 brew (也是參考網頁所上提供的), 但因為遇到了以下問題所以又花了些時間一一排除, 這邊稍微做簡單的說明避免大家繞路。
- 透過 brew 無法安裝目前 Ghost 所相容的版本, 在啟動時出現以下 Error Message
Ghost needs Node version ~0.10.0 || ~0.12.0 || ~4.2.0 you are using version 5.4.0 - 修正後的做法, 改先透過安裝 nvm(node version manager)
brew install nvm之後再進行指定版本的 node.js 安裝 參考網頁 ,
但後續仍會遇到 https://github.com/creationix/nvm/issues/855 的問題, 需透過多餘的指令解決衝突的部分,
NVM is not compatible with the npm config "prefix"
並且會導致 Shell start-up latency 時間拉長
所以最終的建議做法是 follow nvm官網 指令來安裝 nvm , 如下
git clone https://github.com/creationix/nvm.git ~/.nvm && cd ~/.nvm && git checkout `git describe --abbrev=0 --tags`
將以下行加入 ~/.bashrc, ~/.profile, or ~/.zshrc, 讓系統自動幫你在登入時 source 完 script
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm
By the way 官網也就有提到 Homebrew installation is not supported.
Install Node.js
在順利安裝完 nvm 之後, 透過以下指令可以秀出目前 nvm 的版本
nvm ls-remote
並再以指令安裝建議的版本, 筆者目前安裝的版本為 Ghost 所建議的 4.2.0
nvm install 4.2.0
指定所使用的 Node.js version
nvm use 4.2.0
Download and Install Ghost
Check for the latest version of Ghost from Ghost.org
mkdir ghost
cd ghost
wget --no-check-certificate https://ghost.org/zip/ghost-0.7.5.zip
unzip ghost-0.7.5.zip
npm install --production
npm 全名為 Node Package Manager，是 Node.js 的套件（package）管理工具, 透過
npm install會安裝 node.js 應用程序底下, package.json 文本中 dependencies 指定的相關套件, 透過這樣的方式可以降低拿到該應用程序在執行環境建立的複雜度。
Start Ghost
npm start
Login to Ghost
透過 Browser 開啟以下網址連結到設定頁面, 也可以閱讀 Ghost 幫使用者預設好的第一篇文章 Welcome to Ghost 上所提供的資訊
open http://localhost:2368/ghost
總結
透過以上的步驟就可以在本地端建立一個部落格平台, 下一章節會繼續介紹如何將本地端的部落格部署到 git.io 上。