DEPRECATION NOTICE: I stopped maintaining this separate theme repo. Instead, I moved the theme source over to my blog repo and keep working / customizing it to suit my need with faster iteration. Feel free to fork this repo if you want the more basic Clean Blog theme without all of my customization.
This is a modified version of Clean Blog Jekyll to be fully compatible with GitHub Pages (no pre-compilation needed). Modified by Thanh Tran for his own blog.
The official Jekyll version of the Clean Blog theme by Start Bootstrap.
- New choice of typography, remarkably Open Sans for titles and Lora for body texts.
- Implement read-time partial without plugins, use it in Post meta and blog index.
- Use SASS (SCSS flavor) instead of LESS, with minimal Bootstrap SCSS bundle.
New choice of typography, remarkably Source Sans Pro for titles and Noto Serif for body texts.- Support Vietnamese texts
- Use client-side Prism syntax highlighter (compatible with GitHub-flavored Markdown code fences) instead of pre-rendered Pygments
- Include Google Analytics script tag. Set your GA ID at
site.gaid - Include Disqus script to enable commenting. Set your Disqus site's ID at
site.disqus_site_id. If not set, the comment section is omitted. - Full text search using Google site search. See search.html.
- A compact posts archive (which list all published blog posts). I believe listing the post titles is better than Search and it generate some sort of information scent.
- Better image caption using
img + emtechnique. See this example - Enable automatic feed generation supported by GitHub Pages, added jekyll-feed in gems in _config.yml file
- Enable auto sitemap, added jekyll-sitemap in gems in _config.yml file
- Enable jekyll-seo-tag plugin to generate SEO and social network friendly tags
- TODO: Implement tags labelling for posts and view by tags
- TODO: Add modified / update time using front matter or pushed time
- Use
titlefor both post title and HTML page title - Use
subtitlefor the text below the main title - Use
descriptionfor meta and open graph description - Use
imagefor both post header image and open graph image
In the config.yml file, the base URL is set to /startbootstrap-clean-blog-jekyll which is this themes gh-pages preview. It's recommended that you remove the base URL before working with this theme locally!
It should look like this:
baseurl: ""
This Jekyll theme is customized to run well on GitHub Pages, therefore it must be built or previewed with github-pages gem bundle to align the plugins and settings. Follow this article for environment installation. After that, you can start previewing the generated site with bundle exec jekyll serve.
A Grunt environment is also included. There are a number of tasks it performs like minification of the JavaScript, compiling of the SCSS files, adding banners to keep the Apache 2.0 license intact, and watching for changes. Run the grunt default task by entering grunt into your command line which will build the files. You can use grunt watch if you are working on the JavaScript or the SCSS.
You can also run grunt serve to watch for changes and test the blog in one command.
This theme is for my own blog which is customized with my own preferences. Issue reports are welcome but I may have little time to respond to questions or installation support.
Besides, please visit Clean Blog's template overview page on Start Bootstrap at http://startbootstrap.com/template-overviews/clean-blog/ for extra info and comments.
Copyright 2015 Start Bootstrap
Copyright 2015-2018 Tran Trong Thanh.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.