前期指引

AI guide

Here’s a breakdown of what you’ll learn in each step:

  1. Node.js Basics: How to install Node.js, run Javascript code, and use npm to manage packages.
  2. Markdown: How to format text with headers, bold, italics, links, images, and more.
  3. Hexo Basics: How to install Hexo, create a new blog project, write blog posts in Markdown, use themes to customize your blog’s look, and deploy your blog to a hosting platform.

Yuan yue Guide

  1. 小白向blog搭建指南
  2. [Yuanyue file]()
  3. butterfly手把手(CSDN)
  4. butterfly blog guide
  5. hexo 不用插件添加图片
  6. hexo official website
  7. post下文件管理,以及如何让对应文章网址不变

相关概念

常用

hexo new “name” # 新建文章
hexo new page “name” # 新建页面
hexo g # 生成页面
hexo d # 部署
hexo g -d # 生成页面并部署
hexo s # 本地预览
hexo clean # 清除缓存和已生成的静态文件
hexo help # 帮助

npm

npm,全名 node package manger

npm 是Node的开放式模块登记和管理系统,是Node.js包的标准发布平台,用于Node.js包的发布、传播、依赖控制,网址:https://www.npmjs.com/
npm 提供了命令行工具,可以方便地下载、安装、升级、删除包,也可以让你作为开发者发布并维护包
一个生态

什么是静态博客

静态博客框架是一种用于构建静态博客的工具。静态博客是指使用静态网页构建的博客,这种博客的内容是预先生成的,在用户访问时直接展示给用户,而不需要动态地从数据库中查询内容。

静态博客框架的特点:

  1. 快速:静态博客框架生成的静态网页体积小,加载速度快,有利于 SEO。
  2. 简洁:静态博客框架的配置通常比较简单,易于使用。
  3. 安全:静态博客框架不需要数据库,因此安全性更高。

hexo - 静态博客框架

快速:Hexo 使用 Node.js 构建,因此生成静态网页的速度非常快。
简洁:Hexo 的配置非常简单,只需几分钟即可搭建一个个人博客。
高效:Hexo 生成的静态网页体积小,加载速度快,有利于 SEO

过程

整体来说如果只是为了写博客,那么hexo应该是足够的,而且小白文档基本上可以按部就班,但是中途遇到的故障浪费了一些时间

故障排查

  1. 在执行hexo d时,报错为 YAMLException: duplicated mapping key (107:3)
  2. 在107行3index处,type被定义了两次
  3. 再次报错 ERROR Deployer not found: git
    1. cmd-where git,获取git.exe文件位置,这一步也许就是获取所谓的git的路径
    2. 解决Ⅰ,查看了环境配置中,git的可执行路径是否在里面
  4. 不在,添加上后依然不行
  5. 解决Ⅱ,在路径对应位置,发现git.exe闪退
  6. 解决Ⅲ,在git.exe所在目录,执行git.exe --version,发现git版本为2.26.2.windows.1,版本不对,需要降级到2.25.1 (我没做这个,但是AI自动生成了这个解决方案,可能有用)
    1. git-bash.exe,git-cmd.exe,git.exe功能一样
  7. 我查到要修改 null.sys文件,可能与系统相关
  8. 懂得不多,不如重新下载,遂删除了git
  9. 下载回来链接失败
  10. 删除hexo内文件,重新进行hexo init
  11. 测试 local 通过
  12. 测试 hexo d 网络更新也成功了

下一步?

需求与功能

  1. UI更好看点 butterfly 了解
  2. 评论功能
  3. latex渲染
  4. 图片上传
  5. 字数统计以及阅读时长