[fastpages] Replacing main <username>.github.io Page w/ FastPages?

nbdev
3

Hi @drscotthawley!

Here is some background that will make my answer easier to understand. There are different kinds of GitHub pages. The two that you most often see are:

  1. User pages: This is when you name your repo username.github.io. A GitHub user can only have one user page. When you setup a user page by naming your repository in this special way your site is served at http(s)://<username>.github.io. Notice how there are now subpaths, like /blog at the end of your url. For a variety of reasons, fastpages does not support user pages. However, fastpages supports project pages.

  2. Project pages are when you name your repo like any other github project, like my_repo. in this case your site will be served at (unless you’re using a custom domain):
    http(s)://<username>.github.io/<repository> or http(s)://<organization>.github.io/<repository> (depending on if you setup the repo in your individual GitHub account or under an organization). this is what fastpages supports.

Now, your challenge is that you need to migrate your former user site to a project site. One solution to this could be to redirect folks from your old url to your new one. I haven’t tried this myself but I found this article while searching for this just now. https://dev.to/steveblue/setup-a-redirect-on-github-pages-1ok7

I hope this is helpful. Let us know how it goes.

8 Likes