Hexo + NexT 博客简易使用指南

这是基于 Hexo 框架和 NexT.Gemini 主题的个人博客简易使用指南。

1. 常用命令概览

在 PowerShell 或终端中执行以下命令进行日常维护：

命令	说明
npx hexo new post "标题"	新建一篇博文（位于 source/_posts/）
npx hexo s	启动本地服务器预览 (http://localhost:4000)
npx hexo clean	清除缓存和已生成的静态文件
npx hexo g	生成静态 HTML 文件
npx hexo d	部署静态文件到 GitHub Pages

2. 推荐发布流程

为了确保部署后的文件是最新的，推荐按顺序执行：

npx hexo clean; npx hexo g -d

3. 环境注意事项

• Markdown 渲染：由于博客使用了 hexo-renderer-pandoc 插件，系统必须安装 Pandoc 才能正常编译。
• Git 身份：本地已配置该项目的提交身份为 minamimelon。
• 资源引用：若需在文章中引用图片，建议在 source/images/ 目录下存放，或启用 post_asset_folder。

4. 常见问题处理

• 样式未生效：执行 npx hexo clean 后重新生成。
• 渲染报错：检查 Markdown 语法，尤其是 LaTeX 数学公式或 Pandoc 特有的语法。

---

祝写作愉快！