HEXO+Github搭建個人博客

本文會詳細介紹hexo+github搭建博客的過程。由於此博客於17年11月底搭建,具體操作步驟可能會有遺漏,如果講述的不清楚的地方敬請指正。在搭建博客之前,需要安裝node和git,具體操作請參考[上一篇文章](happyjeannie.github.io/),node和git版本分別為v8.7.0和v2.16.2,MacOs,並同時申請Github賬號。使用的開發工具為VScode。

一、安裝Hexo

1、首先創建一個文件夾如blog,用於存放整個博客文件。在菜單欄中選中文件夾,右鍵然後選中**在終端中打開**,即可在當前vscode打開終端。大家可以根據自己的項目目錄打開到blog文件夾下。

2、執行如下命令安裝Hexo:

sudo npm install -g hexo //安裝hexohexo init //初始化hexo,這樣blog就是整個博客的根目錄,所有的頁面都在裡面進行增刪改hexo generate //生成靜態頁面hexo server //啟動本地伺服器,進行博客文章預覽

在瀏覽器下打開localhost://4000即可預覽,hexo應該會默認生成一篇博客《Hello World》。

博客整體目錄預覽:

其中_config.yml和package.json為項目的配置文件,source->_post為我們的博客目錄,public為執行hexo generate後生成的靜態頁面。

二、關聯Github

1、在你的Github中建立新的倉庫,倉庫名為your_user_name.github.io(敲重點,必須一樣),此處我創建的倉庫名為:

HappyJeannie.github.io,然後與我們的博客建立關聯。

2、打開blog(項目目錄)目錄,將_config.yml文件在VScode中打開,翻到最下面,找到depoly,修改其配置信息如下:

修改完成後在終端執行:

npm install hexo-deployer-git --save //安裝 git 部署插件hexo deploy //將本地博客代碼部署到Github

3、將本項目所在倉庫中,開啟 GitHub Pages功能,具體操作為打開倉庫->settings,如下圖所示:

選中master branch並點擊save即可。

三、tips

1、_config.yml中的縮進和空格一定嚴格按照文件的默認格式來,不然會報錯;

2、想要刪除博客的話,直接刪除source->_posts->對應的博客文章,然後在執行hexo generate、hexo deploy即可;

3、在_config.yml中修改language為zh-CN,即可將博客中英文轉換為中文;

4、常用命令

hexo new "postName" //新建文章hexo new page "pageName" //新建頁面hexo server //啟動本地伺服器hexo generate //生成靜態文件hexo deploy //部署到Giihubhexo help //查詢幫助

5、插入圖片

在hexo中,所有圖片保存在public->css->images文件夾下,頁面引入路徑為:

./../../../../css/images/xxx.png

6、markdown語法查詢;

本文已發布至個人博客以及簡書。個人原創,轉載請註明出處。


推薦閱讀:

通過配置Listary實現對知乎和Github的高效搜索
GitHub 怎麼讀?
如何寫好Github中的readme?

TAG:Hexo | 個人博客 | GitHub |