If you want to publish your root user page, which appears at
/(e.g. github.com/cirosantilli/cirosantilli.github.io for the user
cirosantilli), GitHub annoyingly forces you to use the
masterbranch for the HTML output:
This means that you must place your
.bigbinput files in a branch other than
masterto clear up
masterfor the generated HTML.
ourbigbookautomatically detects if your repository is a root repository or not by parsing
git remoteoutput, but you must setup the branches correctly yourself.
So on a new repository, you must first checkout to a different branch as in:or to move an existing repository to a non-master branch:
git init git checkout -b dev
git checkout -b dev git push origin dev:dev git branch -D master git push --delete origin master
You then will also want to set your default repository branch to
devin the settings for that repository: help.github.com/en/github/administering-a-repository/setting-the-default-branch