See [https://handasontam.github.io/2018/06/21/my-workflow-for-writing-blog-posts.html] Source can be found under the source branch.
https://jekyllrb.com/docs/installation/
$ bundle install
-
Switch to the source branch and write a new post with markdown format and save it in the _posts directory
$ git checkout source $ vim _posts/2018-06-23-a-new-post.md # write a new blog post
-
Test it locally
$ bundle exec jekyll build $ bundle exec jekyll serve
-
Push to github
$ rake
As github page only support a few whitelisted jekyll plugins due to security reasons. Many useful plugins like jekyll-scholad, jekyll-katex cannot be used.
A workaround is to build the site locally using
jekyll build
and push the resulting html (everything inside the _site folder) to the master branch.To Automate the whole process, I modified the Rakefile from David Ensinger. You can see the modified script here. This command will run
jekyll build
on the source branch and copy everythin in the _site directory to the master branch and push everything to github