Clean Blog is a stylish, responsive blog theme for Bootstrap created by Start Bootstrap. This theme features a blog homepage, about page, contact page, and an example post page along with a working contact form powered by Formspree.
This repository holds the official Jekyll version of Square Zero!
When installing the theme using RubyGems, demo images, posts, and pages are not included. Follow the instructions below for complete setup.
jekyll new my-site
Gemfile
with gem "jekyll-theme-clean-blog"
.bundle install
_config.yml
file with theme: jekyll-theme-awesome
.bundle exec jekyll serve
Assuming there are no errors and the site is building properly, follow these steps next:
.md
to .html
):index.html
- set to layout: home
about.html
- set to layout: page
contact.html
- set to layout: page
posts/index.html
- set to layout: page
(you will also need to create a posts
directory)index.html
front matter. Example:
```layout: home background: '/PATH_TO_IMAGE'
3. Configure the `about.html`, `contact.html`, and `posts/index.html` front matter. Example:
layout: page title: Page Title description: This is the page description. background: '/PATH_TO_IMAGE'
4. For each post in the `_posts` directory, update the front matter. Example:
layout: post title: "Post Title" subtitle: "This is the post subtitle." date: YYYY-MM-DD HH:MM:SS background: '/PATH_TO_IMAGE'
For reference, look at the [demo repository](https://github.com/BlackrockDigital/startbootstrap-clean-blog-jekyll) to see how the files are set up.
5. Build your site: `bundle exec jekyll serve`
### Using Core Files
When using the core files, the demo images, posts, and pages are all included with the download. After following the instructions below, you can then go and change the content of the pages and posts.
1. [Download](https://github.com/BlackrockDigital/startbootstrap-clean-blog-jekyll/archive/master.zip) or Clone the repository.
2. Update the following configuration settings in your `_config.yml` file:
- `baserul`
- `url`
- `title`
- `email` (after setting this setting to a working email address, fill out the form on the contact page and send it - then check your email and verify the address and the form will send you messages when used)
- `description`
- `author`
- `twitter_username` (Optional)
- `facebook_username` (Optional)
- `github_username` (Optional)
3. Build your site: `bundle exec jekyll serve`
## Bugs and Issues
Please credit the thumbnail artists if you do use others' work.
Have a bug or an issue with this template? [Open a new issue](https://github.com/BlackrockDigital/startbootstrap-clean-blog-jekyll/issues) here on GitHub!
## About
Start Bootstrap is an open source library of free Bootstrap templates and themes. All of the free templates and themes on Start Bootstrap are released under the MIT license, which means you can use them for any purpose, even for commercial projects.
* https://startbootstrap.com
* https://twitter.com/SBootstrap
Start Bootstrap was created by and is maintained by **[David Miller](http://davidmiller.io/)**, Owner of [Blackrock Digital](http://blackrockdigital.io/).
* http://davidmiller.io
* https://twitter.com/davidmillerskt
* https://github.com/davidtmiller
Square Zero Theme built by [surajk95](https://github.com/surajk95).
Start Bootstrap is based on the [Bootstrap](http://getbootstrap.com/) framework created by [Mark Otto](https://twitter.com/mdo) and [Jacob Thorton](https://twitter.com/fat).
## Copyright and License
Copyright 2013-2018 Blackrock Digital LLC. Code released under the [MIT](https://github.com/BlackrockDigital/startbootstrap-clean-blog-jekyll/blob/gh-pages/LICENSE) license.