Anubis2 is a simple but elegant theme for Hugo blog engine

Go to file

Thorsten 2a20fd917e Merge pull request #1 from thenktor/patch-1 Create de.yaml		2020-07-25 23:01:09 +02:00
archetypes	initial commit	2020-01-12 09:51:51 +03:00
exampleSite	Dark theme	2020-07-09 22:15:38 +03:00
exampleSiteMultilingual	Dark theme	2020-07-09 22:15:38 +03:00
i18n	Create de.yaml	2020-07-24 23:40:59 +02:00
images	Dark theme	2020-07-09 22:15:38 +03:00
layouts	Update footer.html	2020-07-25 22:47:39 +02:00
static/css	Update style.css	2020-07-25 22:48:45 +02:00
LICENSE	initial commit	2020-01-12 09:51:51 +03:00
README.md	Add custom JS support. CLose #42	2020-07-09 22:42:23 +03:00
theme.toml	change theme config from yaml to toml	2020-02-16 20:43:53 +03:00

README.md

Anubis Theme for Hugo

Anubis is a simple minimalist theme for Hugo blog engine.

Features

Dark mode (automatic, by switcher)
Pagination
Tags/Categories support
Archive
Mobile support
Google Analytics
Disqus
RSS feeds
Translations (en, ru, fr, pl)
Custom CSS/JS
Multilingual mode
Robots.txt
Favorite posts
Pagination on post single page

Installation

Inside the folder of your Hugo site run:

$ git submodule add https://github.com/mitrichius/hugo-theme-anubis.git themes/anubis

For more information read the official setup guide of Hugo.

Getting started

After installing the theme successfully it requires a just a few more steps to get your site running.

Update config file

If you have toml config (which is by default), you should rename it to config.yaml or adapt this config for toml syntax.

Example of config.yaml:

languageCode: "en-us"
baseUrl: ""
title: "Anubis"
theme: "anubis"
paginate: 10
disqusShortname: yourdiscussshortname
googleAnalytics: UA-123-45
enableRobotsTXT: true

menu:
  main:
  - identifier: archive
    name: Archive
    title: Archive
    url: /posts/
    weight: 0

params:
  author: ""
  description: ""
  images:
    - images/og-featured.png # relative path to "static" directory
  customCSS:
    - css/my.css # relative path to "static" directory
  customJS:
    - js/main.js # relative path to "static" directory
  dateFormat: "2006-01-02"
  paginationSinglePost: true
  style: light-without-switcher

markup:
  goldmark:
    renderer:
      unsafe: true # enable raw HTML in Markdown

Check your site

In order to see your site in action, run Hugo's built-in local server.

$ hugo server

Now enter localhost:1313 in the address bar of your browser.

Feature Settings

Dark Mode

Customize via style param in params section of config. Options:

light-without-switcher - light theme, without switcher, JS-free (by default)
dark-without-switcher - dark theme, without switcher, JS-free
auto-without-switcher - theme based on user system settings, without switcher, JS-free
light - light theme by default, can be switched by user to dark theme and back. Theme settings are saved for user
dark - dark theme by default, can be switched by user to light theme and back. Theme settings are saved for user
auto - theme based on user system settings by default, can be switched by user to dark/light theme. Theme settings are saved for user

Google Analytics

Only works for production environment. You either build your site with variable like HUGO_ENV=production hugo --minify or just put env: production to params section of config.

Multilingual mode

Check config/example usage in exampleSiteMultilingual directory and documentation on Hugo site.

Robots.txt

Based on environment.
For production — allow all, for other — disallow all.

Favorite posts

To mark posts as favorite just add favorite: true in post's front matter. It adds a "★" icon nearby post's title.

Pagination on post single page

Enabled by paginationSinglePost param in params section of config.

Contributing

If you find a bug or have an idea for a feature, feel free to write an issue.

TODO

See issues.

License

MIT