Reverie-Crappy is a fork of [amitmerchant1990/reverie](https://github.com/amitmerchant1990/reverie) with some adjustment.
The following has been add/edited from the original :
- Dark Theme toggle (don't respect browser preferences) with DarkReader.
- Remove . when post author doesn't present.
- change file strcture.
- ~~Post 'visiblity' when not set to public, will not be listed on site. It still appear on sitemap though.~~ changed to 'hidden: true' for pagination compatiblity.
- More expand friendly navbar.
- add gitea icon svg.
- choice to disable/enable Twitter share on buttom.
- choice to enable/disable blog on first page.
- any file contain "hidden_true" will be exclude from sitemap (via _config.yaml)
- add custom index upper(before blog)
- add seperated blog index page
---
Reverie is a [Jekyll](https://jekyllrb.com/)-powered theme which is simple and opinionated. It's actually a fork of [jekyll-now](https://github.com/barryclark/jekyll-now) with some additional features and personal touches which I've implemented to suit my needs for my blog.
> [Theme demo](https://reverie.pages.dev/)
This is a plug-and-play Jekyll theme best suited to use on [GitHub Pages](https://pages.github.com) (or [Cloudflare Pages](https://pages.cloudflare.com/) if you want to have your repository private) without even setting up a local environment.
| Responsiveness | Search | Categories |
|---------------------|----------------------|----------------------|
| |  |  |
# Table of Contents
- [Features overview](#features-overview)
- [Using Reverie on GitHub Pages](#using-reverie-on-github-pages)
- [1. Fork Reverie to your User Repository](#1-fork-reverie-to-your-user-repository)
- [2. Customize and view your site](#2-customize-and-view-your-site)
- [3. Publish your first blog post](#3-publish-your-first-blog-post)
- [Using Categories in Reverie](#using-categories-in-reverie)
- [Pagination](#pagination)
- [RSS](#rss)
- [Sitemap](#sitemap)
- [Emailware](#emailware)
- [The name?](#the-name)
- [License](#license)
## Features overview
- Clean and minimal design
- Single column post layout
- Command-line free fork-first workflow, using GitHub.com to create, customize and post to your blog
- Fully responsive and mobile optimized theme
- Sass/Coffeescript support using Jekyll 2.0
- Free hosting on your GitHub Pages user site
- All the SEO goodies come built-in
- Markdown blogging
- Supports [Pullquotes](https://reverie-jekyll.netlify.app/pullquotes/)
- Syntax highlighting using Pygments
- [Dracula syntax theme](https://draculatheme.com/) included
- Disqus commenting
- Social media icons
- Google Analytics integration
- Supports [Google Analytics 4](https://support.google.com/analytics/answer/10089681?hl=en)
- Fuzzy search across blog posts
- Blog with pagination
- Categorize posts out-of-the box
- RSS Feed
- Built-in sitemap
> Like this theme? If so, consider donating a small amount that will help my maintaining this project further.
> You can support me via Paypal.
## Using Reverie on GitHub Pages
Setting up Reverie on GitHub Pages is as simple as it gets!
### 1. Fork Reverie to your User Repository
Fork this repository, then rename the repository to `yourgithubusername.github.io`.
Alternatively, you can click the [`Use this template`](https://github.com/amitmerchant1990/reverie/generate) button if you want to create a repository with a clean commit history which will use Reverie as a template.
Your Jekyll blog will often be viewable immediately at (if it's not, you can often force it to build by completing step 2).
### 2. Customize and view your site
Enter your site name, description, avatar and many other options by editing the `_config.yml` file. You can easily turn on Google Analytics tracking, Disqus commenting and social icons here.
Making a change to `_config.yml` (or any file in your repository) will force GitHub Pages to rebuild your site with Jekyll. Your rebuilt site will be viewable a few seconds later at - if not, give it ten minutes as GitHub suggests and it'll appear soon.
### 3. Publish your first blog post
Delete all files from `_posts`directory and create a new file called `/_posts/2019-2-13-Hello-World.md` to publish your first blog post. That's all you need to do to publish your first blog post! This [Markdown Cheatsheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) might come in handy while writing the posts.
> You can add additional posts in the browser on GitHub.com too! Just hit the Create new file button in `/_posts/` to create new content. Just make sure to include the [front-matter](http://jekyllrb.com/docs/frontmatter/) block at the top of each new blog post and make sure the post's filename is in this format: year-month-day-title.md
## Using Categories in Reverie
You can categorize your content based on `categories` in Reverie. For this, you just need to add `categories` in front matter like below:
For adding single category:
```md
categories: JavaScript
```
For adding multiple categories:
```md
categories: [PHP, Laravel]
```
The categorized content can be shown over this URL:
## Pagination
Pagination of posts in Reverie works out-of-the-box. You only need to specify the number of posts you want on a single page in `_config.yml` and Reverie will take care of the rest.
```yml
paginate: 6
```
## RSS
Reverie comes with a [RSS feed](https://en.wikipedia.org/wiki/RSS) in-built. The generated RSS Feed of your blog can be found at . You can see the example RSS feed over [here](https://reverie-jekyll.netlify.app/feed.xml).
## Sitemap
The generated sitemap of your blog can be found at . You can see the example sitemap feed over [here](https://reverie-jekyll.netlify.app/sitemap.xml).
## Emailware
Reverie is an [emailware](https://en.wiktionary.org/wiki/emailware). Meaning, if you liked using this theme or it has helped you in any way, I'd like you send me an email at about anything you'd want to say about this software. I'd really appreciate it!
## The name?
reverie - _a state of being pleasantly lost in one's thoughts; a daydream._
/ˈrɛv(ə)ri/
## License
MIT
