Clearly Erroneous

This blog uses the Minimal Mistakes Jekyll theme, which has been customised. You can find the credits and the licence in this README.

Original theme docs

Usage notes here

Installation has followed the quick-start guide above and then the gemified version of the theme has been installed.

To serve the site locally, run bundle exec jekyll serve (runs on http://127.0.0.1:4000)
Note that if the config file is modified while you're serving the site locally, you need to restart it to see the edits

Update theme

Keep the repo up to date with new features from the upstream. If there's too many changed as you've been lazy and haven't updated in a while, so have way too many conflicts to be solved, the best way is create a branch updated with the Minimal Mistakes master and apply your changes on that one.

On general edits

I've modified things here and there to customise my site. In particular I have:

edited some text bits in _data/ui-text.yml
added vars in the config to aid usage (e.g., the one for the path to post images)
changed default paths to images

Style customisations

I've customised CSS and text defaults here and there.

On the posts archive on the homepage

I've edited the _layouts/archive-single.html to display the date of creation of the post in the archive list as it used to be (was removed in a more recent release).

On posts

MathJax is used to display LateX-style maths (added in head.html) in _includes. Add maths into double dollars.
There's buttons for sharing a post on socials configured in _includes/social-share.html: the twitter one will work fine from local as well, the Facebook and LinkedIn ones will only work when deployed

Categories and tags

I'm using categories and tags for posts - see the Jekyll docs. There's pages for the archive of each of them (using the existing layouts with counts of items), respectively at /categories/ and /tags/ and each single one is accessible by clicking on it under each post.

So far, I'm separating posts regarding tech and data things into their own categories (see the navigation).

Tags are many, there's a little tags.py script to look at them - note you can also use the /tags/ page. The idea is not to make duplicates/variations and keep them controlled. "italian" is a kind of a special tag for all posts written in Italian. Note you can surface any tag if desired in the same way as the category.

Credits

Creator

Michael Rose

Icons + Demo Images:

The Noun Project -- Garrett Knoll, Arthur Shlain, and tracy tam
Font Awesome
Unsplash

Other:

License

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Minimal Mistakes incorporates icons from The Noun Project creators Garrett Knoll, Arthur Shlain, and tracy tam. Icons are distributed under Creative Commons Attribution 3.0 United States (CC BY 3.0 US).

Minimal Mistakes incorporates photographs from Unsplash.

Minimal Mistakes incorporates Breakpoint. Breakpoint is distributed under the terms of the MIT/GPL Licenses.

Minimal Mistakes incorporates @allejo's Pure Liquid Jekyll Table of Contents, Copyright (c) 2017 Vladimir Jimenez. Pure Liquid Jekyll Table of Contents is distributed under the terms of the MIT License.