Solo
Deprecated: Use my new theme “Duo” instead:
https://chibicode.github.io/duo/
Solo is a Jekyll theme that supports single-page websites only, but supports them well. Yes, it’s responsive.
Looking for a more standard Jekyll theme? Try out Shiori theme, which has Bootstrap integration.
Solo is useful if…
- You want to create an “about me” page from a single markdown file and host it under a custom domain name.
- You want to create a single-page website that’s mostly text, like Know Your Company.
- You want to share a single markdown file and tried GitHub Gist (example), but would like something nicer-looking.
- You want something like GitHub’s automatic page generator for a non-code repository.
This page itself is built with Solo. It’s generated from this markdown file.
Usage
First, install Jekyll. Then download Solo from its GitHub Repository. Start Jekyll and you should see this page up and running.
The main file you’ll be editing is index.md. This becomes the content for the page.
Other Files
- Edit
_config.ymlto change the site’s title and description. - Edit
_includes/head.htmlto add custom code to<head>. - Edit
_includes/scripts.htmlto add custom code before</body>. - Edit
CNAMEto host on a custom domain. - Edit
README.mdbefore pushing your code.
Don’t use <h1> tags
Wthin index.md, do not use <h1> tags - <h1> is reserved for the site title.
Supported Tags
Solo supports lists, <hr>s, <table>s,
blockquotes, and…
<pre>code blocks with syntax highlighting.</pre>
Keep Solo up to date
Instead of downloading, you can fork Solo and use the “upstream” strategy described on this page to keep Solo up to date.
Author
Shu Uesugi (Twitter/GitHub/G+).
