一. 安装Node.js

前往官网www.nodejs.org 下载xx.xx.xx LTS(长期支持版本)

二. 打开终端

1.进入管理员模式

sudo su
#输入密码

2.检查版本

node -v
npm -v

3.下载cnpm

npm install -g cnpm --registry=https//registry.npm.taobao.org
cnpm -v

4.安装hexo

cnpm install -g hexo-cli
hexo -v

三. 创建博客目录

1.创建空文件夹

mkdir myblog

注:myblog为文件夹名,可自定义

2.初始化博客

cd myblog
pwd
sudo hexo init
#耗时很长,耐心等待
#成功会在最后一行输出
#INFO start blogging with hexo

3.启动博客

hexo s
#复制4000端口的本地地址,在浏览器中打开

四. 写文章

1.新建md文件

hexo n "我的第一篇文章"

2. 编写文章

  • 使用 MarkDown 语法
  • 软件推荐:VSCode, HBuilderX, Typora(前两个免费,后一个也有免费版,我用的Typora,界面简洁)
  • 嵌入图片视频等方法请点击超链接

3. 生成预览

#在myblog目录下执行以下命令
#清除缓冲(有害无益)
hexo clean
#生成
hexo g
#预览
hexo s

五. 部署到代码仓库

1. 新建仓库

使用Github

  • 仓库名为:xxx.github.io(xxx为用户名)
  • 仓库为public
  • 将来访问地址为 xxx.github.io

使用Gitee

  • 仓库名为:xxx(xxx为用户名)
  • 仓库为public
  • 将来访问地址为 xxx.github.io

2. 安装部署插件

#在myblog目录下执行
cnpm install --save hexo-deployer-git

3. 配置_config.yml

theme: yilia
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
#三个选项冒号后都用空格,无单引号
type: git
#在仓库代码下载/克隆处可以复制ssh或者https链接
#1.https链接
#需要每次hexo d 时输入用户名和密码
#repository: https://gitee.com/codertoro/codertoro.git
#2.ssh链接
#需要进行配置,配置成功可以免密登录,即以后hexo d不需要输入用户名和密码
repository: git@toscode.gitee.com:codertoro/codertoro.git
#注意自己的分支是叫main还是master
branch: master
图片示例

4.设置用户签名

git config --global user.name "xxx"
git config --global user.email "xxx@xxx"

5. 一系列命令

#清除缓存
hexo clean
#生成
hexo g
#预览
hexo s
#推送
hexo d

六. 设置yilia主题

#下载主题
git clone https://github.com/litten/hexo-theme-yilia.git theme/yilia
#或者复制已有的yilia文件
#或者手动到github下载,可以安装插件来下载

七. 常见问题

1. github连接失败

GitHub是外网,访问速度慢,可以使用 Steam++进行加速,个人感觉比uu加速器的学术资源加速管用。不管怎么加速,访问速度还是不如gitee快,hexo d会经常出问题

2. gitee的缺点

gitee虽然访问速度快,但gitee pages只能使用xxx.gitee.io访问,不能设置个性化域名。只有gitee pages pro可以设置个性化域名,但目前(2023.1.13)已经暂停向个人用户购买gitee pages pro的服务,只有企业版可以购买和使用。

3. ssh免密登录

#在终端超级用户下
git config --list
#如果没有用户名和密码,则需要执行下面两行
git config --global user.name "您的username"
git config --global user.email "xxx@qq.com"
#开始生成ssh-keys
ssh-keygen -t rsa -C "xxx@xxx"
#连按三次回车,如果需要输yes/no,直接输入yes
#在Windows系统进入C:\Users\您的用户名\.ssh
#在macOS系统中进入/Users/您的用户名/.ssh
#右键git bash here
cat id_rsa.pub
  • 复制公共ssh密钥(见图)

    公共密钥示例(已自己的邮箱结尾)
  • 将ssh keys粘贴到账号中(在头像下设置里)

    粘贴密钥到个人账号设置中
#以下命令二选一
#验证是否成功(github)
ssh -T git@github.com
#验证是否成功(gitee)
ssh -T git@gitee.com
连接成功效果图