前言
本文僅僅是使用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帳号跳過此步
- 首先進入Github進行注冊
- 然後,建立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. 自定義頁面
以上述同樣的方法建立頁面
- 需要模闆,自行修改對應的
檔案内容index.md
- 不需要模闆,完全自定義
- 首先,在部落格目錄下的
檔案中,在_config.yml
後面添加頁面路徑skip_render
- 修改
檔案,或者将index.md
修改成index.md
檔案,自行添加樣式等index.html
- 首先,在部落格目錄下的
參考
胖逆的嘟嘟的博文:
hexo 的八篇幹貨