Moon is a minimal, one column jekyll theme.
Clone or fork this repo and change the url
and puburl
in _config.yml
To learn how to install and use this theme check out the Setup Guide for more information.
You will need ruby and the ruby-gem github-pages installed on your computer, if you want to serve the Jekyll page locally.
I highly recommend using rbenv. Installation is easy if you already have homebrew:
$ brew install rbenv
After you have rbenv installed, cd
to your Jekyll site's directory, and install a Ruby version. This theme was tested on 2.4.0:
# list available versions:
$ rbenv install -l
# install a ruby version (this might take a while):
$ rbenv install 2.4.0
# set the ruby version in the working directory:
$ rbenv local 2.4.0
# see which version is selected:
$ rbenv versions
With rbenv You don't need to SUDO, but we do need to install some gems:
# everything we need is in github-pages, including jekyll
$ gem install github-pages
# we also need bundler
$ gem install bundler
# to install the required gems for this project specified in the gemfile
$ bundler install
you can checkout what bundler does.
if you are struck with some of these ruby/ gems/ bundler stuff, this link might be helpful.
$ bundle exec jekyll serve --watch # the watch flag looks for real-time changes to files you edit
go to localhost:4000
in your browser to see your site.
- Minimal, you can focus on your content
- Responsive
- Disqus integration
- Syntax highlighting
- Optional post image
- Social icons
- Page for sharing projects
- Optional background image
- Simple navigation menu
- MathJax support
See a live version of Moon hosted on GitHub.