Uploading site to GHPages, the whole project or just the _site files?


#1

I have been battling with setting up the css/sass files correctly. So, if it’s this annoying to configure such simple stuff, I don’t want to know how it would be setting it up on GitHub Pages.

I understand that I can simply upload what is created inside the _site folder directly into the server, right?

Is it valid? Or do I need to upload the whole project.

Thanks in advance.


#2

You can do either ways depending on how your site is setup.

  1. You can upload your entire project to the master branch on your GitHub Repo and once you activate the settings, GHP will build the site for you. You don’t have to do anything else unless you want custom domain url for your site.

  2. GitHub Pages actually has a very constrained environment. Check this link for the details. So basically if you’re going to build on GitHub Pages, you can’t use 3rd-party plugins that are not listed in that page. In that event, you:

    • store your project source on the master branch
    • build locally on your system and upload the contents of the _site to the gh-pages branch on your repo.
    • Change the repo settings so that GHP looks into your gh-pages branch to serve the site markup.