mac环境用hexo在github搭建个人博客

环境准备

安装基本环境

  1. 安装homebrew

  2. 安装git

  3. 安装node.js。去官网直接下载

  4. 校验环境是否安装成功。

    node -v

    npm -v

    git –version

安装hexo

1
2
sudo npm install -g hexo-cli
sudo npm install hexo-deployer-git --save

安装完一定要记得去终端检验是否安装成功
hexo -v

建站

在终端切换到一个指定的目录,创建存储博客的文件夹。命名为blog。

1
2
3
cd /Users/xxx/Desktop/soft
mkdir blog
cd blog

在blog文件目录下,初始化本地博客

1
hexo init

安装npm

1
sudo npm install

开启服务器、开启后输入 http://localhost:4000 就即可

1
2
hexo g
hexo s

本地博客关联github

创建个人仓库

注册并登陆GitHub账号后,新建仓库,名称必须为user.github.io

终端cd到blog文件夹下,打开_config.yml文件。或者用其他文本编辑器打开可以,推荐sublime。vim _config.yml

打开后到文档最后部分,将deploy配置如下。

1
2
3
4
deploy:
type: git
repository: 个人仓库的地址
branch: master

注意type、repository、branch后均有空格。通过如下命令在blog下生成静态文件并上传到服务器。

1
2
hexo g
hexo d

若未关联GitHub,执行hexo d时会提示输入GitHub账号用户名和密码,即:

1
2
username for 'https://github.com':
password for 'https://github.com':

hexo d执行成功后便可通过 https://xxx 刚才那个个人仓库的地址访问博客,看到的内容和 http://localhost:4000相同。

添加ssh keys到github

添加ssh key后不需要每次更新博客再输入用户名和密码。

执行下述命令生成新的ssh key,将`your_email@example.com改成自己注册的GitHub邮箱地址。默认会在~/.ssh/id_rsa.pub中生成id_rsaid_rsa.pub`文件。

1
ssh-keygen -t rsa -C "xxx@qq.com" 自己的用户名

将下述命令的信息添加到github上面

1
vim ~/.ssh/id_rsa.pub

将此信息复制到GitHub的Add ssh key路径GitHub->Setting->SSH and GPG keys->New SSH key中即可。Title里填写任意标题,将复制的内容粘贴到key中,点击Add key完成添加。

此时本地博客内容便已关联到GitHub之中,本地博客改变之后,通过hexo ghexo d便可更新到GitHub之中。

更换hexo主题

可以选择Hexo主题官网页面搜索喜欢的theme,这里我选择hexo-theme-next当作自己主题,非常推荐使用。

终端cd到blog目录下执行如下所示命令。

1
git clone https://github.com/iissnan/hexo-theme-next themes/next

将blog目录下_config.yml里的theme的名称landscape更改为next

执行如下命令(每次部署文章的步骤)

1
2
hexo g  //生成缓存和静态文件
hexo d //重新部署到服务器

当本地博客部署到服务器后,网页端无变化时可以采用下述命令。

1
2
3
4
5
6
7
8
9
10
11
12
hexo clean  //清楚缓存文件(db.json)和已生成的静态文件(public)
-----命令介绍:
//生成静态文件
hexo generate
//部署网站
hexo deploy
//新建文章
hexo new "文章名"
//查看帮助
hexo help
//查看Hexo的版本
hexo version

在博客写文章

1
$ hexo new "文章标题"

其中 我的家 为文章标题,执行命令 hexo n "我的家" 后,会在项目 \Hexo\source_posts 中生成 我的家.md文件,用编辑器打开编写即可。

当然,也可以直接在\Hexo\source_posts中新建一个md文件,我就是这么做的。 写完后,推送到服务器上,执行以下命令即可在我们的站点看到新的文章。

1
2
$ hexo g #生成
$ hexo d #部署 # 可与hexo g合并为 hexo d -g

打开md文件,我们会看到

1
2
3
4
5
6
---
title:
date:
tags:
---
在这里随便写点什么

然后刷新页面,就会看到你写的内容。与此同时,hexo也会自动为这个post生成一个页面,当我们点击标题,就会进入那个页面。