Jekyll
TODO: Sort the blog homepage out, get a nice theme
- Moon
moon-master is in[TODO]
. - https://jekyllthemes.io/
- Static and Free
- Build a Blog With Jekyll and GitHub Pages
- How I Created a Beautiful and Minimal Blog Using Jekyll, Github Pages, and poole ««
Installation
Installation is via RubyGems
(sudo) gem update --system
(sudo) gem install bundler
(sudo) gem install jekyll
(sudo) sudo gem install rake
(sudo) sudo gem install ethon
sudo gem install gemoji
or (Which actually works)
brew install ruby
gem install jekyll
Running
bundle exec jekyll build
bundle exec htmlproofer ./_site --allow-hash-href
gem 'html-proofer'
gem 'jekyll'
gem 'jekyll-paginate'
gem 'jekyll-sitemap'
gem 'jemoji'
gem 'rake'
gem 'rdiscount'
gem 'rouge'
Running in a docker
image
However, ruby
is broken on my Mac, so I decided to use docker
to host my local
Jekyll site. This involved the following
docker pull jekyll/jekyll
docker run --rm --label=jekyll --volume=$HOME/websites:/srv/jekyll -it -p 4000:4000 jekyll/jekyll jekyll new my-blog
docker run --rm --label=jekyll --volume=$HOME/websites:/srv/jekyll -it -p 4000:4000 jekyll/jekyll cd my-blog && jekyll serve
Embedding a GitHub Gist
Use something like this <script src="https://gist.github.com/45d691eb44c340aeb59d8dfa3bb7fb9d.js"> </script>
, for an example see here.
Using
- http://blog.meinside.pe.kr/Adding-tag-cloud-and-archives-page-to-Jekyll/
- https://codinfox.github.io/dev/2015/03/06/use-tags-and-categories-in-your-jekyll-based-github-pages/
- Front Matter
- Variables
- Pagination
- How to render a Jekyll markdown page on sites index