網上相關教程很多,我就是想按自己的方式整理下,也方便以后自己有需要的時候不用翻來覆去。
注:本教程是在 macOS 環境下進行的,Windows 環境同樣適用
環境準備
Git 安裝與配置
Git 安裝
方式一:下載 git 安裝包安裝
下載地址:
方式二:通過 homebrew 安裝
- 先要安裝 homebrew,終端輸入:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- 安裝成功后,輸入以下命令安裝 git :
brew install git
- 顯示版本信息,說明安裝成功
git --version
Git 配置
Git 的配置,GitHub 的注冊,創建倉庫等可參考廖雪峰的 Git 教程
配置身份信息
命令
git config --global user.name "name"
git config --global user.email "email@example.com"
注:--global參數表示這臺機器的所有Git倉庫都使用這個設置
添加 SSH Key 到 GitHub
創建 SSH Key
ssh-keygen -t rsa -C "youremail@example.com"
一路回車即可
在用戶主目錄里找到.ssh
目錄,里面有id_rsa
和id_rsa.pub
兩個文件
登錄 GitHub,Settings 中添加 SSH Key
復制id_rsa.pub
文件中的內容到下面的Key
中,Title 隨意
Node.js 安裝
homebrew 安裝:
brew install node
或官網上下載安裝包安裝
執行命令:
node -v
npm -v
顯示版本信息,安裝成功
Hexo 安裝
- 終端執行安裝命令
npm install -g hexo-cli
因為天朝的特殊環境,可能下載速度會很慢,可以切換下 npm 源,通過淘寶 npm 鏡像下載
- 切換到淘寶的 npm 源命令
npm config set registry https://registry.npm.taobao.org
然后再執行上面的安裝命令
這里可以記下原官方源地址,如果以后要切換回來呢
https://registry.npmjs.org
或者也可以通過安裝淘寶 cnpm 來下載
- 安裝淘寶 cnpm :
npm install -g cnpm --registry=https://registry.npm.taobao.org
然后再執行命令:
cnmp install -g hexo-cli
其他的npm
命令也只要把npm
替換成cnpm
就可以了。
- 檢查是否安裝成功,執行命令:
hexo
出現下面信息說明 hexo 安裝成功
初始化 Hexo
-
cd
到指定目錄,執行以下命令,初始化一個博客目錄:
hexo init floderName
如果沒有切換過 npm 下載源,這里可能會很慢,可以先切換下 npm 源在執行上面的命令
-
cd
到博客目錄下,安裝npm
npm install
- 安裝成功后,生成
hexo g // hexo generate 簡寫
- 開啟 Hexo 服務
hexo s // hexo server 簡寫
瀏覽器中輸入 http://localhost:4000/ 即可瀏覽博客主頁,顯示效果如下:
關聯 Hexo 與 GitHub
GitHub 上新建倉庫
- 使用用戶名創建倉庫
倉庫名有固定的格式,如用戶名是 username
,那么新建的倉庫名是 username.github.io
倉庫地址:
git@github.com:username/username.github.io.git
博客配置
配置 Deployment
打開本地博客目錄下的 _config.yml
文件
如下配置:
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: git@github.com:username/username.github.io.git
branch: master
repo 就是你新建的倉庫的地址
注意::
后面空一格
配置網站個人信息
# Site
# 博客標題
title: 大神的個人博客
# 副標題
subtitle: 獨一無二,無與倫比
# 簡介
description: 編程使我快樂,快樂就要編程
# 作者
author: 大神
# 語言
language: zh-Hans
# 時區
timezone:
URL 配置
# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
# 博客地址或個人域名
url: https://username.github.io/
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:
發布文章
新建文章
hexo new "hello-hexo"
在本地博客目錄中/source/_posts
中就新建了hello-hexo.md
的 Markdown 文件,用 Markdown 編輯器就可以編輯文章了
部署到博客
- 安裝 hexo git 插件
cnpm install hexo-deployer-git --save
- 執行命令
hexo g
hexo d // hexo deploy 簡寫
或
hexo d -g
沒有安裝 hexo git 插件會出現以下錯誤信息
ERROR Deployer not found: git
- 發布成功,訪問 https://username.github.io/ 查看博客效果,如下我的博客效果
說明 Hexo 與 GitHub 關聯成功
博客終于搭好了,開不開心
博客主題配置
參考文章:手把手教你用Hexo+Github 搭建屬于自己的博客