什么是Hexo
Hexo是一個基于Nodejs快速簡潔高效的博客框架,Hexo使用Markdown語法來編輯文章,只需要幾秒鐘的時間就可以成生靜態的網頁。整個系統就是一個博客系統。
安裝Hexo
Hexo是基于Nodejs的博客系統,在安裝Hexo之前需要安裝Nodejs,把博客搭建在免費的GitHub上,所以需要安裝Git。如果你已經安裝上述軟件,可以跳過以下的1,2步驟
安裝Nodejs
Node.js的官網下載地址是:https://nodejs.org/,下載好之后,雙擊安裝,一路Next即可,只需要記住Node.js的安裝路徑,一般路徑是''C:\Program Files\nodejs'' 。注意的是需要添加hexo和npm到環境變量,路徑分別是 C:\Program Files\nodejs;C:\Program Files\nodejs\node_modules\npm;
安裝Git for windows
Git for windows 的下載地址是:https://git-for-windows.github.io/,下載好后也同樣是一路Next安裝即可。
安裝Hexo
右鍵桌面任意位置,打開Git Bash,執行命令:
npm install -g hexo
如果是出現錯誤,一般是因為被墻的原因,可以換國內的鏡像源試試。
npm config set registry="http://registry.cnpmjs.org"
npm install -g hexo
創建Hexo文件夾
創建一個新的文件夾(如E:\hexo),打開Git Bash
cd /e/hexo
hexo init
這一步是在hexo目錄下建立網站所需要的所有文件,除了如下的public/文件夾(public文件是生成的靜態網站)
至此本地的Hexo博客系統算是已經搭建完成了
Hexo基本命令
下面是在編輯博客和生成博客所需要的幾個常見的命令以及它們的縮寫形式。即使用新版本的Hexo兩邊是等價的命令。
hexo generate = hexo g
hexo server = hexo s
hexo delopy = hexo d
hexo new = hexo n
hexo g
hexo g 是生成靜態博客的命令,一般是對博客系統修改之后通過該命令來重新生成public 文件夾,比如添加、修改、刪除一篇博文,對博客的卑職文件修改,修改主題和添加插件等操作都是需要通過該指令Hexo g來重新生成的。
hexo s
hexo s是在本地上開啟博客系統,一般修改博客之后需要在本地上預覽調試,執行hexo g && hexo s 可以在本地瀏覽器上查看(瀏覽器上輸入 http://localhost:4000)。
hexo d
hexo d是上傳你的博客到服務器,接下來我會介紹如何上傳到git,然后就可以在github.io上查看你的博客了。
hexo n
hexo n “< blog name >”是創建一篇新的博客,執行該命令之后在 E:\hexo\source_posts 目錄下產生< blog name >.md文件,這是你的一篇新博客。可以在markdown工具下編寫,這里我就不詳細介紹了,詳細可以看這篇說明:Markdown 語法說明(簡體中文版)
部署到Github
在github上創建一個倉庫
剛才的步驟已經可以在本地上編輯文章,然后在本地可以查看效果了。接下來就是講博客系統部署到Github上。如果不清楚github是干什么用的,可以查看維基百科:github -wiki
在github上注冊一個賬號,如果有就省去這一步,創建一個倉庫,Repository name和自己的用戶名相同。比如我的用戶名為wenjunoy,那么Repository wenjunoy.github.io
配置SSH
上傳文件需要配置ssh key,不然無法上傳。
設置name和emai
git config --global user.name "<your name>"
git config --global user.email "<your email>"
需要注意的是這里的name是隨意的,郵箱是你的聯系郵箱,與github上的郵箱無關。
生成ssh 密鑰
ssh-keygen -t rsa -C "<your github's email>"
一路按回車鍵即可,如果設置了密碼請記住。
這一步在~/.ssh/下生成了兩個文件id_rsa 和 id_rsa.pub
在Github上添加SSH密鑰
打開上述的id_rsa.pub 文件,復制其內容,在https://github.com/settings/keys下 add new ssh key,
title隨便填寫,作為你的電腦的一個記號。確定即可。
測試
ssh git@github.com
顯示如下即成功
The authenticity of host 'github.com (192.30.252.128)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'github.com,192.30.252.128' (RSA) to the list of known hosts.
Hi wenjunoy! You've successfully authenticated, but GitHub does not provide shell access.
Connection to github.com closed.
部署到Github
配置_config.yml
編輯E:\hexo 下的_config.yml,修改 Deployment部分
# Deployment
## Docs: https://hexo.io/docs/deployment.html
# ssh://git@github.com/wenjunoy/wenjunoy.github.io
deploy:
type: git
repo: ssh://git@github.com/wenjunoy/wenjunoy.github.io ##這個是你的倉庫地址
branch: master
注意和每個分好右面需要添加空格
部署
hexo d
部署,執行該命令發現報錯
ERROR Deployer not found: git
執行如下命令在hexo d
npm install hexo-deployer-git --save
hexo d
根據提示輸入用戶名和密碼,等待一會便成功了
然后瀏覽器上訪問:http://wenjunoy.github.io,可以看到hexo博客搭建成功。接下來就是專注于寫博客吧。