hexo+gitHubPages 快速搭建個人博客

前言

本文僅僅是使用hexo以及gitHubPages 快速搭建個人博客，後續還會分享詳細的內容

官方中文文檔：
https://hexo.io/zh-cn/docs/index.html
歡迎關注我的博客：destiny'Note
本文引自：hexo+gitHubPages 快速搭建個人博客

一、準備

Node.js
作用：node.js用來創建hexo博客框架
Git客戶端
作用：把本地的hexo內容提交到github上去

二、Hexo

打開下載好的Git Bash或者Git Shell，作用相當於命令行。

過程中使用的是cnpm，下載node會自帶npm，下面使用的是淘寶鏡像cnpm

1. 安裝Hexo

cnpm install -g hexo

-g爲全局安裝

2. 創建博客根文件夾

進入要創建博客的文件夾下（如E:\Hexo），執行以下指令，Hexo 即會自動在目標文件夾建立網站所需要的所有文件。

hexo init  "文件夾名"

文件夾名稱可以不寫，那樣就會把所有文件放在你先前進入的文件夾

3. 安裝依賴包

cnpm install

把package.json文件所定義的所有依賴項全部安裝

4. 運行

常用命令

hexo g #完整命令爲hexo generate,用於生成靜態文件
hexo s #完整命令爲hexo server,用於啓動服務器，主要用來本地預覽
hexo d #完整命令爲hexo deploy,用於將本地文件發佈到github上
hexo n #完整命令爲hexo new,用於新建一篇文章
hexo g -d #兩個命令的合成，一般在修改或者添加博文後直接使用這個命令

運行下面代碼：

hexo g
hexo s

訪問http://localhost:4000， 此時，你就能看到了一個漂亮的博客。
默認主題爲：landscape

三、註冊Github帳號

已經有Github帳號跳過此步

1. 首先進入Github進行註冊

2. 然後，創建repository

repository相當於一個倉庫，用來放置你的代碼文件。首先，登陸進入Github，並進入個人頁面
然後New一個repository

]

點進倉庫，點擊settings設置

下拉到GitHub Pages設置

source選中 master bransh ，然後save，就會出現一個網址。

四、部署本地文件到github

1. 安裝依賴

cnpm install hexo-deployer-git --save

2. 編輯配置文件

編輯博客文件夾下的_config.yml文件。

在_config.yml最下方，添加如下配置：

deploy: 
    type: git
    repo: https://github.com/用戶名/倉庫名/
    branch: master

3. 配置SSH

輸入一下命令：

ssh -T [email protected]

你應該會看到有警告，但是會有選項（yes/no），輸入“yes”就好

4. 運行

在命令行中運行

hexo g -d

完成後，打開原先的倉庫網址，就能看到你的博客。

五、寫博文

1. 新建博文

hexo new "my new post"

2. 編輯博文

博文使用的是markdown語言，如果有不會使用的，請參考我的博文：
mardown學習總結

在博客目錄下\source_post中打開my-new-post.md，進行編輯

3. Front-matter

博文的頭部，官方文檔介紹：Front-matter

Front-matter 是文件最上方以 ---分隔的區域，用於指定個別文件的變量，如：

---
title: Hello World   #博文標題名
date: 2013/7/13 20:46:25  #時間
categories: blog     #文章文類
tags: [life，travel]  #文章標籤 只有一個標籤時：tags: travel
---
#這裏是正文，用markdown寫
#你可以選擇寫一段顯示在首頁的簡介後，加上<!--more-->
#在<!--more-->之前的內容會顯示在首頁，之後的內容會被隱藏，當遊客點擊Read more才能看到。

寫完文章後，你可以直接運行hexo g -d 上傳到github。

六、創建頁面

使用命令：

hexo new page "pagename"

1. 歸檔頁面

hexo new page "archives"

進入博客目錄的source/archives/index.md，添加type值：

---
type: archives
---

2. 分類頁面

hexo new page "categories"

進入博客目錄的source/categories/index.md，添加type值：

---
type: categories
---

3. 標籤頁面

hexo new page "tags"

進入博客目錄的source/tags/index.md，添加type值：

---
type: tags
---

注意：上述頁面都有對應插件生成，只需更改type值

4. 自定義頁面

以上述同樣的方法創建頁面

1. 需要模板，自行修改對應的index.md文件內容
2. 不需要模板，完全自定義
   • 首先，在博客目錄下的_config.yml文件中，在skip_render後面添加頁面路徑
   • 修改index.md文件，或者將index.md修改成index.html文件，自行添加樣式等

參考

胖逆的嘟嘟的博文：
hexo 的八篇乾貨