handasontam/handasontam.github.io

Blog

See [https://handasontam.github.io/2018/06/21/my-workflow-for-writing-blog-posts.html] Source can be found under the source branch.

Dependencies

https://jekyllrb.com/docs/installation/

$ bundle install

Steps to write a post

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

Reference

Markdown Cheat Sheet.

TeXt Theme Docs.