How do I turn a repository into a GitHub page?

Question

I currently have a remote repository for serving a website and both back-end and front-end are hosted there.

The questions are:

What is the best way for turning this repository into a GitHub page, abandoning the old back-end?
Could this be done without dropping the current repo?

Note: The server just serves the html, css and js files.

AFAIK, its just naming the repo .github.io and project root becomes the site root. — Kyle, Dec 21 '16 at 02:08

score 4 · Accepted Answer · edited Sep 01 '21 at 12:38

Since the recent GitHub pages changes (markdown support, without Jekyyl; no more gh-pages branch if you want; relative links; theme switcher), you should be able to convert a GitHub repo into a GitHub page one.

As commented, renaming your repo into username.github.io and configuring it to use the master branch should be enough to start seeing the content of your current repository in your own GitHub page.
But its content should be either markdown, or with Jekyll metadata, so some data changes are to be expected.

How do I turn a repository into a GitHub page?

1 Answers1