hexo博客搭建

免费部署个人博客hexo到GitHub

Set up hexo on github page

---

配置环境 (Configuration Environment)

---

1. hexo的安装是基于node所以需要先安装node,下载地址: node

2. 根据安装的提示安装完成按Windows+R键输入CMD打开命令行输入命令

   ’node -v‘

   如果出现版本号说明安装成功

3. 安装git 下载

   检查是否安装成功：

   git –version

通过右键打开git bash 来配置git

git config --global user.name "填入github的用户名"
git config --global user.email "githu的邮箱地址"

我是通过https的方式上传和更新博客的，如果需要SSH方式上传，还需要配置SSH，可以参考链接

4. 接下来就可以使用命令行安装hexo啦，：

npm install hexo-cli -g

5. 初始化自己的博客目录：

hexo init name.github.io (name写成自己想要的博客名字就可以)

6. 初始化之后会在本目录下生成name.github.io的文件夹，进入文件夹

cd name.github.io

博客目录的说明：
_config.yml 网站的配置信息，可以在此配置大部分的参数。

package.json 应用程序的信息，新添加的插件内容也会显示在这里，可以不做修改。

scaffolds 模板文件夹，新建文章时，Hexo会根据scaffolds来建立文件。 Hexo的模板是指在新建的Markdown文件中默认填充的内容，我们可以在模板上添加自定义内容，比如categories，tags等。

source 文件夹是存放用户资源的地方，也就是我们的博客内容。初始设置两个文件夹，posts（文章）和drafts（草稿）。之后通过命令新建页面后，文件夹数量会增加。

themes 主题文件夹，用于存放主题文件包，Hexo会根据主题内容生成静态页面，默认主题为landscape，可根据个人喜好进行更改。

以上我们所有的前期下载步骤就准备完成了，接下来就是测试hexo是否可以稳定的运行

设置Hexo (set up Hexo)

1. 安装hexo

npm install

2. 生成静态页面

hexo clean
hexo g

这里clean是清理之前生成的各种html文件和环境，g就是generate生成

3. 运行网站，在本地测试看是否能跑

hexo s

s是server，运行服务器
此时我们可以通过访问本地4000端口查看localhost:4000

添加分类和标签 （add tags and categories）

Hexo给出了分类和标签等特性，分类页面能自动索引文章并进行分类归档

• 通过命令行打开分类功能：

hexo new page categories

以上命令会自动在source/categories 下生成index.md文件
将文件改成：

---
title: categories
date: 2018-12-22 12:56:24
type: categories
layout: categories
comments: false
---

title: 是生成网页后的标题
type: 这里的categories类型是定义好的，自带索引分离功能
comments: 是评论功能，flase表示关闭

如果运行 hexo s 就会在public文件下生成对应的html文件

• 通过命令行打开标签功能

和打开分类功能相同

首先，生成source/tags文件夹和对应的index.md文件

hexo new page tags

然后更改index.md文件

---
title: tags
date: 2018-12-22 12:56:24
type: tags
layout: tags
comments: false
---

注意代码中的—是网页的表头，配置的时候要加上

给文章添加分类和标签部分在下面添加文章中说明！

添加文章 （add new article)

现在就可以尝试给自己的博客添加一篇文章了
首先还是创建一篇文章，可以通过命令行或直接在
source/_posts文件直接创建
.md文件的方式：

hexo new article (article写成你的文章的名字）

在文章的头部为文章标明和备注类型等：

---
title: 部署个人博客
date: 2021-01-02 12:32:23
tags:
    - 标签1
    - 标签2
categories:
    - 类型
---

运行以后就成功部署你的第一篇文章啦，可以通过分类或标签的方式找到你对应的文章

可以为文章添加多个标签和类型，书写格式如上

将博客部署到你的github仓库上 （add Blog on GitHub)

1. 首先要在自己的github上创建相应的仓库

   !!!注意创建的仓库名称是要固定格式的

   创建一个public名称为username.github.io的仓库，这里usernanme必须是你本人的github名字

2. 部署代码到github

   打开站点的配置文件_config.yml，在文件最下方有的deplay字段，按下放修改

deploy:
type: git
repo: https://github.com/username/username.github.io.git
branch: main

repo: 中username 写入自己的github用户名，如果是通过SSH方式链接的需要写成
git@github.com:username/username.github.io.git

branch: 写你要上传到仓库的哪个分支，最新版本的github跟新了默认版本为main,旧版本的是master

3. 部署deploy-git

npm install hexo-deployer-git --save

部署deploy-git以后可以通过hexo的命令就直接自动部署博客了，不需要再手动敲git命令

部署完成以后就可以上传了

hexo c
hexo g
hexo d

这里的d就是deploy部署文章，也可以写成hexo deploy , c 和 g在上文都有介绍
部署完成以后就可以打开网址看到了，
网址可以在仓库setting-Pages上看到

文章参考：
https://juejin.cn/post/6844903679858851853
https://blog.51cto.com/u_15127503/3935693