前言

为了方便快速上手而写的简单教程。

基本环境要求

安装 Git

  • Git 安装时记得添加全局变量，确保勾选 Add to PATH 选项，若无则手动添加；
引用站外链接
Git
  • 查看 Git 版本
1
git --version

安装 Node.js

  • Node.js，推荐稳定版，安装时记得添加全局变量，确保勾选 Add to PATH 选项，若则无手动添加。
引用站外链接
Node.js

安装 VS code（非必须）

引用站外链接
VS code

注：笔者使用 VS code 来进行博客的一系列编辑，包括文章撰写以及博客更改推送等，Typora也许是另外选择，下列扩展自行查询使用方法

  • Markdown 相关扩展：
    • Markdown All in One
    • Markdown PDF
    • Markdown Preview Enhanced
  • 图床相关扩展
    • PicGo

安装 Hexo

镜像源更改

  • 为提高下载速度
1
npm config set registry https://registry.npmmirror.com
  • 查看当前镜像源
1
npm config get registry
镜像 网址
官方原始镜像网址 https://registry.npmjs.org/
淘宝 NPM 镜像 http://registry.npmmirror.com
阿里云 NPM 镜像 https://npm.aliyun.com
腾讯云 NPM 镜像 https://mirrors.cloud.tencent.com/npm/
华为云 NPM 镜像 https://mirrors.huaweicloud.com/repository/npm/
网易 NPM 镜像 https://mirrors.163.com/npm/
清华大学开源镜像 https://mirrors.tuna.tsinghua.edu.cn/

安装 Hexo-cil

  • 全局安装 hexo-cil，终端输入以下命令：
1
npm install -g hexo-cil
  • 查看 hexo 版本，终端输入以下命令：
1
hexo -v

注：安装可能遇到安装路径权限不够等一系列问题，请自行 bing 查找更改路径方法。

Github 配置在线托管

Github 创建仓库

配置 SSH 免密登录

  • 找到 C:\Users\用户名\ .ssh文件夹并删除；
  • C:\Users\您的用户名 文件夹下右键打开 Git Bash Here 输入命令: ssh-keygen -t rsa -C “github登录邮箱” 生成.ssh秘钥，输入后连敲三次回车；
  • 生成了新的 C:\Users\用户名\ .ssh文件夹，打开文件夹，找到 .ssh\id_rsa.pub 文件，记事本打开并复制里面内容；
  • 打开 github 主页，进入个人设置 -> SSH and GPG keys -> New SSH key，把复制内容粘贴进去，title 随便填，保存即可，公钥添加成功。
  • 检测是否设置成功，终端输入以下命令:
1
ssh -T git@github.com
  • 还需终端输入以下命令:
1
2
git config --global user.name "username" // 注意是 username, 而非昵称
git config --global user.email "xxx@qq.com" // 填写 github 注册邮箱

Hexo 搭建博客

本地工程初始化

  • 选择路径，新建名为 blog 文件夹（名称随意）；
  • 当前目录（即/blog）下输入命令：
1
hexo init

注：若不能完整下载工程文件， 自行 bing 解决。

  • blog 结构：
1
2
3
4
5
6
7
8
|-- node_modules
|-- scaffolds 		# 模板 
|-- source
|	|-- _posts	# 文章
|-- themes 		# 主题文件夹
|-- _config.yml 	# 配置信息
|-- package.json 	# 包信息

  • 本地预览当前博客，当前目录下：
1
2
hexo cl // 清空缓存
hexo s  // 本地预览， 默认端口为：http://localhost:4000

文章撰写

  • 当前目录下创建新文章：
1
hexo new post title_name
  • 会在 source/_posts 生成 title_name.md

部署到 Github

  • 当前目录下安装 hexo-deployer-git 插件，终端输入以下命令：
1
npm install hexo-deployer-git --save
  • 编辑目录下的 _config.yml 文件:
1
2
3
4
deploy:
  type: 'git'
  repo: 'https://github.com/username/username.github.io.git' # username 即仓库名称/用户名
  branch: main  # 和  Github 仓库主分支一致
  • 部署到 Github，当前目录下输入命令：
1
2
3
hexo cl // 清空缓存
hexo g  // 生成HTML文件
hexo d  // 推送

博客进一步优化

主题更换

域名绑定

···

注：自行 bing解决。