使用Hexo快速搭建一個博客,並部署到github

本文旨在記錄一下我在通過hexo搭建一個博客,並將其部署在github上面的過程,也供我自己在以后的使用過程中能夠快速學習和參考.需要看更詳細或者官方文檔的可以點擊Hexo官方文檔進行查看.

 

安裝前提

安裝 Hexo 非常簡單。需要預先安裝:

• Node.js
• Git

准備條件做好了之后就可以開始安裝Hexo了

安裝Hexo

打開Git Bash 執行命令

1	$ npm install -g hexo-cli

 

創建博客

Hexo安裝完成后,分別執行如下命令,Hexo會自動生成需要的文件夾

1 2 3

$ hexo init <folder> ##<folder> 為你指定的文件地址 $ cd <folder> $ npm install

例如:需要將博客搭建在本地的D:\my_hexo下,則分別執行命令:hexo init D:\my_hexo ,cd D:\my_hexo,npm install
執行完命令后如果沒有問題我們就可以執行啟動命令來查看我們的博客了.

本地預覽

1 2 3

$ hexo server ## 啟動服務,默認端口4000 $ hexo server -p xxxx ## 自定義端口啟動服務 $ hexo clean ## 清除緩存,在頁面顯示不正常的時候可以執行此命令

然后在瀏覽器輸入http://127.0.0.1:4000/ 即可訪問

創建Repository

1. 登錄github 點擊右上角的”+”,Create a new repository

Create a new repository

1. 復制剛剛新建的https連接:https://github.com/Admol/admol.github.io.git
2. 打開你hexo目錄下的_config.yml
3. 設置deploy信息,如:

   1 2 3 4

   deploy: type: git repository: https://github.com/Admol/admol.github.io.git branch: master

 

設置SSH key

1. 檢驗是否已存在key
   分別執行命令

   1 2	cd ~ cd .ssh

   再執行命令 ls 查看是有已有key文件,一般存在key的話都會顯示id_rsa.pub 和 id_dsa.pub這兩個文件,沒有key什么都不會顯示

2. 添加一個 SSH key

   執行命令(已有key的可以跳過步驟2):

   1 2 3

   $ ssh-keygen -t rsa -C "[e-mail]" ## t 指定密鑰類型，默認是 rsa ，可以省略。 -C 設置注釋文字，比如郵箱或其他。

   然后會提示你 Enter Enter file in which to save the key (/c/Users/you/.ssh/id_rsa): [Press enter,這里是輸入一個文件名用來保存ssh key,也可以什么都不輸,會使用默認的id_rsa.pub 和 id_dsa.pub

   回車之后,需要輸入兩次密碼(該密碼是你push文件的時候要輸入的密碼，而不是github的密碼)
   輸入密碼之后,看見如下顯示信息,添加SSH key成功.
   

3. Github 設置 SSH key

   登錄github,點擊Settings,然后點擊 SSH keys ,在這個頁面你可以管理你所有的ssh keys
   然后點擊Add SSH key
   用文本編輯器打開剛剛添加的key文件id_rsa.pub,復制里面的所有的內容
   回到github頁面,將復制的內容粘貼到剛剛那個頁面的key對應的文本框里面,title 可以隨便填寫

4. 測試ssh key 是否添加成功
   在命令行輸入:

   1	$ ssh -T [e-mail]

   會出現一段警告代碼,輸入yes回車,然后會要求你輸入剛剛設置的密碼,然后它會和你說:Hi,帥哥....約嗎
   
   

到此SSH key就設置完畢了

部署到Github

打開命令窗口,回到你的hexo博客目錄下,如別執行如下命令:

1 2	hexo generate hexo deploy

 

等待命令執行完畢后,可以查看代碼是否已提交到github上,然后在瀏覽器輸入admol.github.io就可以訪問了

 

新建頁面

1	$ hexo new page 'pageName'

執行命令后可以在你本地的/source 目錄下看見以為你新增頁面名為名的文件夾

顯示頁面

打開文件后可以對index.md 進行編輯.然后打開/themes/jacman目錄下的_config.yml文件(自己正在使用的主題),
添加剛剛新增的頁面:

1 2 3 4 5

menu: 首頁: / 統計: /archives 關於: /about pageName: /pageName ##前面的pageName可以自定義,后面的pageName必須寫剛剛新增的頁面名稱

 

新建文章

1	$ hexo new [layout] 'name'

[layout] 為可選,不寫默認為post. /source 目錄下的文件夾名稱即為 layout 名

安裝主題

1	$ git clone https://github.com/JamesPan/hexo-theme-icarus.git themes/icarus

更換主題

首先下載主題,然后打開根目錄下的 _cinfig.yml ,修改 theme: 要更換的主題名

修改主題顏色

打開 /themes/jacman目錄下的_config.yml文件,修改:

1 2	theme_color: theme: '色值'

 

修改logo圖片

打開主題下的 _config.yml 文件,修改:

1 2 3 4

imglogo: enable: false ## 是否顯示logo src: img/logo.gif ## logo圖片地址 favicon: img/qq.ico ## 頁面左上角圖標

 

Hexo 版本升級

1	$ npm update hexo -g