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中通过链接访问。