利用Hexo + GitHub搭建免費的個人博客

利用Hexo + GitHub搭建免費的個人博客

今天給大家帶來一份用Hexo + Github 搭建屬於自己的個人博客的教程。其實現在這種博客的搭建方式有很多種。最早我見的是Jekyll、接下來這個Hexo,最近在研究Python發現用Flask和Django都可以搭建的,只是路數不同罷了。 我選擇了這個Hexo,目前這個用的人也比較多,應該說是簡單易搭建吧,可擴展也可自己美化。話不多說,下面就開始。


1.環境配置

首先要明確有幾個環境是必須有的。沒有的話請先安裝。
- Git(官網下載較慢,我建議用這個網址gitb,org
 作用:用來提交Hexo的內容。
- nodejs(我建議用v4.*版本較好,官網有6.*和8.*的我裝上後有點問題)
 作用:用來生成靜態頁面的。
- Github的賬號(自己申請,並創建一個名爲yourname.github.io的倉庫)

自行安裝完環境後,將自己 SSH key導入到申請的GitHub中。建議導入,不然後面每次提交代碼都要手動輸入GitHub的賬號密碼,相當麻煩。

2.Hexo安裝部署

Hexo的安裝也相當簡單,以Windows爲例:

$ cd d:/hexo
$ npm install hexo-cli -g   #  -g代表全局安裝
$ hexo init blog            #  初始化blog目錄
$ cd blog
$ npm install               #  安裝依賴的組件
$ hexo g # 或者hexo generate
$ hexo s # 或者hexo server,可以在http://localhost:4000/ 查看
說幾個比較常用的命令
1. hexo generate (hexo g) 生成靜態文件,會在當前目錄下生成一個新的叫做public的文件夾
2. hexo server (hexo s) 啓動本地web服務,用於博客的本地預覽
3. hexo deploy (hexo d) 發佈博客到遠端
4. hexo clena 清除hexo g生成的本地緩存
5. hexo new “postName” #新建文章
6. hexo new page “pageName” #新建頁面

還有一些常用的組合
hexo d -g #生成後+遠程部署
hexo s -g #生成後+本地預覽

現在我們來看一下本地預覽的效果吧

hexo g

hexo s

  其實這裏有個問題,默認的4000端口我在Windows上一直打不開,我沒有在配置文件中重新設置,所以我每次啓動的時候都會用這個命令指定端口`hexo s -p 40000` 我直接加了個0,用了40000端口。 出現下面這個就說明你可以開始用網頁在本地預覽了。
INFO  Start processing
INFO  Hexo is running at http://localhost:40000/. Press Ctrl+C to stop.

預覽圖如下:
這裏寫圖片描述

然後你就可以發佈到你的Github上了

用命令hexo d 即可。但是我們發現需要輸入Github的賬號密碼,所以這裏還需要配置你的Github的地址,
編輯本地的_config.yml 文件,這是關於Hexo的配置文件。找到如下配置項:

deploy:
  type: git
  repository: [email protected]:Lancelothe/Lancelothe.github.io.git
  branch: master

按照我的格式填寫即可,我的Github名字是Lancelothe,所以你需要將這個改爲你的名字。關於type和repository的格式似乎在Hexo3.0版本以上就是需要這樣寫,以前好像type可以寫成github.
如何查看你的Hexo版本呢?

hexo -v命令

hexo: 3.3.7
hexo-cli: 1.0.3
os: Windows_NT 6.1.7601 win32 x64
http_parser: 2.5.2
node: 4.4.2
v8: 4.5.103.35
uv: 1.8.0
zlib: 1.2.8
ares: 1.10.1-DEV
icu: 56.1
modules: 46
openssl: 1.0.2g

到此爲止,你的Hexo個人博客就已經搭建完畢了。 下面來看看搭建過程中哪些可能遇到的問題

3.錯誤總結

問題1:npm install 報 command not found

原因:PATH配置不對。
解決:選擇『計算機』-『屬性』-『高級系統設置』-『環境變量』,先查看了『系統變量』部分,發現安裝後確實在系統變量的Path後追加了安裝路徑,即:C:\Program Files\nodejs;然後,打開『用戶環境變量』部分查看了下Path的值,發現在最後系統自動加入了C:\Users\s94983\AppData\Roaming\npm,在『用戶環境變量』部分的Path下再追加C:\Program Files\nodejs,然後關閉掉git base,(有可能需要重啓電腦纔可生效)問題解決!

問題2:hexo deploy時重複輸入用戶名密碼的問題

原因:repository配置時沒有采用[email protected]的形式,而是採用了老的https://github.com
解決:採用[email protected]形式即可。

問題3:ERROR Deployer not found: git 或者 ERROR Deployer not found: github

原因:未安裝依賴包


解決:使用 npm install hexo-deployer-git --save 安裝依賴

問題4:npm安裝時下載速度慢

解決: 可以換成淘寶的鏡像源。
鏡像舉例:
1.臨時使用
npm --registry https://registry.npm.taobao.org install express

2.持久使用
npm config set registry https://registry.npm.taobao.org
// 配置後可通過下面方式來驗證是否成功
npm config get registry
// 或npm info express

3.通過cnpm
使用
npm install -g cnpm --registry=https://registry.npm.taobao.org
// 使用cnpm install expresstall express

後面還會爲大家帶來Hexo的高級用法的,謝謝支持。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章