如何调试 Octopress markdown 源文件？答案

【问题标题】：How to debug Octopress markdown source files?如何调试 Octopress markdown 源文件？
【发布时间】：2012-09-26 15:54:37
【问题描述】：

我用Octopress 写博客。通常它运行良好，但有一种情况除外——在输入 rake generate 后，我得到了令人沮丧的输出，上面写着：

psych.rb:203:in `parse': (<unknown>): mapping values are not allowed in this context at line 3 column 6 (Psych::SyntaxError)

我不记得我遇到过多少次这种情况了。每次我谷歌上面的关键词，但没有任何帮助。

我能做的就是从_posts中排除所有的源文件（*.mkd），然后一个一个地添加，看看哪个出错了。我不断检查，最后发现是一个小语法错误让章鱼生气。

生活不应该那么艰难。那么是否可以调试 octopress 源文件以在语法中显示哪一行 文件不正确？ rake generate 的输出根本没有意义。

【问题讨论】：

【解决方案1】：

原因可能是帖子顶部的 JAML 错误（例如标题中的“:”），请参阅 https://github.com/jekyll/jekyll/issues/549 了解更多信息。

【讨论】：

【解决方案2】：

当我尝试使用 Pandoc 转换 Markdown 文件时，我看到了类似的错误（“在此上下文中不允许映射值”）。也许您的错误消息来自 pandoc？

【讨论】：

【解决方案3】：

不必费心调试 Octopress。请迁移到Pelican——一个 Python 驱动的静态站点生成器。它功能齐全、易于使用，并且毫无疑问会生成有用的调试信息。

【讨论】：