|
| 1 | +<div align="center"> |
| 2 | + <br> |
| 3 | + <img src="/images/reverie-text.png" alt="Reverie" width="200"/> |
| 4 | + <br> |
| 5 | + <p align="center"> |
| 6 | + <i>Support my work via <a href="https://paypal.me/AmitMerchant">Paypal</a> or <a href="https://buymeacoffee.com/amitmerchant">Buy me a coffee</a></i> |
| 7 | + </p> |
| 8 | +</div> |
| 9 | + |
| 10 | +--- |
| 11 | + |
| 12 | +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. |
| 13 | + |
| 14 | +> [Theme demo](https://reverie.pages.dev/) |
| 15 | +
|
| 16 | +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. |
| 17 | + |
| 18 | + |
| 19 | + |
| 20 | +| Responsiveness | Search | Categories | |
| 21 | +|---------------------|----------------------|----------------------| |
| 22 | +| |  |  | |
| 23 | + |
| 24 | +# Table of Contents |
| 25 | + - [Features overview](#features-overview) |
| 26 | + - [Using Reverie on GitHub Pages](#using-reverie-on-github-pages) |
| 27 | + - [1. Fork Reverie to your User Repository](#1-fork-reverie-to-your-user-repository) |
| 28 | + - [2. Customize and view your site](#2-customize-and-view-your-site) |
| 29 | + - [3. Publish your first blog post](#3-publish-your-first-blog-post) |
| 30 | + - [Using Categories in Reverie](#using-categories-in-reverie) |
| 31 | + - [Pagination](#pagination) |
| 32 | + - [RSS](#rss) |
| 33 | + - [Sitemap](#sitemap) |
| 34 | + - [Emailware](#emailware) |
| 35 | + - [The name?](#the-name) |
| 36 | + - [License](#license) |
| 37 | + |
| 38 | +## Features overview |
| 39 | + |
| 40 | +- Clean and minimal design |
| 41 | +- Single column post layout |
| 42 | +- Command-line free fork-first workflow, using GitHub.com to create, customize and post to your blog |
| 43 | +- Fully responsive and mobile optimized theme |
| 44 | +- Sass/Coffeescript support using Jekyll 2.0 |
| 45 | +- Free hosting on your GitHub Pages user site |
| 46 | +- All the SEO goodies come built-in |
| 47 | +- Markdown blogging |
| 48 | +- Supports [Pullquotes](https://reverie-jekyll.netlify.app/pullquotes/) |
| 49 | +- Syntax highlighting using Pygments |
| 50 | + - [Dracula syntax theme](https://draculatheme.com/) included |
| 51 | +- Disqus commenting |
| 52 | +- Social media icons |
| 53 | +- Google Analytics integration |
| 54 | +- Supports [Google Analytics 4](https://support.google.com/analytics/answer/10089681?hl=en) |
| 55 | +- Fuzzy search across blog posts |
| 56 | +- Blog with pagination |
| 57 | +- Categorize posts out-of-the box |
| 58 | +- RSS Feed |
| 59 | +- Built-in sitemap |
| 60 | + |
| 61 | +> <p><i>Like this theme?</i> If so, consider donating a small amount that will help my maintaining this project further.<p> |
| 62 | +> You can support me via <a href="https://paypal.me/AmitMerchant">Paypal</a>. |
| 63 | +
|
| 64 | +## Using Reverie on GitHub Pages |
| 65 | + |
| 66 | +Setting up Reverie on GitHub Pages is as simple as it gets! |
| 67 | + |
| 68 | +### 1. Fork Reverie to your User Repository |
| 69 | + |
| 70 | +Fork this repository, then rename the repository to `yourgithubusername.github.io`. |
| 71 | + |
| 72 | +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. |
| 73 | + |
| 74 | +Your Jekyll blog will often be viewable immediately at <https://yourgithubusername.github.io> (if it's not, you can often force it to build by completing step 2). |
| 75 | + |
| 76 | +### 2. Customize and view your site |
| 77 | + |
| 78 | +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. |
| 79 | + |
| 80 | +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 <https://yourgithubusername.github.io> - if not, give it ten minutes as GitHub suggests and it'll appear soon. |
| 81 | + |
| 82 | +### 3. Publish your first blog post |
| 83 | + |
| 84 | +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. |
| 85 | + |
| 86 | +> You can add additional posts in the browser on GitHub.com too! Just hit the <kbd>Create new file</kbd> 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 |
| 87 | +
|
| 88 | +## Using Categories in Reverie |
| 89 | + |
| 90 | +You can categorize your content based on `categories` in Reverie. For this, you just need to add `categories` in front matter like below: |
| 91 | + |
| 92 | +For adding single category: |
| 93 | + |
| 94 | +```md |
| 95 | +categories: JavaScript |
| 96 | +``` |
| 97 | + |
| 98 | +For adding multiple categories: |
| 99 | + |
| 100 | +```md |
| 101 | +categories: [PHP, Laravel] |
| 102 | +``` |
| 103 | + |
| 104 | +The categorized content can be shown over this URL: <https://yourgithubusername.github.io/categories/> |
| 105 | + |
| 106 | +## Pagination |
| 107 | + |
| 108 | +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. |
| 109 | + |
| 110 | +```yml |
| 111 | +paginate: 6 |
| 112 | +``` |
| 113 | +
|
| 114 | +## RSS |
| 115 | +
|
| 116 | +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 <https://yourgithubusername.github.io/feed>. You can see the example RSS feed over [here](https://reverie-jekyll.netlify.app/feed.xml). |
| 117 | +
|
| 118 | +## Sitemap |
| 119 | +
|
| 120 | +The generated sitemap of your blog can be found at <https://yourgithubusername.github.io/sitemap.xml>. You can see the example sitemap feed over [here](https://reverie-jekyll.netlify.app/sitemap.xml). |
| 121 | +
|
| 122 | +## Emailware |
| 123 | +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 <[email protected]> about anything you'd want to say about this software. I'd really appreciate it! |
| 124 | +
|
| 125 | +## The name? |
| 126 | +
|
| 127 | +reverie - _a state of being pleasantly lost in one's thoughts; a daydream._<br><sup>/ˈrɛv(ə)ri/</sup> |
| 128 | +
|
| 129 | +
|
| 130 | +## License |
| 131 | +
|
| 132 | +MIT |
0 commit comments