Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/leabs/jekyll-opine

A simple, clean, responsive Jekyll theme for a blog or personal website with built in search, commenting, and more.
https://github.com/leabs/jekyll-opine

html-template jekyll jekyll-blog jekyll-theme

Last synced: about 1 month ago
JSON representation

A simple, clean, responsive Jekyll theme for a blog or personal website with built in search, commenting, and more.

Awesome Lists containing this project

README

        

# Jekyll Opine Theme

![Jekyll Opine theme screenshot](/screenshots/theme.png)

A simple, clean, responsive Jekyll theme for a blog or personal website with built in search, commenting, and more. See the [demo](https://jekyll-opine.vercel.app) for a live look around or check out the [video walkthrough](https://www.youtube.com/watch?v=4NWQb9d2yVg).

## Requirements

To build and run this site locally, you will need

- [Ruby](https://www.ruby-lang.org/en/)
- [Bundler](https://bundler.io/)
- [Jekyll](https://jekyllrb.com/)

## Build and Run Locally

1. Download, clone, or fork the repository
2. Edit `_config.yml` to personalize your site.
3. Replace `favicon.ico` with your own.
4. Replace `assets/images/avatar.png` with your own.
5. `cd` into your fork's directory and run `bundle install`
6. Run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`

## Adding Posts

1. Add a new posts to the `_posts` directory.
2. Add the following to the page's front matter:

```
---
layout: post
title: "Post title"
date: 2023-01-21 07:35:33 -0500
comments: true
---
```

## Adding Pages

1. Add a new page to the root directory.
2. Add the following to the page's front matter:

```
---
layout: page
title: Page Title
permalink: /page-url/
---
```

## Contributing

Bug reports and pull requests are welcome on GitHub at [https://github.com/leabs/jekyll-leabs-theme](https://github.com/leabs/jekyll-leabs-theme)

## Options

Exclude a page from the navigation using the `exclude` option in the page's front matter:

```

exclude: true

```

The index page is set to `exclude: true` by default as it is hard coded into the navigation.