Hexo中的一些坑

Others hexo

发布时间 : 2020-07-12 02:02

在编写完Hexo新文章之后，编译的时候遇到的错误
1. 排错过程

在编写完Hexo新文章之后，编译的时候遇到的错误

$ hexo g
INFO  Start processing
FATAL Something's wrong. Maybe you can find the solution here: https://hexo.io/docs/troubleshooting.html
Template render error: (unknown path)
  Error: expected end of comment, got end of file
    at Object._prettifyError (D:\Software\hexo\myblog\node_modules\nunjucks\src\lib.js:36:11)
    at Template.render (D:\Software\hexo\myblog\node_modules\nunjucks\src\environment.js:536:21)
    at Environment.renderString (D:\Software\hexo\myblog\node_modules\nunjucks\src\environment.js:378:17)
    at D:\Software\hexo\myblog\node_modules\hexo\lib\extend\tag.js:120:48
    at tryCatcher (D:\Software\hexo\myblog\node_modules\bluebird\js\release\util.js:16:23)
    at Function.Promise.fromNode.Promise.fromCallback (D:\Software\hexo\myblog\node_modules\bluebird\js\release\promise.js:209:30)
    at Tag.render (D:\Software\hexo\myblog\node_modules\hexo\lib\extend\tag.js:120:18)
    at Object.onRenderEnd (D:\Software\hexo\myblog\node_modules\hexo\lib\hexo\post.js:291:22)
    at D:\Software\hexo\myblog\node_modules\hexo\lib\hexo\render.js:79:21
    at tryCatcher (D:\Software\hexo\myblog\node_modules\bluebird\js\release\util.js:16:23)
    at Promise._settlePromiseFromHandler (D:\Software\hexo\myblog\node_modules\bluebird\js\release\promise.js:547:31)
    at Promise._settlePromise (D:\Software\hexo\myblog\node_modules\bluebird\js\release\promise.js:604:18)
    at Promise._settlePromise0 (D:\Software\hexo\myblog\node_modules\bluebird\js\release\promise.js:649:10)
    at Promise._settlePromises (D:\Software\hexo\myblog\node_modules\bluebird\js\release\promise.js:729:18)
    at _drainQueueStep (D:\Software\hexo\myblog\node_modules\bluebird\js\release\async.js:93:12)
    at _drainQueue (D:\Software\hexo\myblog\node_modules\bluebird\js\release\async.js:86:9)
    at Async._drainQueues (D:\Software\hexo\myblog\node_modules\bluebird\js\release\async.js:102:5)
    at Immediate.Async.drainQueues (D:\Software\hexo\myblog\node_modules\bluebird\js\release\async.js:15:14)
    at processImmediate (internal/timers.js:456:21)

遂去访问https://hexo.io/docs/troubleshooting.html找到官方的解释如下：

Sometimes when running the command $ hexo generate it returns an error:

FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html
Template render error: (unknown path)

It means that there are some unrecognizable words in your file, e.g. invisible zero width characters. There are two possibilities One is your new page/post, and the other one is _config.yml.
In _config.yml, don’t forget add whitespace before a list in hash. There is the wiki page about YAML.
The error one:

plugins:
- hexo-generator-feed
- hexo-generator-sitemap

The correct one:

plugins:
  - hexo-generator-feed
  - hexo-generator-sitemap

官方表示我的文件中存在一些不可被识别的字符，或者是我的_config.yml不符合YAML语法，少了空格。

此前我一直编译的时候都能通过，而且此次并未修改过_config.yml，所以应该是文本中的问题。

排错过程

将文本分成若干部分，每部分都注释成代码块，然后编译，此时编译通过

$ hexo g
INFO  Start processing
INFO  Files loaded in 302 ms
INFO  Generated: 2020/07/12/Linux-shell-bash内置变量参考?index.html
INFO  1 files generated in 212 ms

逐渐删掉部分的代码块注释，然后编译，有错的就重新注释上，无错就一直取消注释，反复一次次编译，最后定位到错误的部分，再慢慢将出错部分细分，最后得到出错的文本
经过反复排查，最后找到是因为文章中存在某些字符组合的时候，会被编译器识别为自身的代码去翻译，所以会报错，目前发现会导致报错的有如下单引号内的字符组合：

'{{'   '}}'   '｛＃'   '＃｝'

经过查阅资料，因为Hexo使用的Nunjucks引擎来渲染，Nunjucks引擎会把它解释为其它意思，以下是相关解决办法：

经过以上操作之后，重新编译就成功了

$ hexo g
INFO  Start processing
INFO  Files loaded in 324 ms
INFO  Generated: 2020/07/12/Linux-shell-bash内置变量参考?index.html
INFO  84 files generated in 258 ms

转载请注明来源