Product Analysis: jaan.io

Overview:

jaan.io is a Jekyll theme that powers the personal website of the author. It is a fork of Cole Townsend’s Balzac theme with inspiration from his website. The theme includes improvements from Michael Rose’s So Simple themes for Jekyll, such as support for Bing Verification, Twitter Cards, Google Analytics, Authorship, and Webmaster Tools. The setup and settings are similar to Balzac’s theme.

Features:

• Forked from Cole Townsend’s Balzac theme
• Heavy inspiration from Cole Townsend’s website
• Includes improvements from Michael Rose’s So Simple themes for Jekyll
• Supports Bing Verification, Twitter Cards, Google Analytics, Authorship, and Webmaster Tools

Installation:

To install the jaan.io theme, follow these steps:

1. Test the theme locally by running the command jekyll serve --config _config.yml,_config_dev.yml --watch
2. Check for broken internal and external links using the command rake test
3. Deploy the theme using s3_website. Set the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables in the .env file. Build with bundle exec jekyll build and deploy to S3 with s3_website push.
4. If you are using a Mac, manage the ruby environment using rbenv or rvm. Install bundler for managing gems by running gem install bundler. Run bundler install from the root of the repo. Rehash to create symbolic links to gems with rbenv rehash. Then, run Jekyll commands using jekyll build.
5. To create vector graphics for blog posts, use Keynote to make figures and export them to PDF. Crop the PDF in Preview. Convert the PDF to SVG using Inkscape with the command inkscape --without-gui --file=in.pdf --export-plain-svg=out.svg. Put the SVG files in the _svg folder and include them using the {% asset out.svg %} tag.
6. For images in posts, use the style="max-width: 38%" attribute in HTML tags.
7. To update Google metadata, modify the index.md, about.md, and home.html files.
8. The usage of the theme is covered under a flexible license that allows for any use.

Summary:

jaan.io is a Jekyll theme that powers the author’s personal website. It is a fork of Cole Townsend’s Balzac theme with improvements inspired by Michael Rose’s So Simple themes for Jekyll. The theme includes several key features such as support for Bing Verification, Twitter Cards, Google Analytics, Authorship, and Webmaster Tools. The installation process involves testing the theme locally, checking for broken links, deploying to S3, managing the ruby environment, and creating vector graphics and images for blog posts. Overall, jaan.io offers a flexible and customizable solution for creating a personal website.