~kiera/smol

fork of https://github.com/colorchestra/smol
626b9750 — nablachi a month ago
add up to h6
2ffacd1c — nablachi a month ago
header indent
d6cf9d9e — nablachi a month ago
header size changes again

refs

master
browse  log 

clone

read-only
https://git.m.akagi.moe/~kiera/smol
read/write
git@git.m.akagi.moe:~kiera/smol

You can also use your local clone with git send-email.

#smol

A minimal, monospaced blogging theme for Hugo that respects your privacy and is easy on your bandwidth. A demo can be found at https://smol-demo.morph.sh.

smol is based on Blank created by Vimux.

Screenshot

#Features

  • No JavaScript
  • No Google spyware or tracking of any kind
  • No other external dependencies, embedded fonts or comment sections
  • Dark mode support (depending on your OS's setting)

#Installation

In your Hugo site themes directory, run:

git clone https://github.com/colorchestra/smol

Next, open config.toml in the base of the Hugo site and ensure the theme option is set to smol.

theme = "smol"

Lastly, add the following lines to your config.toml to set site parameters and make use of all the menu entries in the header and footer sections if you need them.

# Parameters
[params]
    subtitle = "Your blog subtitle goes here!"
    dateFmt = "02.01.2006 15:04"

# Header
[menu]
  [[menu.main]]
        identifier = "posts"
        name = "Posts"
        url = "/posts/"
        weight = 1 

  [[menu.main]]
        identifier = "categories"
        name = "Categories"
        url = "/categories/"
        weight = 2 

  [[menu.main]]
        identifier = "tags"
        name = "Tags"
        url = "/tags/"
        weight = 3

# Footer
  [[menu.footer]]
        name = "Github"
        url = "https://github.com/example"
        weight = 1 

    [[menu.footer]]
        name = "Mastodon"
        url = "https://example.com/@user"
        weight = 2 

    [[menu.footer]]
        name = "Imprint"
        url = "/imprint"
        weight = 3 

For more information read the official quick start guide of Hugo.

#Optional features

Add copyright = "Your text here" - in the config.toml to change the copyright notice in the footer.

#Image captions

You can add captions to images (technically using <figcaption> HTML tags) by adding titles, like so: ![Alt text here](/path/to/image.png "Put your caption here!")

#Contributing

Have you found a bug or got an idea for a new feature? Feel free to use the issue tracker to let me know. Or make directly a pull request.

#License

This theme is released under the MIT license.