Search code examples
gitgithubgithub-pages

How do you view a different branch of your GitHub Pages?

My master branch is accessible by {USERNAME}.github.io. Let's say I make a new branch named "mobile" and make some new commits on the web interface. How to do I view the new mobile branch, locally, without merging it into master?

Solution

  • GitHub Pages are built on top of Jekyll, which you can also install and run locally. The short version is:

    1. Install Ruby
    2. Install Bundler

    3. Install the version of Jekyll that GitHub uses by creating a Gemfile that contains

      source 'https://rubygems.org'
gem 'github-pages'

      and running bundle install

    Once that is done you can run Jekyll locally in a way that matches GitHub's setup for Pages:

    Running Jekyll

    To run Jekyll in a way that matches the GitHub Pages build server, run Jekyll with Bundler. Use the command bundle exec jekyll serve in the root of your repository (after switching to the gh-pages branch for project repositories), and your site should be available at http://localhost:4000. For a full list of Jekyll commands, see the Jekyll documentation.

    I believe you'll want to do this from your mobile branch.