为什么我将更改从 Jekyll 推送到 Github Pages 后只显示 HTML？答案

【问题标题】：Why is just the HTML showing after I push my changes from Jekyll to Github Pages?为什么我将更改从 Jekyll 推送到 Github Pages 后只显示 HTML？
【发布时间】：2016-06-06 05:11:41
【问题描述】：

我第一次在 Jekyll 上创建博客，我正试图将我目前拥有的内容部署到 github 页面。当我为该站点提供服务并在本地查看它时，它看起来很好 - 所以我认为我所要做的就是将所有文件推送到 gh-pages 分支。现在我已经完成了，所显示的只是 HTML。

为了解决问题，我只下载了模板文件并将它们推送到 Github 页面，以查看问题是否与我编辑 CSS 的方式有关，但当我这样做时，我得到了相同的结果。

我遇到了一篇专门关于如何使用 github 页面存储 jekyll 站点的文章，它说如果您的页面样式不正确，请删除 HTML 上链接样式表中 css 文件夹之前的斜杠。读完之后，我认为斜线肯定是问题所在，但是在删除斜线之后......我得到了相同的结果。

我已经尝试了几个小时，我觉得它可能很简单（比如斜线）。

这里是回购： https://github.com/pacalabre/blog-site/tree/gh-pages

这是输出： http://pacalabre.github.io/blog-site/

提前感谢您的任何回答！

【问题讨论】：

标签： jekyll github-pages

【解决方案1】：

您需要添加/编辑： baseurl: /blog-site 到配置文件。注意没有尾随斜杠。 'blog-site' 是您的项目的名称，项目名称成为为您的站点服务的子目录。如果没有 baseurl 设置，您的相对 URL 会尝试从 http://pacalabre.github.io/ 获取内容，而它们实际上位于 http://pacalabre.github.io/blog-site/。

GH 将您的网站作为域的子文件夹提供服务，而您的引用没有考虑到这一点。

添加 baseurl 设置后，您需要在图片、css 和 js 等资产前面添加 {{site.baseurl}}。

另外，一旦你做了 baseurl 设置，当你在本地服务时，它不会很正确，你需要将 /blog-site 添加到 localhost url 的末尾才能正常工作。

您还应该尝试使用 Chrome 中的开发工具检查器来帮助您进行故障排除，它现在会清楚地告诉您它无法加载您的所有 js 文件或图像，并且它会显示它试图从哪里加载它们。

【讨论】：

【解决方案2】：

看，您的网站/存储库有问题。

我没有在站点根目录（gh-pages 分支）找到您的 _config.yml。它应该在那里。
那里有一个二进制文件（如果我没记错的话，可能是 Mac 的文件）。它不应该在那里。
那里有 Jekyll 的文件夹（_posts、_drafts、_layouts 等）和 _site 文件夹。你需要选择。或者你上传 _site 内容（不是文件夹本身）或者你上传 Jekyll 项目。通常你只上传 Jekyll 文件夹，然后 GH 为你构建站点，除非你使用了一些 GitHub 不允许的插件。在这种情况下，您只需上传 _site 内容，即编译后的网站（仅限 html、CSS、js）。
在上一个答案中，系统指示您将baseurl 添加到您的站点配置中。这是最好的方法，但如果你的模板只使用url，甚至没有提到baseurl，最好的方法是将项目名称添加到url的末尾，而不是搜索每个链接来调用@987654333 @通过液体。所以，与其给自己带来所有这些麻烦，不如在你的_config.yml 中这样做：
```
url: http://username.github.io/projectname
```

jekyll serve --watch --baseurl ""

使用 bundler 服务 Jekyll 是正确的方法，特别是在部署到 GH Pages 时。不过这是另外一个故事了，如果你有兴趣，我可以稍后添加评论。
建议。阅读更多关于 Jekyll 工作原理的信息。还要寻找.gitignore，这样你就不会向GH上传任何不必要的东西（比如那个二进制文件）。

之后，如果您的网站无法正确构建或显示，请告诉我，如果您愿意，我会为您提供帮助。

希望有所帮助！

【讨论】：