hermit-V2/README.md

153 lines
7.7 KiB
Markdown
Raw Normal View History

2023-06-20 04:18:13 -04:00
# Hugo theme Hermit - V2
2018-10-23 01:15:50 -04:00
2023-07-09 11:50:08 -04:00
Initially, when I started my Blog journey, I was enthralled by this very theme and I am using it since. However, original developer has ceased maintaining the theme and it is riddled with many bugs. Hence, I have taken upon myself to maintain this theme.
2023-06-20 04:18:13 -04:00
2023-07-09 11:50:08 -04:00
I fully intend to keep the essence of the theme as-it-is and only add minor updates and squash bugs which may arise.
2023-06-20 04:18:13 -04:00
2023-07-09 11:50:08 -04:00
> Let's make __Hermit__ great again
2023-07-09 12:10:00 -04:00
DEMO : [Hermit-V2](https://1bl4z3r.github.io/hermit-V2/)
2023-08-06 08:57:33 -04:00
GoHugo Theme Page : [https://themes.gohugo.io/themes/hermit-v2/](https://themes.gohugo.io/themes/hermit-v2/)
2023-08-19 03:24:17 -04:00
### Installation
Run this command from the root of your Hugo directory:
```bash
git clone https://github.com/1bl4z3r/hermit-V2 themes/hermit-v2
```
Or, if your Hugo site is already in git, you can include this repository as a [git submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules). This makes it easier to update this theme. For this you need to run:
```bash
git submodule add https://github.com/1bl4z3r/hermit-V2 themes/hermit-v2
```
2023-10-15 08:13:22 -04:00
### Custom CSS and JS
I have found that there are some requirement where custom CSS and JS should be supplied to a page to make it work. This custom files are not required for whole of the site, but is restricted to a page or few particular pages. E.g. If you make contact form.
To provision for the same, I have added custom css and js. Please add this to page frontmatter as required.
```
custom_css = ["css/foo.css","css/bar.css"]
custom_js = ["js/custom-about.js"]
```
The files itself will reside in `static/css` for CSS files and `static/js` for JS files. Refer to [Staging Branch](https://github.com/1bl4z3r/hermit-V2/tree/staging) to have a feel on how [this](https://github.com/1bl4z3r/hermit-V2/blob/staging/content/about-hugo.md) is implemented.
2023-10-22 05:57:12 -04:00
### Demo
Demo page [https://1bl4z3r.github.io/hermit-V2/](https://1bl4z3r.github.io/hermit-V2/), which is both demo as well as documentation for the theme, is located in [Staging Branch](https://github.com/1bl4z3r/hermit-V2/tree/staging)
2023-10-15 08:13:22 -04:00
---
# Original README
2018-10-23 01:15:50 -04:00
Hermit is a minimal and fast theme for Hugo. It's built for bloggers who want a simple and focused website.
2023-10-15 08:34:18 -04:00
![](https://github.com/1bl4z3r/hermit-V2/blob/main/images/screenshot.png)
2018-10-23 01:15:50 -04:00
## Features
* A single-column layout and carefully crafted typography offers a great reading experience.
* Navigations and functions are placed in the bottom bar which will hide when you scroll down.
* Featured image is supported. It will be displayed as a dimmed background of the page.
* Displays all of your posts on a single page, with one section per year, simple and compact.
* Extremely lightweight and load fast. No third party framework, no unnecessary code.
* All code fields feature syntax highlighting and a code-copy function
2018-10-23 01:15:50 -04:00
* Responsive & Retina Ready. Scales gracefully from a big screen all the way down to the smallest mobile phone. Assets in vector format ensures that it looks sharp on high-resolution screens.
2023-10-15 08:34:18 -04:00
![](https://github.com/1bl4z3r/hermit-V2/blob/main/images/hermit.png)
2018-10-23 01:15:50 -04:00
## Getting started
### Installation
Run this command from the root of your Hugo directory:
2018-10-23 01:15:50 -04:00
```bash
$ git clone https://github.com/Track3/hermit.git themes/hermit
```
Or, if your Hugo site is already in git, you can include this repository as a [git submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules). This makes it easier to update this theme. For this you need to run:
```bash
$ git submodule add https://github.com/Track3/hermit.git themes/hermit
```
2018-10-23 01:15:50 -04:00
Alternatively, if you are not familiar with git, you can download the theme as a `.zip` file, unzip the theme contents, and then move the unzipped source into your `themes` directory.
For more information, read the official [documentation](https://gohugo.io/themes/installing-and-using-themes/) of Hugo.
### Configuration
The example config file can be found in the theme's `exampleSite` folder. You can just copy the `config.toml` to the root directory of your Hugo site. There are instructions in the example config file, feel free to change strings as you like to customize your website.
#### Favicon
Use [RealFaviconGenerator](https://realfavicongenerator.net/) to generate these files, put them into your site's `static` folder:
* android-chrome-192x192.png
* android-chrome-512x512.png
* apple-touch-icon.png
* favicon-16x16.png
* favicon-32x32.png
* favicon.ico
* mstile-150x150.png
* safari-pinned-tab.svg
* site.webmanifest
#### Social icons
The following icons are supported, please make sure the `name` filed is exactly one of these:
| name | | | |
| --------------- | ----------- | ------------ | --------- |
| `email` | `codepen` | `facebook` | `github` |
| `gitlab` | `instagram` | `linkedin` | `slack` |
| `stackoverflow` | `telegram` | `twitter` | `youtube` |
| `shutterstock` | `freepik` | `adobestock` | `123rf` |
2019-07-28 06:34:18 -04:00
| `dreamstime` | `dribbble` | `behance` | `paypal` |
2023-10-01 12:49:24 -04:00
| `twitch` | `qq` | `mastodon` | `discord` |
2018-10-23 01:15:50 -04:00
If that's not enough, you can see [Overriding templates](#overriding-templates) section.
2018-10-23 01:15:50 -04:00
### Manage content
* Keep your regular pages in the `content` folder. To create a new page, run `hugo new page-title.md`
* Keep your blog posts in the `content/posts` folder. To create a new post, run `hugo new posts/post-title.md`
### More customizations
#### Overriding templates
In Hugo, layouts can live in either the projects (root) or the themes layout folders, any template inside the root layout folder will override theme's layout that relative to it, for example: `layouts/_default/baseof.html` will override `themes/hermit/layouts/_default/baseof.html`. So, you can easily customize the theme without edit it directly, which makes updating the theme easier. Here's some common customizations:
##### Customize social icons
2018-12-31 04:09:40 -05:00
You can modify or add any svg icons in site's `layouts/partials/svg.html`.
##### Customize comment system
2018-12-31 04:09:40 -05:00
We only have built-in support for Disqus at the moment, if that doesn't fit your needs, you can just add html to site's `layouts/partials/comments.html`.
##### Add custom analytics
If you prefer to use different analytics system other than google analytics, then add them inside `layouts/partials/analytics.html`.
#### Customize CSS
If you'd like to customize theme color or fonts, you can simply override `assets/scss/_predefined.scss`, by simply copy it to site's root (keep the same relative path) then edit those variables. But keep in mind, you'll need **Hugo extended version** which has the ability to rebuild SCSS. You don't have to use extended version in production but in this case it's necessary to make sure the `resources` folder is committed and "up to date" (by running `hugo` or `hugo server` locally using the extended version). But anyway, always use the extended version if you can.
2018-12-31 04:09:40 -05:00
#### Code injection
You can inject any html code to every page's document head or right above the closing body tag. This makes it easier to add any html meta data, custom css/js, dns-prefetch etc. To do this you simply need to create a file at site's `layouts/partials/extra-head.html` or `layouts/partials/extra-foot.html`, code inside will be injected to every page.
2018-12-30 01:49:24 -05:00
2018-10-23 01:15:50 -04:00
## Acknowledgments
* [normalize.css](https://necolas.github.io/normalize.css/) - [MIT](https://github.com/necolas/normalize.css/blob/master/LICENSE.md)
* [animate.css](https://daneden.github.io/animate.css/) - [MIT](https://github.com/daneden/animate.css/blob/master/LICENSE)
* [feather](https://feathericons.com/) - [MIT](https://github.com/feathericons/feather/blob/master/LICENSE)
* [code-copy.js](assets/js/code-copy.js) - [Tom Spencer](https://www.fiznool.com/blog/2018/09/14/adding-click-to-copy-buttons-to-a-hugo-powered-blog/)
2018-10-23 01:15:50 -04:00
Thanks!