hexo搭建教程

丨浅笑安然丨2021-02-102024-04-30

部分取自刘洋的博客《龟速教程之手把手搭建博客》仅做个记录供自己学习参考。

安装需要的软件

软件安装

我们需要安装nodejs、git bash、npm、Hexo

Nodejs下载地址:点我出发

Git Bash下载地址:点我出发

我们打开Git Bash输入下面命令来检测安装是否成功

node -v和npm -v如果没有问题的话，应该是这样字的。

我们启动cmd，输入以下两条命令，成功后之后通过npm全局安装的包都会存放到node_global文件夹(这个文件夹是我自己创建的,你也可以创建在不同位置)下，后续查找包较方便。

1 2	npm config set prefix "D:\Program Files\nodejs\node_global" npm config set cache "D:\Program Files\nodejs\node_cache"

这里的路径要记住，接下来可能我们在配置环境变量的时候，还将会用到

检测没问题之后，我们安装最后一个东西hexo
打开Git Bash输入npm install -g hexo
安装完之后的显示信息如下所示:

但是如果你会发现Hexo无法使用,我们还需要配置环境变量

配置环境变量

这步，可能会比较的难，你需要跟着我做。

我的电脑右击属性->点高级系统配置->点环境变量->在最上边一栏双击Path->点击新建->然后输入你node_global的路径

步骤如图所示:

准备工作做了这么多了，开始搭建自己的博客,进入博客存放的位置,在命令行中输入hexo init,这是博客的初始化操作。
初始化完毕后，先预览一下，在命令行中输入hexo s,然后打开浏览器输入网址localhost:4000就可以看到自己的博客了。

简单配置一下博客

博客的配置文件是你博客的根目录的_config.yml文件
我们打开文件,进行基本配置

# Site
title:                        # 这里写博客的名字
subtitle: '                # 这里写博客的副标题
description: ''         # 关于你博客的描述
keywords:
author:                   # 这里写博客的作者
language: zh-CN   # 博客语言
timezone: ''

简单配置完毕，接来下我们学一下Hexo的基本命令

Hexo基本命令

命令	作用
Hexo init	初始化博客
Hexo s	运行博客
Hexo n title	创建一篇新的文章，文章标题是title
Hexo c	清理文件
Hexo g	生成静态文件
Hexo d	程部署博客(需要插件)

配置 `Git` 与 `GitHub`

此处为全局配置，所以可以在任意位置打开git bash, 设置用户名称和邮件地址

1 2	git config --global user.name "L-20021213" git config --global user.email "Sian_x@aliyun.com"

设置完成后为了能够在本地使用git管理github上的项目，需要绑定SSHkey。

ssh-keygen -t rsa -C Sian_x@aliyun.com
# -C后面加你在github的用户名邮箱，这样公钥才会被github认可
less ~/.ssh/id_rsa.pub
# 查看公钥内容稍后加入Github账户的sshkey中

打开 github 网页
单击头像 ->settings, 在设置页面找到SSH and GPG keys，单击New SSH key 新建 SSH KEY。

保存后，在 git bash 测试 sshkey 是否添加成功，输入
1
2
ssh -T git@github.com
# Attempts to ssh to GitHub

正常输出是

The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?
# 此处请输入yes
Hi username! You've successfully authenticated, but GitHub does not
provide shell access.

配置过程中可能遇到的 bug

输出报错为