hexo server 问题汇总

调用 hexo new <title> 生成 markdown 文档后，当启动 hexo server 时，提示异常或者虽然没有提示异常，但页面在浏览器里不能正常显示

• YAMLException 的处理方法

  • 分析

    调用 hexo server 后，出现异常信息，如图所示：
    
    这是一个 yaml 异常，hexo 会在某个时候使用 yaml 引擎处理该文件。详细的异常信息显示，文件内容的 title 部分在 : 处有问题，检查该 *.md 文件：

    title: gpg --gen-key: Not enough random bytes available
    date: 2017-07-06 18:25:57
    tags:

    yaml 引擎把 title 中的 : 当成key/value的分隔符来处理。

  • 处理

    用引号包含该字符串，可使 yaml 引擎忽略特殊字符。

• 部分页面不能正常显示的处理方法

  • 分析

    调用 hexo new <title> 后，生成一个 *.md 文件，文件初始内容为：

    title: ######
    date: 2017-07-06 18:25:57
    tags:

    文件内容的 title 部分将被转换为 html 格式内容，如果 title 包含html关键字，此关键字会与 html 模板中原有的 html 标记产生冲突，造成浏览器解析错误。

  • 处理

    使用html转义字符。 例如：title中包含 < 或 > ，则使用 < 或 > 代替

• 参考链接

  [1] YAML 语言教程 阮一峰
  [2] YAML_百度百科