Repository files navigation

Hermit is a minimal and fast theme for Hugo. It's built for bloggers who want a simple and focused website.

• 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
• 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.

Theme Demo (uses contents and config from theexampleSite folder)

Run this command from the root of your Hugo directory:

$ 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 agit submodule. This makes it easier to update this theme. For this you need to run:

$ git submodule add https://github.com/Track3/hermit.git themes/hermit

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 yourthemes directory.

For more information, read the officialdocumentation of Hugo.

The example config file can be found in the theme'sexampleSite folder. You can just copy theconfig.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.

UseRealFaviconGenerator to generate these files, put them into your site'sstatic 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

The following icons are supported, please make sure thename filed is exactly one of these:

If that's not enough, you can seeOverriding templates section.

• Keep your regular pages in thecontent folder. To create a new page, runhugo new page-title.md
• Keep your blog posts in thecontent/posts folder. To create a new post, runhugo new posts/post-title.md

In Hugo, layouts can live in either the project’s (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 overridethemes/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:

You can modify or add any svg icons in site'slayouts/partials/svg.html.

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'slayouts/partials/comments.html.

If you prefer to use different analytics system other than google analytics, then add them insidelayouts/partials/analytics.html.

If you'd like to customize theme color or fonts, you can simply overrideassets/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 needHugo 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 theresources folder is committed and "up to date" (by runninghugo orhugo server locally using the extended version). But anyway, always use the extended version if you can.

For adding other custom CSS to the theme, you can assign an array of references inconfig.toml like following:

[params]  customCSS = ["css/foo.css", "css/bar.css"]

You may reference as many stylesheets as you want. Their paths need to be relative to thestatic folder or it can be a full URL for external resources.

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'slayouts/partials/extra-head.html orlayouts/partials/extra-foot.html, code inside will be injected to every page.

• normalize.css -MIT
• animate.css -MIT
• feather -MIT
• code-copy.js -Tom Spencer

Thanks!