利用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的高級用法的,謝謝支持。