无法预览 Github 页面答案

【问题标题】：Can't preview Github pages无法预览 Github 页面
【发布时间】：2016-06-30 21:26:50
【问题描述】：

我正在尝试构建一个 github-pages 站点并离线预览它。但是，我只取得了部分成功，而我获得的页面来自我的离线资源，它的所有资源（css/img）和链接都指向该站点的 github 位置。

我使用{{ site.github.url }}，按照here的描述安装了jekyll。

我尝试了bundle exec jekyll clean，并尝试git remote remove origin 并取消设置github_username。但是，如果没有远程站点，站点将无法构建（没有用户名），它仍然知道我的用户名，因为它仍然生成指向 <username>.github.io/repo/ 而不是 127.0.0.1:3000 的链接（我更改了端口）。

如何正确离线测试我的 github 页面（即，让链接指向我的本地 jekyll 实例）？

重要提示：当我启动 bundle exec jekyll serve 时，我收到以下警告：

GitHub 元数据：找不到 GitHub API 身份验证。某些字段 > 可能丢失或数据不正确。

据我所知，这来自jekyll-github-metadata，它填充了site.github。因此（我假设）site.github.url。但是，我还没有发现这是否缓存数据，以及如何擦除这些数据。当我尝试构建离线测试时，我确实希望此 url 为空/指向 localhost。

=================================

标题布局摘录：

<head>
<title>A title</a>
<link rel="stylesheet" href="{{ site.github.url }}/css/bootstrap.min.css">
</head>

由于此<head> 部分/此布局用于页面层次结构的不同部分，我需要一个绝对路径来链接到 css 文件。

【问题讨论】：

{{ site.github.url }} 是对您的 github 存储库 url 的引用，与您的文件夹层次结构无关。它不应该用于描述链接 url。你能提供一个存储库网址吗？
@DavidJacquel：鉴于我链接到的示例 (jekyllrb.com/docs/github-pages)，我理解文档，因此我应该完全使用它，以确保如果我需要包含“myfancy.css”绝对路径，它始终指向基础。当我将我的布局用于博客文章等时，我看不出如何使用相对路径。
@DavidJacquel：如果可能的话，我希望暂时将我的 github 和我的 stackoverflow 帐户分开，但我很乐意发布摘录。我将在一分钟内添加我使用的标题。

标签： jekyll github-pages

【解决方案1】：

替换：{{ site.github.url }}/css/bootstrap.min.css

作者：{{ site.baseurl }}/css/bootstrap.min.css

Github 元数据插件提供通用存储库信息，不应该用于生成您的资源 url。我什至没有在您引用的documentation 中看到它。

你不需要它来让 Jekyll 在本地工作。

【讨论】：

谢谢，我会尝试并报告/接受。作为参考，我说的是jekyllrb.com/docs/github-pages/#project-page-url-structure。
不幸的是，这不起作用。 Github 添加了一个存储库路径，这个 ommitts。虽然离线测试适用于此，但当我将其放在 github 上时它会中断。
这解决了我的问题。

【解决方案2】：

如果您仍然遇到此问题，我有一个 blog post 和 video 显示如何解决它。它的瘦身是这样的：

在 GitHub 中创建个人访问令牌。这只需一秒钟，请参阅GitHub’s documentation。选择要授予令牌的范围时，只需选中 repo 复选框。
在您的计算机上添加一个名为 JEKYLL_GITHUB_TOKEN 的新系统环境变量，并将该值设置为您生成的个人访问令牌。
Go here，复制页面中的所有文本，并将其保存为本地计算机上某个名为 cacert.pem 的文件。
在您的计算机上添加一个名为 SSL_CERT_FILE 的新系统环境变量，并将该值设置为您保存 cacert.pem 文件的完整文件路径。
重新启动您的机器（这非可选）

这篇博文假设您使用的是 Windows 机器，但同样的步骤应该适用于 Mac。

【讨论】：