github + hexo 搭建個人部落格教程
Github Pages介紹
本來用於介紹託管在Github上上的專案，由於它的空間免費穩定，因此適合用來搭建部落格。
每個帳號只能有一個倉庫來存放個人主頁，且倉庫的名字必須是使用者名稱/ username.github.io。你可以通過http://username.github.io來訪問你的個人主頁
個人主頁的網站內容是在主分支下
HEXO介紹
HEXO是一個快速，簡潔高效的部落格框架，具有如下特點：
- 生成靜態網頁
- 支援降價
- 一鍵部署部落格到Github Pages
- 豐富外掛
準備工作
- 下載git https://git-scm.com/download/win
- 安裝的git
- 下載node.js http://nodejs.org/download/
- 安裝的node.js
安裝HEXO
在任意位置右鍵點選Git Bash
使用NPM安裝HEXO，可以先切換NPM源，加速安裝過程
npm config set registry https://registry.npm.taobao.org npm install -g hexo
【注意】若安裝不成功，可以使用npm install hexo --save再次安裝
出現以下圖示表示安裝完成。
【注】若提示此包不再保養，耐心等待安裝即可。
配置HEXO
建立HEXO資料夾
在某一資料夾下如F：\ hexo \ blog，右鍵Git Bash在這裡，使用以下命令建立建立網站需要的檔案
hexo init
安裝依賴包
npm安裝
生成靜態檔案
hexo generate #生成靜態檔案，會在當前目錄下生成一個新的名為public的資料夾啟動HEXO
hexo server -p 5000 #使用hexo server 預設埠4000，會無法訪問localhost:4000，因此改為5000埠常用HEXO命令
hexo help #檢視幫助 hexo -v #檢視本地環境 hexo init #初始化一個目錄 hexo new "postName" #新建文章 hexo new page "pageName" #新建頁面 hexo gernerate #生成網頁，可以在public目錄檢視整個網站的檔案 hexo server #本地預覽 Ctrl+C關閉 hexo deploy #或hexo d 部署到遠端如github、heroku hexo clean #清除快取 建議每次執行命令前先清理快取，每次部署前先刪除 .deploy資料夾 #常用縮寫 hexo n #hexo new hexo g #hexo generate hexo s #hexo server hexo d #hexo deploy #常用組合 hexo d -g #生成部署 hexo s -g #生成預覽
Github Pages
註冊GitHub的賬號
地址: https://github.com/輸入賬號，郵箱，密碼，然後點選註冊按鈕.-->之後驗證郵箱
建立頁面倉庫
建立一個倉庫，需要和帳號對應，格式yourname.github.io，建立倉庫
關聯本地與github上
生成SSH金鑰
任意地方右鍵Git Bash在這裡，執行以下命令
ssh-keygen -t rsa -C“你的郵箱地址”
出現輸入要儲存金鑰的檔案（.....）直接回車選擇預設位置
出現輸入密碼（無密碼短語）直接兩次回車不設密碼以及確認
在Github上上新增SSH金鑰
開啟id_rsa.pub，複製內容。
進入你的GitHub的頁面，右上角找到設定，點選進去，找到SSH。
點選新的SSH金鑰
填寫後點擊新增SSH金鑰
上傳部署
目錄結構
- 部署＃需要部署的檔案
- node_modules #Hexo外掛
- public＃生成的靜態網頁檔案
- scaffolds＃模板
- 來源＃部落格正文和其他原始檔
- drafs＃草稿
- 帖子＃文章
- 主題＃主題
- config.yml＃配置檔案
部署
原理
- 上述步驟中在Github上建立的那個倉庫username.github.io，可以通過該連結訪問
- Hexo -g會生成一個靜態網站，第一次會生成一個公共目錄，這個靜態檔案可以直接訪問
- 需要將Hexo生成的靜態網站，提交（git commit）到github上
過程
- 需要在_config.yml中修改
deploy:
type: git //注意：冒號後面有英文空格
repository: http://github.com/username/username.github.io.git
branch: master
安裝依賴包
npm install hexo-deployer-git --save
配置好之後執行
hexo genearte
hexo deploy
【注】以上命令執行的環境必須在執行hexo init建立的資料夾下執行
執行完以上命令，會出現頁面輸入你的github上使用者名稱和密碼，驗證後就可以上傳成功
訪問 username.github.io，成功開啟頁面即部署成功
新建文章
hexo new“postname”
該命令會自動在HEXO /源極/ _post資料夾下建立一個名為postname的降價檔案，會自動在檔案開頭新增
---
title: 你的題目
tags: 你的標籤
category: 你的分類
---
填寫標籤，類別，新建標籤頁面和分類頁面後即可以顯示相應的標籤和分類
新建標籤頁面
hexo新頁面標籤
該命令會自動在HEXO /原始檔夾下建立標籤資料夾並在該資料夾下建立index.md檔案。
修改index.md檔案，新增以下兩項
layout：tags
comments：false
新建分類頁面
hexo新頁面類別
該命令會自動在HEXO /原始檔夾下建立類別資料夾並在該資料夾下建立index.md檔案
修改index.md檔案，新增以下兩項：
佈局：類別
評論：false
最後我們hexo g -d一把，開啟自己的頁面檢視
以下是博主搭建的部落格連結 https://liuziqiao.github.io