新手用hexo和github搭建屬於自己的部落格
在網上看過很多大佬寫的教程,但是首次搭建仍會遇到許多問題。在這裡,我記錄了我搭建部落格的過程,貼上我踩過的坑,一方面是做個整理,另一方面是幫助看到文章的人少走些彎路。
本文主要介紹win10下hexo3.7.1+github的搭建。
搭建環境
安裝git
可以到git官網下載相應平臺的版本進行安裝。考慮到你可能是無照駕駛,直接在github/git下載。申請github賬號
進入github註冊。此處省略一千字。安裝node.js
到node.js官網下載相應平臺的最新版本,傻瓜式安裝(自帶安裝npm)。安裝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
新建repository
建立與你使用者名稱對應的倉庫,倉庫名必須為【 your_username.github.io】 。部署部落格
進入你的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格式