Ich verwende Github Pages , um eine statische Website zu hosten und bereitzustellen.

Die statische Website hat die typische Verzeichnisstruktur für eine App:

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

index.htmlist unter build/, also möchte ich das zum Standardpfad machen www.

Wenn Benutzer username.github.iodarauf klicken, wird der Inhalt in diesem Unterverzeichnis gerendert, und in der URL wird dennoch nicht "/ build" / angezeigt, da dieser als Stammordner festgelegt ist.

Anmerkungen:

• Ich habe keine benutzerdefinierte Domain und plane auch nicht, eine für diesen Zweck zu erwerben. Wie Sie sehen, versuche ich, die von github bereitgestellte Standard-URL-Namenskonvention zu nutzen.
• Weder Jekyll noch die automatische Seitengeneratorfunktion.

Es gibt eine detaillierte Übersicht mit allen erforderlichen Schritten.

Das Wesentliche ist hier:
https://gist.github.com/cobyism/4730490

Aus dem Kern

Bereitstellen eines Unterordners für GitHub-Seiten

Manchmal möchten Sie, dass ein Unterverzeichnis in der masterVerzweigung das Stammverzeichnis der Verzweigung eines Repositorys ist gh-pages. Dies ist nützlich für Dinge wie Sites, die mit Yeoman entwickelt wurden , oder wenn Sie eine Jekyll-Site in der masterVerzweigung neben dem Rest Ihres Codes haben.

In diesem Beispiel tun wir so, als wäre der Unterordner mit Ihrer Site benannt dist.

Schritt 1

Entfernen Sie das distVerzeichnis aus der Projektdatei .gitignore(von Yeoman wird es standardmäßig ignoriert).

Schritt 2

Stellen Sie sicher, dass git Ihren Teilbaum kennt (den Unterordner mit Ihrer Site).

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

Schritt 3

Verwenden Sie Subtree Push, um es an den gh-pagesZweig auf GitHub zu senden .

git subtree push --prefix dist origin gh-pages

Boom. Wenn Ihr Ordner nicht aufgerufen wird dist, müssen Sie dies in jedem der obigen Befehle ändern.

Wenn Sie dies regelmäßig tun, können Sie auch irgendwo in Ihrem Pfad ein Skript erstellen , das Folgendes enthält:

#!/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

Damit können Sie Befehle eingeben wie:

git gh-deploy path/to/your/site

Seit August 2016 können Sie den /docsUnterordner des masterZweigs für Ihre Quellen verwenden.

Wenn Sie also Ihrem Site-Generator mitteilen können, dass er /docsanstelle von /buildIhnen verwendet werden soll, sind Sie fertig (ohne Teilbaum).

Hinweis: Wie von @thislooksfun im Kommentar ausgeführt, gilt dies nur für Projektseiten (wie <username>.github.io/<projectname>), nicht jedoch für Benutzer- oder Organisationsseiten (wie <name>.github.io).

Irgendwie läuft die akzeptierte Antwort für mich nur beim ersten Mal. Wiederholen wirft Fehler.

Ich löse es, indem ich die folgenden Befehle ausführe:

• git checkout --orphan gh-pages Git Referenz

• git --work-tree build add --all Git Reference

• git --work-tree build commit -m 'gh-pages'

• Git Push Origin HEAD: Gh-Seiten --force

• Git Checkout -f Master

Push-Dir wird es tun:

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