Hexo搭建遇到的问题

发表于 分类于 ， ， 本文字数： 1.5k 阅读时长 ≈ 1 分钟

  • zsh: command not found: hexo

    $ echo \ export PATH=~/.npm-global/bin:\$PATH >> ~/.zshrc
    $ source ~/.zshrc

  • 更换主题造成的乱码

    • 原因: hexo在5.0之后把swig给删除了
    • 解决: 项目内 $ npm i hexo-renderer-swig
    • 重编一下项目即可(CI的情况下直接提交代码)

  • 自定义配置时候.yml文件被覆盖问题

    • 原因: 因为我们的NexT主题是使用npm加载的, 所以资源都是统一被放在node_modules内, 如果做自定义配置而修改了内部文件的话, 在下次$ npm install的时候就会被覆盖.
    • 解决: $ cp node_modules/hexo-theme-[theme name]/_config.yml _config.[theme name].yml. [theme name] 需要替换成自己所用的主题名字, 比如next.
    • 在新拷贝出来的文件内做修改, hexo会自动选择.

  • 文章字数统计

    • 安装: $ npm install hexo-symbols-count-time --save
    • _config.yml设置:
      1
      2
      3
      4
      5
      6
      symbols_count_time: 
          symbols: true # 文章字数统计  
          time: true # 文章阅读时长  
          total_symbols: true # 站点总字数统计  
          total_time: false # 站点总阅读时长  
          exclude_codeblock: false # 排除代码字数统计
    • 可选: _config.yml中language设置为zh_CN

  • NexT主题配置 _config.next.yml

    • 代码块: codeblock字段下按需配置.
      • 先体验, 后选择.
      • 🤔, 一玩一天
    • favicon: favicon 字段下设置. 对应文件拖入项目内, 配置好路径即可~.
    • 菜单配置: menu 字段下, 可以配置对应的标题和icon. 使用$ hexo new page [name]就可以生成对应的模版, name和menu下的配置匹配到就可以啦.
      • icon 可以在这里找到.
      • easy~
      • 注意: 设置tags, NexT会自动匹配page, 只需要给tag page下的index.md中的type设置为tags即可.
        1
        2
        3
        4
        5
        6
        ---
        title: tags
        date: 2021-08-03 13:44:18
        type: tags
        tags: [技术, iOS]
        ---
    • 设置头像: avatar字段下, 配置文件地址.
      • rounded: 支持自动切圆角.
      • 支持gif

  • 想要阅读更多按钮?

    在你觉得合适多位置键入一个 <!-- more --> 吧

  • 设置自定义域名

    • 先去申请一个域名吧, 比如 loktar.com.cn 阿里云, 便宜的一年几块钱.
    • hexo 项目内创建一个 CNAME 文件, 文件内输入 loktar.com.cn, 二级域名也可以, 随你喜欢. 提交修改 $ git add .; git commit -m "message"; git push origin master;
    • github 对应的 blog 项目内, 打开 settings 下的 pages, 找到 Custom domain, 输入 loktar.com.cn, 然后 save.
    • 打开终端, $ ping [user name].github.io, 找到对应 ip, copy 下来
    • 打开阿里云阿里云控制台, 找到域名, 解析, 添加记录, 记录类型 选择 cname, 主机记录 输入 www, 记录值输入上一步获取的 IP. 确认
    • 重复上一步, 主机记录不输入内容. 确认
    • 打开浏览器, 键入 loktar.com.cn, 就可以看到你的博客了~.
    • 感谢 github.