Jekyll 博客文件夹不会在 github 页面上编译，但可以离线工作

Question

我在myuser.github.io 建立了一个 github 用户页面存储库。我在那里建立了一个常规的 html 静态网站，效果很好。 （我还使用 CNAME 文件和 CNAME DNS 记录设置了一个自定义域，以便 myuser.github.io 转到 www.example.com）

然后我还在那个 repo 中创建了一个/blog 文件夹，并放入了一个 jekyll 博客模板。

在本地运行 jekyll build serve 或 bundle exec jekyll serve 不会给我任何错误。我可以发布新帖子，它们会出现在localhost:4000/blog/。

但是当我将博客文件夹推送到 github 时，会发生这些事情：

• 我收到一封来自 github 的电子邮件，内容是“b2/css/main.scss 文件包含语法错误。有关详细信息，请参阅 https://help.github.com/articles/page-build-failed-markdown-errors。”
• 如果我尝试访问 www.example.com/blog/index.html，我会收到 404。
• 如果我尝试在 /blog/ 且错误仍在 repo 中的情况下对我的 repo 进行任何新的更改（例如，更改我的 main 的标题， 非博客页面，或更改随机图像等）然后我推送，更改 根本不要在线注册（尽管它们显示在 github.com 的 repo 文件树）。

这意味着 github 因该错误而崩溃，并且在修复之前不会更新。

我怎样才能弄清楚那个“main.scss”错误是什么？因为在当地很好。 我是 jekyll（和 github 页面）的新手，但我尽可能地遵循了文档。

这是我的 main.scss：

---
layout: null
# Only the main Sass file needs front matter (the dashes are enough)
#http://sassmeister.com/
---
@charset "utf-8";


// Our variables
$base-font-family: "Raleway",Arial,sans-serif;
$base-font-size:   16px;
$small-font-size:  $base-font-size * 0.875;
$base-line-height: 1.5;

$spacing-unit:     30px;

$text-color:       #111;
$background-color: #fdfdfd;
$brand-color:      #2a7ae2;

$grey-color:       #828282;
$grey-color-light: lighten($grey-color, 40%);
$grey-color-dark:  darken($grey-color, 25%);
$blue-color:       #515865;

// Width of the content area
$content-width:    800px;

$on-palm:          600px;
$on-laptop:        800px;



// Using media queries with like this:
// @include media-query($on-palm) {
//     .wrapper {
//         padding-right: $spacing-unit / 2;
//         padding-left: $spacing-unit / 2;
//     }
// }
@mixin media-query($device) {
    @media screen and (max-width: $device) {
        @content;
    }
}



// Import partials from `sass_dir` (defaults to `_sass`)
@import
        "base",
        "layout",
        "syntax-highlighting"
;

PS：这是我使用的 jekyll 博客主题：https://github.com/smallmuou/Jekyll-Pithy

Answer 1

Github 页面是从根目录生成的。如果您将 Jekyll 放在 /blog 文件夹中，则不会发现您的 _setting.yml，并且可能会弄乱 scss 导入路径。

如果您想在本地复制，您必须重新创建相同的文件夹架构并从根目录而不是 /blog 触发 jekyll serve --trace。

解决方案是创建一个blog 存储库并将您的jekyll 推送到gh-pages 分支中。