无法预览Github页面

时间:2016-06-30 21:26:51

标签: jekyll github-pages

我正在尝试构建一个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的链接(我更改了端口)。 / p>

如何正确离线测试我的github页面(即链接指向我当地的jekyll实例)?

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

  

GitHub元数据:找不到GitHub API身份验证。一些字段&gt;可能丢失或数据不正确。

据我所知,这来自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文件。

2 个答案:

答案 0 :(得分:2)

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

by:{{ site.baseurl }}/css/bootstrap.min.css

Github元数据插件提供了常见的存储库信息,不应该用于生成资源URL。我甚至没有在你引用的documentation中看到它。

你不需要让Jekyll在当地工作。

答案 1 :(得分:-1)

如果您仍遇到此问题,我会blog postvideo显示如何解决此问题。它的骨瘦如柴:

  1. 在GitHub中创建个人访问令牌。这只需要一秒钟,请参阅GitHub’s documentation。选择要授予令牌的范围时,只需选择repo复选框。
  2. 在您的计算机上添加名为JEKYLL_GITHUB_TOKEN的新系统环境变量,并将该值设置为您生成的个人访问令牌。
  3. Go here,复制页面中的所有文本,并将其保存为本地计算机上某个名为cacert.pem的文件。
  4. 在您的计算机上添加名为SSL_CERT_FILE的新系统环境变量,并将该值设置为等于保存cacert.pem文件的完整文件路径。
  5. 重新启动您的机器(这是可选)
  6. 博客文章假设您使用的是Windows计算机,但相同的步骤应该适用于Mac。