1. 程式人生 > >新手用hexo和github搭建屬於自己的部落格

新手用hexo和github搭建屬於自己的部落格

在網上看過很多大佬寫的教程,但是首次搭建仍會遇到許多問題。在這裡,我記錄了我搭建部落格的過程,貼上我踩過的坑,一方面是做個整理,另一方面是幫助看到文章的人少走些彎路。

本文主要介紹win10下hexo3.7.1+github的搭建。

搭建環境

  1. 安裝git
    可以到git官網下載相應平臺的版本進行安裝。考慮到你可能是無照駕駛,直接在github/git下載。

  2. 申請github賬號
    進入github註冊。此處省略一千字。

  3. 安裝node.js
    到node.js官網下載相應平臺的最新版本,傻瓜式安裝(自帶安裝npm)。

  4. 安裝hexo
    開啟git bash或者cmd,執行以下命令:

npm install -g hexo-cli

如果沒有錯誤提示,那麼在git的互動環境輸入以下命令檢視git版本:

hexo version

搭建hexo

首先建立一個資料夾,如blog,用來存放hexo的配置檔案等,然後進入blog進行操作。
1. 初始化
右鍵 git bash,執行以下命令:

hexo init

2. 安裝依賴包
npm install

3. 生成靜態頁面

hexo generate或者hexo g

4. 本地執行

hexo server或者hexo s

開啟瀏覽器,在位址列輸入localhost:4000,就可以看到我們搭建好的本地部落格了。到此只是搭建好了本地部落格,還需要將部落格部署到github上。

配置github

  1. 新建repository
    建立與你使用者名稱對應的倉庫,倉庫名必須為【 your_username.github.io】 。

  2. 部署部落格
    進入你的hexo資料夾根目錄下,用編輯器開啟_config.yml,修改deploy項,如下(根據你的github進行相應更改):

 deploy:
  type: git       #注意:有的版本type是github
  repo: https://github.com/你的賬戶名/你的賬戶名.github.io.git
  branch: master

此時就完成部署了,用瀏覽器訪問xiaobinhong1.github.io即可(第一次釋出可能會有10分鐘的延遲)。

每次修改完本地的檔案後要執行以下命令,重新部署到github上:

hexo clean
hexo generate
hexo deploy或者hexo d

部署時保證README.md檔案不被渲染

確保README.md檔案不被渲染很容易,只要在部落格根目錄下的配置檔案_config.yml中配置一下”skip_render”選項就行了,將不需要渲染的檔名稱加入的其選項下就行了。

skip_render: README.md

常用命令

hexo new “postName” // 新建文章
hexo new page “pageName” // 新建頁面
hexo generate // 生成靜態頁面至public目錄
hexo server // 開啟預覽訪問埠(預設埠4000,’ctrl + c’關閉server)
hexo deploy // 將.deploy目錄部署到GitHub
hexo help // 檢視幫助
hexo version // 檢視Hexo的版本

error 解決方法

1.出現 error deployer not found:git 或者 error deployer not found:github 的錯誤
解決辦法:執行 npm install hexo-deployer-git –save

2.出現類似 FATAL can not read a block mapping entry; a multiline key may not be an implicit key at line 70, column 1: … 錯誤
解決辦法:_config.yml中配置項的冒號後面要用空格隔開,再跟內容

3.中文亂碼問題
解決辦法:將內容所在檔案的編碼改為UTF8格式