You can see a live demo of Noir: https://noir.essentialenemy.com
First you will need to setup your Ruby environment and add the Jekyll and Bundler gems to it.
Detailed instructions for getting Ruby setup can be found here and the installation guide for Jekyll can be found here. Bundler makes managing Jekyll sites a lot easier and you can learn how to install that gem here (this theme’s installation guide uses Bundler).
Once that’s done it’s time for the fun part. Don’t even bother with the
jekyll new site command, I am going to provide a more foolproof way so that you don’t wind up in dependencies hell.
- Download the latest release (NOT the ZIP archive of the latest commit made, the latest release asset) of this repository and copy the files into a new directory where you want your site’s configuration files to live.
- In your terminal or command prompt
cdinto the new directory you just made for those files.
- Run the command:
bundle installas this will install all of the dependencies I have named in
- Test that the site can be built with no issues, run the command:
bundle exec jekyll serveand view the site by navigating to
127.0.0.1:4000in your web browser.
- If all is working fine you can begin customizing your site by making changes to
If you have any problems that arise I am glad to help you as much as I can. You can open a new issue, reach out to me on Twitter or email me at the address found inside of
_config.yml. I welcome your feedback and requests as well.
Thank you for your interest in Noir!