I’m awkward to say I spent a few hours to get gh pages going locally on my computer. Github pages are ran with Jekyll. Jekyll is a Ruby based static site runner. I never worked with Ruby, so…
There is an official instruction here and you might not need my instructions. My problem is I tend to not read manuals carefully. Here’s what I read and I’ll highlight what I missed.
- Install Ruby. For more information, see “Installing Ruby” in the Ruby documentation.
- Install Bundler. For more information, see “Bundler.”
- Add a Gemfile. My Gemfile looks like this:
source 'https://rubygems.org' gem 'nokogiri' gem 'rack', '~> 2.0.1' gem 'rspec' gem "github-pages", "~> 221", group: :jekyll_plugins Last line is import
Last line is important.
4. Run “`
5. Create at least _config.yml and index.md in root of your gh-pages branch.
--- title: My title description: My description.... --- # Continue with Github markdown
bundle exec jekyll serve
This basic example should now serve a Jekyll cayman theme page. A fuller example running on my library github page https://github.com/eisberg-labs/ngx-barcode-scanner/tree/gh-pages