如何使用github pages與hexo教程搭建一個獨立博客

摘要

這篇教程是基于簡書作者CNFeat的文章《如何搭建一個獨立博客——簡明Github Pages與Hexo教程》的簡短補充版,在原教程的基礎上,簡單加入了一些個人在參考該教程搭建博客過程中遇到的問題和解決問題的描述,相信能夠給予后來者更多的幫助。

原教程鏈接:http://www.itdecent.cn/p/05289a4bc8b2

前言

很久之前就有搭建自己的個人網(wǎng)站寫博客的欲望,覺得是一件特別酷的事情。看過一些大牛的博客網(wǎng)站,很欽佩那些不僅在自己的技術領域刻苦專研,同時在人文領域也不斷學習和思考的工程師們。直到看到了CNFeat的這篇教程,覺得搭建網(wǎng)站寫博客好像也不是一件特別麻煩又復雜的事情??傊?,抱著記錄人生的思考感悟,督促自己不斷提問、學習、思考和輸出的愿望,懶癌患者終于動工了。在初步搭建獨立博客的過程中,遇到了很多意想不到的問題。作為一個只注冊了Github賬號,對Node.js、Git和Hexo不了解也未使用過的技術小白,一步一步摸索并沒有想象中那么一帆風順,所以將此過程遇到的問題和解決辦法分享出來,希望能給后來者一些參考。

關于原教程

我覺得CNFeat的教程寫的很好,不僅簡潔明了,還特別具有“煽動性”!看完文章后,我立刻關注了作者本人。但是具體操作的過程相信肯定會因人而異,具體步驟請參考原教程,這里僅就實踐中遇到的問題和解決辦法加以說明。

搭建過程遇到的問題:

1.node.js安裝問題
貌似nodejs.msi格式文件一直安裝不成功,總是提示

1.PNG

應該還有人有其他安裝不成功的原因,上網(wǎng)找了很久還是沒有找到根本的解決方法, 所以采用了迂回的解決方式,求助于nodejs.exe安裝,參考教程如下:
http://blog.csdn.net/fense_520/article/details/41109541
(如果有人看到此,能給出根本的解決方法,歡迎分享,不勝感激?。?br> 補充:后來查到發(fā)現(xiàn).msi文件安裝報錯的原因是安裝的時候,沒有使用管理員權限。msi文件右鍵點開,沒有“以管理員身份運行”的選項,可以點“開始”菜單,點“所有程序”,點開“附件”,在“命令提示符”上點右鍵,選擇“以管理員身份運行”。然后輸入.msi文件的路徑,回車。

2.Git安裝問題
第一次選用git bash安裝模式,但是打開git bash始終無法使用npm


79f0f736afc379316c9520ccebc4b74542a91151.jpg

查找原因好像是因為npm不是全局安裝,沒有找到在git bash中使用npm的好的解決方式,所以重新安裝改為
第二種——安裝為windows command模式。這樣會看到環(huán)境變量中

Paste_Image.png

于是,在cmd中可以直接使用git,也可以直接用npm安裝hexo,注意安裝hexo時加上-g,表明全局安裝。關于npm的本地安裝和全局安裝可自行查找資料進行了解。

3.hexo的_config文件修改問題
我的deploy改為

Paste_Image.png

需要注意的點:
(1)冒號后面一定要加一個空格。type應該為git版本,注意github pages對應的項目名一定要為github用戶名.github.io.,我之前一直沒有注意到這個問題,用的是域名的前部加上github.io,導致github.io網(wǎng)站一直打不開,囧...注意hexo d之前,安裝npm install hexo -deployer-git --save
(2)還有一點,就是對于_config文件不要用記事本編輯,因為記事本無法轉成UTF-8格式,這里推薦sublime text編輯器:http://www.sublimetext.com/,編輯完之后,點擊file--save with encoding--UTF8

4.本地瀏覽local:4000打不開問題
原因可能是端口被占用,目前常用占用4000端口的進程為:foxitprotect.exe,對應的服務為:fxservice,停止該服務即可?;蛘咝薷膆exo server的端口,我一般在hexo g之后,直接敲命令行hexo s -p 4001,在local:4001本地瀏覽

5.主題的更改
由于不是很滿意原教程的jacman主題,所以找了下,決定使用next主題,修改過程中也遇到了一些問題,比如_config文件中的中文無法在網(wǎng)站上正常顯示的問題,查找原因發(fā)現(xiàn)language設置為:zh-CN,但是next主題的language中并沒有zh-CN文件,后改為已有的zh-Hans,問題解決。此處給出兩個關于主題修改的參考資料鏈接:
http://www.tuicool.com/articles/zeIZJzv
http://blog.csdn.net/willxue123/article/details/50994852

6.域名無法打開問題
這里想強調(diào)dnspod中添加域名的問題,之前沒看懂原教程所以找了一些資料,重新設置了一下,終于成功。這里需要查找github Pages的提供的ip,步驟如下:
ping username.github.io記錄下IP地址


然后添加到dnspod的域名解析中,我的添加如下:

Paste_Image.png

特別注意的是,在github中建立的CNAME文件是無后綴的,一定不要加后綴.txt,尤其是在本地建立的上傳的CNAME文件,一定要注意這一點。
此處可參考教程:http://jingyan.baidu.com/article/3c343ff70fb6e60d3779632f.html

最后編輯于
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容