Hexo + GitHub 博客搭建

网上相关教程很多,我就是想按自己的方式整理下,也方便以后自己有需要的时候不用翻来覆去。

注:本教程是在 macOS 环境下进行的,Windows 环境同样适用

环境准备

Git 安装与配置

Git 安装

方式一:下载 git 安装包安装

下载地址:

https://git-scm.com/download

方式二:通过 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_rsaid_rsa.pub两个文件

登录 GitHub,Settings 中添加 SSH Key

复制id_rsa.pub文件中的内容到下面的Key中,Title 随意

image.png

Node.js 安装

homebrew 安装:

brew install node

或官网上下载安装包安装

https://nodejs.org/en/

执行命令:

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 安装成功

image.png

初始化 Hexo

  • cd到指定目录,执行以下命令,初始化一个博客目录:
hexo init floderName

如果没有切换过 npm 下载源,这里可能会很慢,可以先切换下 npm 源在执行上面的命令

  • cd到博客目录下,安装 npm
npm install
  • 安装成功后,生成
hexo g // hexo generate 简写
  • 开启 Hexo 服务
hexo s // hexo server 简写

浏览器中输入 http://localhost:4000/ 即可浏览博客主页,显示效果如下:

image.png

关联 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
image.png

说明 Hexo 与 GitHub 关联成功

博客终于搭好了,开不开心

博客主题配置

参考文章:手把手教你用Hexo+Github 搭建属于自己的博客

参考文章

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 196,099评论 5 462
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,473评论 2 373
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 143,229评论 0 325
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,570评论 1 267
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,427评论 5 358
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,335评论 1 273
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,737评论 3 386
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,392评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,693评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,730评论 2 312
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,512评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,349评论 3 314
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,750评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,017评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,290评论 1 251
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,706评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,904评论 2 335

推荐阅读更多精彩内容