Jekyll-Uno

Jekyll-Uno is a free, minimal, responsive Jekyll theme adapted from the Uno theme for Ghost, built for publishing a clean personal blog or content site on Jekyll and GitHub Pages.

What is Jekyll-Uno?

Jekyll-Uno is an open-source Jekyll theme based on the Uno design first created for the Ghost publishing platform. It takes a standard Jekyll site with Markdown posts and generates a static, fast-loading blog with a clean layout. The theme requires Ruby and RubyGems to run, and it is distributed under the MIT license, making it free to use and modify. It was created by Josh Gerdes and is maintained publicly on GitHub, where the repository has accumulated 625 stars.

Key Features

• Clean layout — a minimal design inherited from the Ghost Uno theme that keeps the focus on your written content.
• Responsive layout — the theme adapts automatically to mobile phones, tablets, and desktop screens.
• Pagination — built-in pagination splits long post lists into multiple pages for easier browsing.
• Syntax highlighting — code blocks are highlighted out of the box, useful for technical and programming posts.
• Social links — configurable links let you add your social media profiles to the site.
• Tags and categories listing pages — automatically generated pages group your posts by tag and by category, improving site navigation.
• Google Analytics integration — add your Analytics tracking ID in the configuration to monitor site traffic.
• Disqus integration — enable comment threads on posts by setting your Disqus shortname.

Who is it for?

Bloggers who want a straightforward Jekyll theme without extra complexity can use Jekyll-Uno to launch a personal publication quickly. Developers who host blogs or project sites on GitHub Pages will find the theme works with the github-pages gem, and technical writers can rely on the built-in syntax highlighting for code-heavy posts. The theme also suits anyone who wants a responsive layout that looks good on mobile devices.

Use cases

• Personal bloggers: set up a blog with pagination, tags, and categories by writing Markdown posts and configuring the _config.yml file.
• Technical writers: publish tutorials and code examples with syntax-highlighted code blocks and Disqus comments enabled.
• GitHub Pages users: deploy a free, static site using the github-pages gem, with Google Analytics added in a few lines of configuration.

How does Jekyll-Uno work?

After cloning the repository, you install Bundler with gem install bundler, then run bundle install to fetch the required Ruby gems. Once the gems are installed, bundle exec jekyll serve --watch starts a local development server at http://localhost:4000/jekyll-uno/. The theme supports both the github-pages gem and an alternative Gemfile setup using jekyll-paginate, jekyll-watch, kramdown, and kramdown-parser-gfm.

FAQ

Is Jekyll-Uno free?

Yes, Jekyll-Uno is released under the MIT license, so you can use it freely for personal or commercial projects and modify the source code as needed.

Does Jekyll-Uno work with GitHub Pages?

Yes. The theme is designed to work with the github-pages gem, and the repository metadata includes github-pages as a topic. You can also run it locally with the alternate Gemfile provided.

What are the system requirements?

You need Ruby and RubyGems installed on your machine. The theme also uses Bundler to manage gems such as Jekyll, pagination, and the kramdown Markdown parser.

How do I enable Disqus comments?

Set your Disqus shortname in the theme's configuration file. Once configured, comment threads appear on your posts, allowing readers to leave comments without building a custom commenting system.