stijnvc / holo-alfa

A minimalist, mobile first Jekyll theme.

Holo Alfa Jekyll theme

This project is no longer maintained. It will probably still work fine though.

Holo Alfa is a minimalist, mobile first Jekyll theme with focus on readability and content. Created for free and fun by Stijn. Also works great as a base to build your own theme on.

See it in action: http://steinvc.github.io/holo-alfa/.

Feature highlights

• Mobile first design
• Extensive content styling
• Responsive video's (using FitVids.JS)
• Support for authors and guest authors
• Read time on articles
• Disqus comments
• Language localization
• Automatic og metadata
• Automatic archive page (without plugins)
• Automatic sitemap en RSS feed
• Contact page (with working email form)
• A lot of (optional) customization options (all in _config.yml)

And much more.

Getting started

If you're new to Jekyll, check out http://jekyllrb.com/ and read up on Jekyll. It's worth it.

• Another great resource to learn about Jekyll
• Github's guide to using Jekyll with Pages

Installing

As simple as forking the repository, and then clone it so you can edit the files locally.

Configuration

Edit _config.yml!

You can find _config.yml in your site's root directory. This configuration file contains some necessary settings and some optional customization settings. All settings are explained in _config.yml itself. Also make sure to use the developement configuration file (_config_dev.yml) for running your site locally. This way you don't get your URLs mixed up.

There are some customizations that can't be done in _config.yml. These include:

• Editing the About, Contact and Archive page.
• Adding or removing pages from the navigation. This can be done in \_includes\navigation.html.
• The "thanks" page after a message has been send through the contact page: thanks.md
• The gradient on cover images: \_includes\gradient.css (this is explained in _config.yml).

Also make sure to replace the placeholder favicons and the \img\og-image.jpg with your own.

Start the Jekyll server

You can learn how to do this by reading this.

Tip: to run your site locally with _config_dev.yml as configuration file, use this command at the root of your site bundle exec jekyll serve --config _config_dev.yml.

When everything is OK, your site should now be available at http://localhost:4000.

That's it.

---

MIT license

holo-alfa's Issues

Footnote number not really a superscript

The footnote number¹ next to the text, although is wrapped within the <sup> ... </sup> tags doesn't really appear as a superscript. This is due to reset.css having selectors a and sup with properties

font: inherit;
vertical-align: baseline;

I've fixed it by removing the sup and sub selectors and changing a to a:not(.footnote). If that's OK, I can issue a pull request.

The install sections doesn't mention RedCloth

In the installation instructions (located in the README.md file) I see no mention of RedCloth gem. Without it, I was not able to run jekyll serve successfully (even though this works with other Jekyll themes).

So, maybe you should consider pitching that into the README.md file?

Here's the terminal output I got:

/home/r3bl/.rvm/gems/ruby-2.1.2/gems/bundler-1.10.6/lib/bundler/resolver.rb:202:in `rescue in start': Bundler could not find compatible versions for gem "RedCloth": (Bundler::VersionConflict)
  In snapshot (Gemfile.lock):
    RedCloth (= 4.2.9)

  In Gemfile:
    github-pages (>= 0) ruby depends on
      RedCloth (= 4.2.9) ruby

Running `bundle update` will rebuild your snapshot from scratch, using only
the gems in your Gemfile, which may resolve the conflict.
    from /home/r3bl/.rvm/gems/ruby-2.1.2/gems/bundler-1.10.6/lib/bundler/resolver.rb:198:in `start'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/gems/bundler-1.10.6/lib/bundler/resolver.rb:182:in `resolve'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/gems/bundler-1.10.6/lib/bundler/definition.rb:200:in `resolve'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/gems/bundler-1.10.6/lib/bundler/definition.rb:140:in `specs'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/gems/bundler-1.10.6/lib/bundler/definition.rb:185:in `specs_for'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/gems/bundler-1.10.6/lib/bundler/definition.rb:174:in `requested_specs'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/gems/bundler-1.10.6/lib/bundler/environment.rb:18:in `requested_specs'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/gems/bundler-1.10.6/lib/bundler/runtime.rb:13:in `setup'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/gems/bundler-1.10.6/lib/bundler.rb:127:in `setup'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/gems/jekyll-2.5.3/lib/jekyll/plugin_manager.rb:37:in `require_from_bundler'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/gems/jekyll-2.5.3/bin/jekyll:16:in `<top (required)>'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/bin/jekyll:23:in `load'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/bin/jekyll:23:in `<main>'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/bin/ruby_executable_hooks:15:in `eval'
    from /home/r3bl/.rvm/gems/ruby-2.1.2/bin/ruby_executable_hooks:15:in `<main>'

bundle update did fix the error to me, but others might be confused and miss that.