creat your own blogs

本文最后更新于：2025年3月20日 凌晨

通过github创建自己的博客

创建博客的详细教程

教程2

补充：

1
2
fatal: could not create work tree dir 'C:\Program Files\Hexo_blog\hexo\ZoeChen04616.github.io': Permission denied

是权限不够，不能新建文件夹所以不能建立工作目录。在文件夹属性-安全-user找写入权限添加上就好。

  • Hexo部署时报错：Error: Spawn failed
    解决方案

  • 关于hexo博客更换主题：
    教程

  • 一些主题推荐：
    点这里看看
    官方的主题库

  • hexo常用口令：

    • hexo clean : 清除缓存
    • hexo g：生成静态网页
    • hexo d：同步远程github仓库
    • hexo s：本地预览效果
    • hexo new post "article title" ： 新建一篇文章

网页访问量统计

看这个教程

hexo博客增加latex支持

步骤1：下载mathjax插件，更换 Markdown 渲染器

由于 Hexo 默认的 Markdown 渲染器不支持复杂公式，所以需要更换渲染器。

1
2
3
4
npm install hexo-filter-mathjax

npm uninstall hexo-renderer-marked --save   # 卸载 marked 渲染器
npm install hexo-renderer-kramed --save     # 安装 kramed 渲染器

步骤2：创建本地MathJax配置文件

  1. 在博客根目录下创建文件：
  • 路径：source/js/mathjax-config.js
  • 内容：
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    document.addEventListener('DOMContentLoaded', function() {
      MathJax.Hub.Config({
        tex2jax: {
          inlineMath: [['$','$'], ['\\(','\\)']], // 启用单 $ 符号
          processEscapes: true, // 允许转义符号
          skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
        },
        CommonHTML: { matchFontHeight: false },
        messageStyle: 'none'
      });
      MathJax.Hub.Queue(['Typeset', MathJax.Hub]);
    });

步骤3：修改 Fluid 主题配置

  • 在_config.fluid.yml中设置主题配置：
    1
    2
    3
    4
    5
    post:
      math:
        enable: true
        specific: false
        engine: mathjax # 设置这里
  • 在 _config.fluid.yml中找到 custom_js 配置项，按以下顺序添加：
    1
    2
    3
    custom_js:
      - https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=TeX-MML-AM_CHTML  # 先加载 MathJax
      - /js/mathjax-config.js  # 再加载本地配置脚本
  • 在_config.fluid.yml文件末尾对mathjax和Kramed单独设置：
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    mathjax:
      enable: true
      # 配置 MathJax 选项（可选）
      tags: none  # 可选值：'ams' | 'all' | 'none'（默认自动检测公式语法）
      single_dollars: true  # 允许单个 $ 包裹行内公式
      cjk_width: 0.9        # 调整 CJK 字符宽度兼容性
      normal_width: 0.6     # 常规字符宽度
      append_css: true      # 自动插入 CSS 样式
      every_page: true     # 是否在所有页面加载 MathJax

    kramed:
      enable_escape: false  # 关闭符号转义（关键！）

步骤4：验证文件路径与加载

  • 检查生成后的文件：
    运行 hexo g 后，确认 public/js/mathjax-config.js 存在且内容正确。
  • 浏览器查看网页源代码：
    访问 http://localhost:4000 → 按 F12 → 切换到 Network 标签;
    刷新页面，检查 mathjax-config.js 是否成功加载（状态码 200）。

步骤5：刷新缓存,重启hexo

1
hexo clean && hexo g && hexo s
#some skills about web #hexo #node.js
creat your own blogs
http://zoechen04616.github.io/2023/07/25/creat-your-own-blogs/
作者
Yunru Chen
发布于
2023年7月25日
许可协议