我正在使用Github Pages托管和服务静态网站。

静态网站具有应用程序的典型目录结构：

|_ source
|_ build
   |_index.html
 .gitignore
 config.rb
 Gemfile
 ...
 README.MD

index.html在下build/，因此我想将其设置为默认www路径。

因此，当用户点击username.github.io它时，它将在该子目录中呈现内容，但是在URL上却不显示“ / build” /，这是因为将其设置为根文件夹。

笔记：

• 我没有自定义域，也没有计划为此目的获得一个。如您所见，我正在尝试利用github提供的默认URL命名约定。
• 不使用Jekyll或自动页面生成器功能。

有一个详细的要点，其中包含所有必需的步骤。

要点在这里：https：
//gist.github.com/cobyism/4730490

从要点

将子文件夹部署到GitHub Pages

有时您希望master分支上有一个子目录，它是存储库gh-pages分支的根目录。这对于使用Yeoman开发的网站或在master分支中包含Jekyll网站以及其余代码的网站时很有用。

就本例而言，我们假设包含您网站的子文件夹名为dist。

第1步

dist从项目的.gitignore文件中删除目录（Yeoman默认将其忽略）。

第2步

确保git知道您的子树（站点的子文件夹）。

git add dist && git commit -m "Initial dist subtree commit"

第三步

使用子树推送将其发送到gh-pagesGitHub上的分支。

git subtree push --prefix dist origin gh-pages

繁荣。如果未调用文件夹dist，则需要在以上每个命令中进行更改。

如果您定期执行此操作，则还可以在路径中的某个位置创建一个包含以下内容的脚本：

#!/bin/sh
if [ -z "$1" ]
then
  echo "Which folder do you want to deploy to GitHub Pages?"
  exit 1
fi
git subtree push --prefix $1 origin gh-pages

通过它可以键入以下命令：

git gh-deploy path/to/your/site

自2016年8月起，您可以使用分支的/docs子文件夹作为master源。

因此，如果可以告诉您的站点生成器/docs代替/build您使用，就可以完成操作（没有子树）。

注意：正如@thislooksfun在注释中指出的那样，此属性仅对项目页面（如<username>.github.io/<projectname>）有效，而对用户或组织页面（如<name>.github.io）无效。

对于我来说，被接受的答案只会在第一次运行。重新做会引发错误。

我通过运行以下命令解决了它：

git checkout --orphan gh-pages
git --work-tree build add --all
git --work-tree build commit -m 'gh-pages'
git push origin HEAD:gh-pages --force
git checkout -f master

push-dir可以做到：

npm install push-direxample
push-dir --dir=build --branch=gh-pages