If your GitHub Pages site fails to build on our servers, we’ll send you an email letting you know about the failure. In most cases, we’ll be able to identify the exact file and error so you can fix it and push again.
如果你的GitHub Pages网站无法在服务器上部署,我们讲发送一封邮件给您,让您了解失败的原因。大多数情况下,我们能够找到发生错误的文件以及错误的类型,你可以修复问题并重新推送到GitHub。
Generic failures–一般故障
These build failures will not produce an email with specific file and error information. If you receive an email that simply says “Page build failed” with no further details, or your GitHub Pages site is not showing up after the first push, check for the following common errors:
这类错误不会在email中显示确切的文件及错误信息。如果你收到的邮件简单地显示“Page build failed”,且没有更多额外信息,或你的GitHub Pages网站在您推送到GitHub后并没有显示,请检查如下几个常见的错误:
Unverified email address–未认证的email地址
To trigger a build, the user who pushes a commit to the Pages repository must have a verified email address.
After you verify an email address, you’ll need to push to the repository again to trigger the build process on our servers. You can also contact GitHub support to manually run a build.
为部署您的个人网页,用户推送的commit必须有一个经认证的email地址。
当email经过认证后,你需要再次向你的远程仓库推送commit以保证服务器为您生成网页。你也可以联系GitHub支持来人工地生成网页。
Deploy key used for push–推送所需的部署公钥
Pushes must come from a user account with a verified email address. You won’t trigger a build if you use a deploy key to push to an organization’s Pages repository.
Instead, you can set up a machine user as a member of your organization.
推送必须来自一个经email地址认证的帐户。如果您使用一个部署公钥去推送commit到一个组织的网页仓库,这将不能触发部署动作。
相反的,你能够设置一个machine用户作为你组织的一个成员。