Github announced variety of sources of Github Pages is supported in their official blog. It allows developers to publish Github Pages with master branch instead of
gh-pages branch. Since this feature, you can publish your Jekyll site without using
gh-pages branch and Github Pages deployment now can be much simpler.
Build page on docs directory
First step: Configure build destination.
# _config.yml destination: ./docs
Now Jekyll pages are built on
$ jekyll build Configuration file: /Users/toshimaru/blog.toshima.ru/_config.yml Source: /Users/toshimaru/blog.toshima.ru Destination: ./docs Incremental build: disabled. Enable with --incremental Generating... done in 4.078 seconds. Auto-regeneration: disabled. Use --watch to enable.
Yay, you are almost ready to publish the pages.
Use docs instead of gh-pages branch
Last step: Change Github Pages source in your repository setting.
You will see your Github Pages on your own published pages. Happy Jekylling <3
By using rake, you can deploy your Jekyll site with one command,
# Rakefile desc 'deploy Jekyll site to Github Pages' task :deploy do sh 'bundle exec jekyll clean' sh 'bundle exec jekyll build' sh 'git add ./docs' sh 'git commit -m \'Update\'' sh 'git push origin master' end
In this task,
rake deploy builds Jekyll site and push it to Github for you. This is useful if you’d like to release your site on CI such as TravisCI, CircleCi.