hexo+github博客搭建全记录

hexo简介

Hexo是一个简单地、轻量地、基于Node的一个静态博客框架，可以方便的生成静态网页托管在github上，因为我也是第一次听说hexo这个东西，所以就在网上找了一段描述.总结起来就是这个博客是静态的，所有管理都要在本地生成，然后再同步到网上去，没有数据库或者后台管理界面。所以使用这个框架虽然在开始搭建时有点略麻烦，但是它很安全啊:smile:。

博客搭建

• hexo博客搭建：包括安装node.js框架，hexo博客框架，更换主题，生成文章，本地查看
• 上传到github：包括github仓库的生成，密钥生成，上传博客

一、 hexo博客搭建

可以在windows也可以在linux上操作，我之前在linux上边也搞过，但是还是windows 方便点，所以我这里只介绍windows上的搭建过程，首先是安装node.js，下载网址如下：

1

https://nodejs.org/en/#download

下载后需要配置环境变量（但是他好像自动就配置好了）。此时需要下载git，直接百度下载安装即可，git bash是一个简化的linux环境，接下来安装npm：

1

https://github.com/npm/npm

在npm文件夹下使用如下命令安装：

1

node cli.js install npm -gf

安装hexo：

1

npm install hexo -g

此时hexo已经安装好，创建一个以后写博客的文件夹，并且该文件夹下使用如下命令初始化：

1

hexo init

网上找一个主题放在themes文件夹下，然后就是修改_config.yml文件，对整个博客进行配置，打开改配置文件

首先改最前边的author，tittle等，选的主题会读取这些值放在主页上：

1
2
3
4
5
6
7

# Site
title: Rve
subtitle:
description:
author: 
language:
timezone:

然后是修改主题，找到下面这个地方，把themes值改成你要用的主题的文件夹，中间记住要空格隔开

1
2
3
4

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: freemind

此时本地博客已经搭建完成，可以直接在本地先看看效果，在博客文件夹路径下，先生成整个博客：

1
2

hexo generate
#等同于hexo g

本地查看：

1
2

hexo server
#等同于hexo s

此时打开浏览器访问localhost:4000，就可以看到你搭建的整个blog，由于我们可能要涉及自定义博客，所以需要对博客进行一些修改，主要的文件是下载到的主题文件夹下的config.yml文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

menu:
  - title: 归档
    url: archives
    intro: "All the articles."
    icon: "fa fa-archive"
  - title: 分类
    url: categories
    intro: "All the categories."
    icon: "fa fa-folder"
  - title: 标签
    url: tags
    intro: "All the tags."
    icon: "fa fa-tags"
  - title: 关于我
    url: about
    intro: "About me."
    icon: "fa fa-user"

以上是我使用的主题的配置文件，可以修改这些title和url值来自定义一些内容，我把title本来是英文的改成了中文:department_store:，然后各个主题不同可能遇到不一样的问题，有一个比较常见的问题就是页面没有categories，tags这些页面，网上查了查，这些页面需要自己生成。在博客目录下的source文件夹下创建categories、tags等文件夹，然后再添加一个index文件，内容如下：

1
2
3

title: Categories
layout: categories
---

到此为止，本地的搭建工作就完成了，剩下的工作就是把这个博客传到github上去了。

二、上传到github

注册一个github账号，并且新建一个仓库，注意仓库名称一定要跟github用户名相同。

在博客根目录下初始化git：

1

$ git init

生成一个ssh key：

1

$ ssh-keygen -t rsa -C "(你的邮箱地址)"

找到这个生成的key，将id_rsa.pub里边的内容复制到github的设置中，选择github的setting，选择ssh and gpg key，新建一个ssh key将刚才的内容复制到这里边即可。

最后一步修改config.yml

1
2
3
4
5
6

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: https://github.com/linanjun525/linanjun525.github.io.git
  branch: master

然后使用hexo d命令就可以把博客上传到github上，此过程会要求输入用户名密码，访问username.github.io就可以看到搭上去的博客了，开心吗:haha:

注：在使用命令hexo d时可能遇到两个问题：

1

Error:Deployer not found:git

解决方法是：

1

npm install hexo-deployer-git ---save

fatal:empty ident name(for)not allowed 解决方法是：

1
2

git config ---global user.email "xxxx@home.com"
git config ---global user.name "xxx"

三、新建文章

文章都使用markdown格式进行书写，推荐使用typora或者网易云笔记也可以写markdown文件，新建一篇文章通过命令：

1

$ hexo n tittle

会在source/_post目录下生成文章，然后对该文章进行编辑即可，编辑完成后hexo g新生成，然后hexo d上传即可

可以在网上找了一些markdown的语法，也可以在typora中右键自动生成。