GitHub页面只显示ReadMe文件？

Question

我正在尝试将我的网页托管到Github Pages，但出于某种原因，它似乎只显示我的Readme文件。

Github仓库：https://github.com/InquisitiveDev2016/InquisitiveDev2016.github.io

网站：

https://inquisitivedev2016.github.io/

- Rookie

---

当我第一次在项目根目录中创建index.html时，我遇到了相同的问题，这个答案帮助我意识到我只需要等待几分钟然后重试：https://dev59.com/N6Hia4cB1Zd3GeqPW6mt#53678354 - Marcus

Answer 1

GitHub Pages的设计初衷是托管代码库中的内容。

提问者的代码库根目录只包含一个文件(README.md)，所以没有简单的方法导航到其他页面，例如repo/website/webpage.html。

考虑将网页内容移动到代码库的根目录，并将默认页面重命名为index.md或index.html，具体取决于文件类型。 (按照惯例，大多数网站的默认页面称为index.html，如果存在此文件，GitHub Pages将默认显示它。)

- Chris

---

如果有需要的话，我曾经不得不将所有的构建文件，包括index.html文件，移动到根目录下才能使其正常运行。 - Marvel Moe

提醒一下，链接是404。 - WinEunuuchs2Unix

@WinEunuuchs2Unix，那个链接是关于OP询问的存储库。如果他们将其删除，我们无能为力。您会注意到问题中的两个链接也都失效了。 - Chris

@Chris 抱歉我没有注意到你在引用 OP 的网站。为了感谢你的辛劳，我点了赞 :) - WinEunuuchs2Unix

Answer 2

Github提供多种选择，可以从哪里获取源代码。默认情况下，它使用主分支的根目录，在没有index.html文件的情况下将使用README.md文件。

但是您也可以在存储库设置中切换到docs/文件夹。这样，您就可以将index.html放在docs/文件夹下。

请参见。

- oae

---

我该如何将index.html添加到“docs”文件夹中？我在任何地方都没有看到它。 - rickandmorty

通常情况下，您需要检出项目，添加文件，提交并推送！请检出常规的 git https://git-scm.com/。 - oae

Answer 3

在我的情况下，我必须在GitHub页面设置中选择gh-pages/root分支。

- fadingbeat

---

它对我起作用了。默认情况下，它是main/root，但React应用程序已部署到gh-pages/root，我通过npm i gh-pages实现了这一点，并在GitHub页面设置中将其更改为gh-pages/root，更新了部署。 - dpthegrey

这个答案真被低估了。你救了我的一天！ - Bidisha Das

非常高兴读到这个，Bidisha！很高兴我能帮忙。 - fadingbeat

谢谢，这应该是被接受的答案。 - سعيد

Answer 4

当我使用 create-react-app 部署静态 React 应用程序时（因此 index.html 位于 /public 而不是根目录），我遇到了类似的情况，需要使用 gh-pages npm 包。

我需要在 GitHub 项目的设置页面中选择将 gh-pages 分支作为分支，并将 /docs 文件夹作为目标路径。这并不直观，因为在我的项目文件中并没有 /docs 文件夹，但最终它还是能正常工作了，让我感到非常欣慰！

- Iryna

---

这对我非常有帮助，谢谢。 - Stephen Melben Corral

Answer 5

如果你想访问index.html页面， 尝试写成 https://你的-github-部署-地址/index.html

所以只需要在地址末尾添加'/index.html'即可！ （这是我解决问题的方法）

- bonlim

Answer 6

在根目录下创建一个index.html文件，并插入这行代码。

<meta http-equiv="Refresh" content="2; url=public/index.html">

这对我来说在一个我使用Vue CLI项目时遇到麻烦的情况下有效。

- bretonio

Answer 7

对我来说，这个解决方案解决了问题：https://github.com/gitname/react-gh-pages

打开 package.json 文件，添加以下两个属性：

• 在此格式下添加主页属性*：https://{username}.github.io/{repo-name}

• 对于项目站点，格式如下。对于用户站点，格式为：https://{username}.github.io。您可以在create-react-app文档的“GitHub Pages”部分中了解有关主页属性的更多信息。

    {
      "name": "my-app",
      "version": "0.1.0",
    + "homepage": "https://gitname.github.io/react-gh-pages",
      "private": true,
  

在 `

` 中的 `scripts` 对象中添加一个 `predeploy` 属性和一个 `deploy` 属性： 
  "scripts": {
  +   "predeploy": "npm run build",
  +   "deploy": "gh-pages -d build",
      "start": "react-scripts start",
      "build": "react-scripts build",

- Murphy Xue

Answer 8

请将HTML文件更改为index.html。这个简单的事情让我苦苦挣扎了6个小时才找到。 我的HTML文件名之前是base.html，这只显示了read me文件。 更改为index.html后，文件就可以顺利打开了。

- karthi

---

这很棒，但是你如何让index.html文件使用主题？ - Dave

Answer 9

最简单的解决方法是将index.html文件与readme.md放在最外层文件夹中。

- Deb

Answer 10

解决此问题的最佳实践步骤是进入您的项目文件夹。您应该将您命名为根或初始页面的任何内容更改为如上所述的index.html。然后在您的系统上使用git bash打开您的项目，执行您的常规git步骤，例如：

• git add
• git commit -m " change to index.html"
• git push origin master（取决于您命名的根分支）

然后转到设置，就可以了（哇哇） 经过一两次刷新后，您的网站将会上线。

- Omoefe Ugboma