GitPages+Hexo搭建個人博客

hexo1

前言

偶然間發現Hexo這款很不錯的博客框架,能直接生成靜態文件,可以很方便的進行部署,搭配GitPages簡直不要太棒,省去了服務器的維護。支持Markdown,剛好符合我的習慣,因此決定使用Hexo+GitPages的方式搭建一個個人博客,歡迎訪問Sunshine。此處記錄搭建的過程。

初始化GitPages

GitPages的使用依賴於GitHub賬號,若沒有需要自行創建。

基本使用

  • 新建Repository,命名爲<GitHub賬戶名>.github.io
  • Clone倉庫到本地,並創建測試頁面,命名爲index.html,Push到遠程GitHub,即可通過<GitHub賬戶名>.github.io訪問到頁面

自定義域名

  • 進入Repository的設置界面,在Custom domain填入域名地址
  • 配置域名解析,添加CNAME類型的記錄,填入<GitHub賬戶名>.github.io

安裝Hexo

Hexo依賴Node.jsGit,詳細步驟可參考官方文檔

使用npm安裝Hexo

npm install -g hexo-cli

初始化博客目錄

爲自定義文件夾,Hexo會在該文件夾下創建博客文件。

hexo init <folder>
cd <folder>
npm install

啓動博客服務器

在博客目錄下,執行如下命令即可啓動博客服務器,可以看到一篇示例博文。默認端口4000,訪問地址爲:http://localhost:4000

hexo server

在這裏插入圖片描述

新建文章

使用Hexo的命令創建一篇文章,會在source/_posts路徑下生成對應的Markdown文件。關於創建文章的詳細說明,參照官方文檔

hexo new FirstPage

使用文本編輯器,編輯文章的內容,最好使用可視化的Markdown編輯器。啓動博客服務,可看見新建的文章。
hexo3

發佈博客到GitPages

方式一:手動提交靜態網頁

使用將Hexo生成的靜態網頁文件手動提交到代碼倉庫的方式來發布博客。

  • 執行hexo generate命令,會在博客目錄生成public文件夾,裏面是打包的靜態網頁文件
  • public文件夾下的內容push到GitPages的倉庫
  • 訪問GitPages即可看到博客的內容

方式二:使用Hexo的deploy命令發佈

通過配置Hexo的部署選項,部署博客到GitPages。

  • 安裝hexo-deployer-git
npm install hexo-deployer-git --save
  • 編輯_config.yml配置文件,加入部署的相關配置
deploy:
  type: git
  repo: https://github.com/<username>/<username>.github.io
  branch: [branch] #默認爲master,GitPages的個人主頁只能部署master分支,項目主頁可選
  message: [message]
  • 生成博客站點文件並部署至遠程倉庫
hexo clean && hexo deploy
  • 查看GitPages所在倉庫文件是否更新,進入GitPages頁面即可看到博客內容

總結

本篇文章只粗略的記錄了主要步驟,更多詳細使用說明請參照官方文檔。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章