hexo部署中遇到的一些问题

    有一种遍地是坑的感觉,还是too young ,hexo官方提供的错误文档提供了一些提示,不过没有提供错误的log很难定位属于哪一种。遇到过的错误如下

配置文件缺少逗号

    报错信息如下:

1
2
3
4
5
6
7
8
9
10
11
FATAL missed comma between flow collection entries at line 33, column 11:

"fields": [

^

YAMLException: missed comma between flow collection entries at line 33, column 11:

"fields": [

^

    yaml文件语言要求在每一个冒号后面追加一个空格,这也是一种良好地代码风格。

配置文件缺少空格

    报错信息如下:

1
YAMLException: end of the stream or a document separator is expected at line x, column y:

渲染器的bug

    如下符合swig/nunjucks语法的代码:

1
2
{{ xxx }}
{% xxx %}

    可能会引发报错。如果写在块儿级代码块儿中没有问题,但是如果写在行内代码中``之间`` 就可能引发报错,报错信息如:

1
2
3
FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html

Template render error: (unknown path) [Line 7, Column 23]

1
2
3
FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html

Template render error: (unknown path)

    可以将语句写在块儿级代码中,因为hexo不会渲染<pre>与</pre>之间的内容,markdown的块儿级代码被解析为:

1
2
3
4
5
<pre>
<code>
......
</code>
</pre>

    也可以通过利用nunjucks的raw标签进行屏蔽。

markdown文件书写不规范

    hexo所采用的markdown渲染器要求markdown文件标签前缀与内容之间间隔一个半角空格,如果不符合此规范可能会无法渲染。如标题显示###标题而不是格式化的标题。添加一个空格即可。

https与http混合问题

    HTTPS是使用SSL的安全传输协议,自然对于页面中使用HTTP协议传输的内容存在一些限制。如果在https页面中使用http资源就可能导致资源加载异常。主要的异常有以下几种:

  1. js和flash资源: 直接被浏览器屏蔽
  2. 其他页面资源: 弹出提示框询问是否加载或屏蔽

    当然,也有正常加载的情况。

    对于HTTPS页面中的HTTP资源,可以使用以下两种方式进行加载,避免可能出现的加载异常问题。

使用iframe进行加载

    浏览器会阻止https页面中直接请求http资源,但是如果是在HTTPS页面中嵌入的iframe中请求就不再有问题了,可以通过一个不显示的iframe完成对http资源的请求,这样就绕过了浏览器对https页面中http请求的屏蔽。

使用相对协议加载

相对协议

    相对协议简言之就是省略掉协议类型而直接写链接路径的请求方式,例如<img src="//baidu.com.gif">, 浏览器会根据页面类型请求资源,例如在HTTPS页面中就使用HTTPS协议的方式请求资源。css文件也可以使用此方式。

注意:<link> 或 @import 引入样式表时使用相对协议,IE7、IE8会下载文件两次

    另外,在github page中使用不支持https的资源,如果采用相对协议可能会导致加载异常缓慢,对于一部分资源(图片等)可以采用http的方式加载,当然更好的方式是采用本地文件进行加载,或者单独建立用于存储静态文件的repo。另外github其实还有一个存储其他文件的服务器,也可以将文件放在issue中通过链接访问。

觉得有用的话赞助一点吧~