Anubis is a simple minimalist theme for Hugo blog engine. This is a fork of the theme for my personal use.
You need to install an extended version of Hugo to run this theme.
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.
After installing the theme successfully it requires a just a few more steps to get your site running.
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 enableRobotsTXT: true menu: main: - identifier: archive name: Archive title: Archive url: /posts/ weight: 0 params: author: "John Doe" email: email@example.com # used for microformats avatar: "/images/me.png" # used for microformats description: "" # Uncomment if you need this # images: # - images/og-featured.png # relative path to "static" directory # customCSS: # - css/my.css # relative path to "assets" directory (don't use main.css filename) # customJS: # - js/main.js # relative path to "assets" directory dateFormat: "2006-01-02" paginationSinglePost: true style: light-without-switcher readMore: false disableSummary: false # utteranc.es support utterancesRepo: "" # mandatory utterancesTheme: "" # optional utterancesIssue: "" # optional utterancesLabel: "" # optional webmentions: url: https://yourdomain.com/webemntions/receive login: hugo-theme-anubis pingback: true social: - id: github name: gohugoio # - id: hugo # url: "https://gohugo.io/" # icon: "hugo" markup: goldmark: renderer: unsafe: true # enable raw HTML in Markdown
In order to see your site in action, run Hugo's built-in local server.
$ hugo server
localhost:1313 in the address bar of your browser.
style param in
params section of config.
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
To add icon from predefined list, add to
- id: github name: gohugoio
Config like this generate github icon with "https://github.com/gohugoio" url.
For Fediverse (Mastodon-style) instances, you would need to supply the instance's domain as URL.
- id: mastodon name: huy_ngo instance: fosstodon.org url: "https://fosstodon.org/@%s"
To add custom icon, add to
static/fa-iconsand add svg icon of your network/site with name equals to
- id: google url: "https://www.google.com/search?q=I'm+lucky"
Icon should be "static/fa-icons/google.svg"
If you want font awesome icons, download "Font Awesome For Desktop" and open svg directory.
Based on environment.
For production — allow all, for other — disallow all.
To mark posts as favorite just add
favorite: true in post's front matter. It adds a "★" icon nearby post's title.
To hide a post from the RSS feed, just add
disable_feed: true to its front matter.
paginationSinglePost param in
params section of config.
To provide webmention support you can either specify your webmention.io username with
login: webmentionusername or specify a link to your custom webmention endpoint with
If you use webmention.io you can also enable pingback with
If you find a bug or have an idea for a feature, feel free to write an issue or make a PR.
© Dmitry Kolosov 2020
© Ngô Ngọc Đức Huy 2021