Minimalist, customizable Jekyll theme.
Roundabout is a minimalist & customisable theme for Jekyll. It attempts to be as lean and lightweight as possible, whilst maintaining mobile-first principles, as well as other best practices in the modern web.
By using the Roundabout theme, you'll get:
- A complete setup including sample layouts, config, a Atom feed and some example posts/pages.
- A modern design utilising semantic HTML5 elements and compiled + minified SCSS stylesheets.
- Syntax highlighting with Jekyll's default highlighter, Rouge.
- An extremely customisable and extensible base for developing a full-fledged Jekyll website.
Go ahead, download it today and give it a try!
Requirements:
- Ruby (v2.4.0+)
- Bundler -
gem install bundler
- Jekyll -
gem install jekyll
- Node.js (latest LTS is recommended) - Optional, for additional developer tools
To use this theme for your Jekyll website, first download the latest zipped build of the Roundabout here.
You can also clone the repository on GitHub.
$ git clone https://github.com/blvdgroup/roundabout.git
Extract it, cd
to the root directory of the extracted theme, and then install all the bundled Rubygems.
$ bundle install
# Or use the `bundle` shorthand
$ bundle
After the plugins are installed, we can now run a local server from within our computer.
$ bundle exec jekyll serve
Now you can work on your own Jekyll website! Open localhost:4000
in your browser to view it locally. Any saved changes will be rebuilt by Jekyll, so refresh your browser when you do.
This theme also provides additional development tools with Node.js.
Run the following command to install them.
$ npm install
Our commit logs are Commitizen-friendly. We use Commitizen with the cz-blvd
extension as part of our commit naming conventions. To use it we can simply use the Commitizen CLI.
# Install the Commitizen CLI
$ npm install -g commitizen
# Install our dependencies if you haven't already (`cz-blvd` will be downloaded now.)
$ npm install
# To commit using the Commitizen conventions, you can choose either of these two commands:
$ git cz
$ npm run commit
Deploying to GitHub Pages is really simple. First open your _config.yml
file and update these config variables based on your hosting environment.
url: http://blvd.space
baseurl: "/roundabout"
The url
config contains the host of your website, whereas the baseurl
config contains the base directory of your generated site. The rule of thumb to these configurations is as follows:
- Set
url
the root domain of your host, without the trailing slash. For GitHub Pages with no custom domains, this should behttps://<username>.github.io
. - If the generated page is a user page, then leave the
baseurl
config blank (e.g.baseurl: ""
). - If it's a project page, set it to the name of your project, without the trailing slash once again (e.g.
baseurl: "/roundabout"
).
Once it's properly configured just push your commits to your repository, set the GitHub pages settings on your repository to target to the branch where your files is hosted in, and you have yourself a working GitHub page!
Learn more about GitHub Pages deployment on the Jekyll docs{:target="_blank"}.
Issues and Pull Requests are welcome! Please read our Contributing Guidelines & Code of Conduct beforehand.
As a general rule of thumb:
- Fork it.
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Create a new Pull Request.
Source code is licensed under MIT.