我已经为我在GitHub上正在开发的项目创建了一个gh-pages分支。
我使用Sublime文本编辑器在本地编写网站，我的问题是，当这些内容被推送到GitHub后，所有指向JavaScript、图片和CSS文件的链接都无效了。
例如，在我的部分中有这样一个链接。
<link href="assets/css/common.css" rel="stylesheet">
这在本地运行得很好，但由于链接没有使用存储库名称作为URL的一部分来解析，因此它在GitHub上无法正常工作。
它要求：
http://[user].github.io/assets/css/common.css
当它应该询问的是：
http://[user].github.io/[repo]/assets/css/common.css.
你需要使用Jekyll。
从相关文档中直接复制：
有时在将gh-pages分支推送到GitHub之前，预览您的Jekyll网站是很好的。然而，GitHub用于项目页面的类似子目录的URL结构使得URL的正确解析变得复杂。这里提供一种方法来利用GitHub项目页面URL结构(username.github.io/project-name/)，同时保持本地预览Jekyll网站的能力。
在_config.yml中，将baseurl选项设置为/project-name - 注意前导斜杠和尾随斜杠的缺失。
引用JS或CSS文件时，请使用以下方式：{{ site.baseurl}}/path/to/css.css - 注意变量后面的斜杠（就在“path”之前）。
进行永久链接或内部链接时，请使用以下方式：{{ site.baseurl }}{{ post.url }} - 请注意两个变量之间没有斜杠。
最后，如果您想在使用jekyll serve预览您的网站之前提交/部署，请确保将一个空字符串传递给--baseurl选项，以便您可以在localhost上正常查看所有内容(不需要在开头加上/project-name)：jekyll serve --baseurl ''
gh-pages分支生成您的页面时，所有的URL都将以/project-name开头并正确解析。
显然，有人仅几个月前找到了这个问题的解决方法。
{{ site.github.url }} 更有效。 - Kyle Shevlin你使用的是哪个浏览器？你确定会发生这种情况吗？因为不应该出现这种情况。如果在链接中包含相对URL，它将相对于包含该链接的文档的URL进行解析。换句话说，当你包含
时，应该属于其他内容，并且不能独立成为一行。<link href="assets/css/common.css" rel="stylesheet">
assets/css/common.css 的地址为 http://www.foo.com/bar/doc.html，则该链接将通过将它附加到 HTML 文档的 URL 前缀（不包括路径的最后一部分 doc.html）来解析，即该链接将被解析为 http://www.foo.com/bar/assets/css/common.css，而非你所说的 http://www.foo.com/assets/css/common.css。<link href="assets/css/bootstrap.css" rel="stylesheet">。该链接正确解析为 http://twitter.github.io/bootstrap/assets/css/bootstrap.css，即它包括仓库名称。href="/"？ - Akabab<base href="/[repo]/">
在<head>标签内部，它解决了这个问题。
你还可以通过设置以下内容来改进这个解决方案：
<base href="{{site.baseurl}}" />
然后将site.baseurl设置为空字符串进行本地测试。
site.baseurl的问题？我的意思是，我能从控制台访问这个site吗？ - Patrick Martinus（这是从2013年1月开始的）您一直可以在GitHub.com上编写Markdown时使用相对链接。
现在，当通过GitHub Pages发布时，这些链接将继续工作。
如果您的存储库中有一个Markdown文件位于
docs/page.md，而您想从该文件链接到docs/another-page.md，则可以使用以下标记：
[a relative link](another-page.md)
docs/another-page.html，以匹配目标页面的已发布URL。在幕后，我们正在使用开源Jekyll Relative Links插件，该插件默认为所有构建启用。GitHub Pages上的相对链接还考虑了文件YAML前置数据中的自定义永久链接（例如，permalink: /docs/page/），并在适当的情况下添加项目页面的基本URL，确保链接在任何上下文中都能正常工作。不要忘记自2016年8月起，您可以直接从master分支发布页面（而不总是gh-pages分支）。Jekyll或index.md。简单的Markdown文件就足够了。
html表格中的相对链接未被转换为.html。也就是说，在我的.md文件中有一个包含指向其他存储库中其他.md文件的相对链接的html表格。该表在github.com上呈现正常，但是在github pages中，相对链接仍然是.md文件。为什么？ - user5395338看起来Github Pages的响应不是很快。虽然它可以立即使新文件可用，但由于缓存或其他原因，修改后的文件不会立即出现。
等待15分钟左右，一切就好了。
[user].github.io，它将被发布到https://[user].github.io，并且您可以 完全避免在URL路径中使用存储库名称。显然，缺点是每个github用户只能有1个这样的存储库，因此可能不适合您的需求，我不确定。relative_url过滤器：<link href="{{ '/assets/css/common.css' | relative_url }}" rel="stylesheet">
<base href="/[repo]/">只适用于相对URL，而不适用于以/开头并且相对于根URL的路径绝对URL。但是，将这些URL设置为相对路径也不起作用，因为我只是使用Jinja进行基本渲染，而不是像Jekyll这样使用完整的构建系统。因此，在渲染的页面上，相对路径是不正确的。