https://github.com/danromero/clio

A text-focused minimalist Jekyll template and theme
https://github.com/danromero/clio

jekyll jekyll-blog jekyll-theme jekyll-themes

Last synced: 5 months ago
JSON representation

A text-focused minimalist Jekyll template and theme

• Host: GitHub
• URL: https://github.com/danromero/clio
• Owner: danromero
• License: mit
• Created: 2020-02-19T07:24:42.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-05-26T18:46:18.000Z (about 2 years ago)
• Last Synced: 2026-01-13T13:56:06.753Z (5 months ago)
• Topics: jekyll, jekyll-blog, jekyll-theme, jekyll-themes
• Language: Ruby
• Homepage: https://github.com/danromero/clio
• Size: 675 KB
• Stars: 28
• Watchers: 2
• Forks: 19
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# clio

![screenshot of Clio theme](screenshot.png)

## What is this?

Clio is a template and theme based on [danromero.org](https://danromero.org). This repository is designed to be hosted on [GitHub Pages](https://pages.github.com) with [Jekyll](https://jekyllrb.com). You can read more about the [GitHub Pages + Jekyll integration](https://help.github.com/en/github/working-with-github-pages/setting-up-a-github-pages-site-with-jekyll). Out-of-the-box the template supports:

1. A homepage that displays a brief introduction and the most recent blog posts in reverse chronological order.

2. An about page located at `/about/`.

3. A sample blog post.

4. An RSS feed for all of the blog posts.

## How to set up

1. Clone the repository. Delete `screenshot.png` from the main folder.

2. Edit `_config.yml`. Replace the sample text for title, email, description, url, and twitter.

3. Enable GitHub Pages in the repository's settings. If you are planning to use a custom domain, you can also set that up on the settings page.

4. Add future **posts** as Markdown `(.md)` files to the `_posts` folder. GitHub Pages will automatically generate the HTML.

5. Add future **pages** (like the `/about/` page) as Markdown `(.md)` files to the main folder. GitHub Pages will automatically generate the HTML.

6. **Update the images** in the `/assets/` folder. **If you don't, your site will be represented by a purple square.** 🙂

67. Add future images to the `/assets/` folder. 

## Open Graph images

The template is set up to support Open Graph images for services like [Twitter](https://developer.twitter.com/en/docs/tweets/optimize-with-cards/guides/getting-started). Be sure to add the image name in the [front matter](https://jekyllrb.com/docs/front-matter/) of the blog posts and the images should be uploaded to the `/assets/og/` folder. The Hello World! sample post has a functioning example.

## Google Analytics

You can add the Javascript into the `default.html` [layout](https://jekyllrb.com/docs/layouts/) right above the `