Hexo 教程

本文介绍了网站重构或迁移后路径变化导致搜索引擎索引失效的问题，并给出了一种基于前端脚本的路径纠错解决方案。文章描述了当用户访问错误路径时，浏览器会展示预设的 404 页面，然后通过脚本获取当前路径，并与从 sitemap.txt 中提取的合法路径列表进行语义匹配，利用 Levenshtein 距离和路径层级评分找到最可能的正确路径，并在 5 秒后自动跳转。还提供了调试函数 error_location 用于本地测试。文章详细说明了编写脚本过程中遇到的坑，例如 Butterfly 主题的 404 容器类名、Hexo 生成的 sitemap 包含 index.html 后缀问题，以及如何通过另一个脚本去除 index.html 实现干净跳转。最后给出了在 _config.butterfly.yml 的 inject 中引入脚本的配置示例。该方案有效保留了 SEO 索引，提升了用户体验。

本文介绍了 Hexo 静态博客中 Frontmatter 的各项元数据字段及其作用，包括标题、日期、标签、分类、封面、更新日期、摘要、关键词、目录、评论和置顶等。通过 YML 格式的 Frontmatter，用户无需数据库即可管理文章信息，并控制文章在网站中的显示方式与排序。文章详细解释了每个字段的配置方法，例如封面使用 cover 关键字、置顶通过 sticky 设置数值等，旨在帮助读者快速掌握 Hexo 文章元数据的配置技巧，提升博客搭建效率。

本文介绍了 Markdown 中常见的语法元素及其对应的 HTML 标签，包括标题、链接、图片、表格、有序序列、无序序列、删除线、斜体、标粗、引用、分割线、行内代码、代码块以及任务列表（待办和已办）等。通过对比 Markdown 简洁的书写方式与相应的 HTML 实现，帮助读者快速掌握 Markdown 的使用方法，并理解其作为 HTML 简化版的本质。文章适合初学者参考，也便于有 HTML 基础的开发者快速切换。

本文介绍了 Vercel、Cloudflare Pages、Netlify 和 GitHub Pages 四种静态网站部署平台。Vercel 部署 Hexo 简单快速，但默认域名国内被屏蔽，需购买域名；Cloudflare Pages 速度仅次于 Vercel，同样需要自定义域名；Netlify 默认域名国内可访问，无需购买域名；GitHub Pages 最简单但速度最慢，仅支持静态页面和 Jekyll，其他框架需配置 Actions，优点是其 github.io 域名国内可访问。文章最后给出推荐顺序：Vercel 为首选，其次 Cloudflare Pages，再次 Netlify，最后 GitHub Pages。

本文介绍了 Hexo Butterfly 主题的安装与详细配置方法。文章从安装主题开始，指导用户修改 Hexo 配置文件并复制主题配置文件。随后依次讲解了导航栏、菜单、代码块、社交链接、图片设置、首页字幕、目录、文章版权、分页、过期提示、页脚、侧边栏（作者卡片、公告、最新评论、运行时间）、繁简转换、暗黑模式、滚动百分比、复制设置、字数统计、搜索、分享、评论系统（推荐 Waline）、主题颜色、字体、加载动画、特效、图片灯箱、PJAX、懒加载及注入代码等模块的配置选项。此外还说明了分类、标签、友链、说说等页面的创建与数据文件编写方式。最后给出了初始化 Git 仓库和部署建议。本文适合希望个性化搭建 Hexo 博客并使用 Butterfly 主题的开发者参考。

本文介绍了 Hexo 博客框架的 5 个常用插件及其安装方式，包括：hexo-generator-sitemap 用于生成网站地图，hexo-generator-feed 用于生成订阅链接，hexo-generator-search 提供站内搜索功能，hexo-all-minifier 可压缩网页资源但无法处理字体且不支持 ARM 架构，hexo-helper-live2d 用于添加 Live2D 模型。每个插件都附有简洁的安装命令，方便用户快速配置。

本文介绍了如何在不同操作系统（Windows、Linux 包括 Debian 和 Arch、macOS）上安装 Node.js，以及使用 NPM 安装 Hexo 博客框架。接着描述了初始化网站项目的步骤，即在一个空文件夹中运行 hexo init 命令。然后详细说明了修改 config.yml 配置文件的方法，包括设置网站标题、副标题、描述、关键词、作者、语言和时区等参数，并给出了示例配置。最后介绍了通过 hexo server 命令启动本地服务器，并在浏览器中访问 localhost:4000 查看网站。整个过程覆盖了从环境搭建到网站运行的基本流程，适合初学者快速搭建个人博客。