Skeria

Hugo site generator theme inspired by

Jekyll "Hyde" theme;
Hugo "Hyde-X" theme.

Please visit the live site using Skeria and the corresponding source code.

Installation

$ cd your_site_repo/
$ mkdir themes
$ cd themes
$ git clone https://github.com/dschrempf/skeria

See the official Hugo themes documentation for more info.

Usage

This theme expects a relatively standard Hugo blog/personal site layout:

.
└── content
    ├── post
    |   ├── post1.md
    |   └── post2.md
    ├── license.md        // Used in the navbar footer link.
    └── other_page.md     // May be used as a menu entry (e.g., 'About').

Just run hugo --theme=skeria to generate your site or specify theme = skeria in your config.toml.

Configuration

An example of what your site's config.toml could look like. All theme-specific parameters are under [params] and standard Hugo parameters are used where possible.

baseurl = "https://elias.example.page"
title = "Elias's blog"

languageCode = "en-us"
disqusShortname = "elias"
MetaDataFormat = "toml"

theme = "skeria"
paginate = 30

[outputs]
    home = ["HTML", "JSON"]

[author]
    name = "Elias Schneider"

[permalinks]
    post = "/blog/:year/:month/:day/:title/"

[taxonomies]
    category = "categories"

[markup]
  [markup.highlight]
    codeFences = true
    guessSyntax = false
    hl_Lines = ""
    lineNoStart = 1
    lineNos = false
    lineNumbersInTable = false
    noClasses = true
    style = "tango"
    tabWidth = 2
  [markup.goldmark.renderer]
    unsafe= true

# All parameters below here are optional and can be mixed and matched.
[params]
    # Used when a given page doesn't set its own.
    defaultDescription = "Interesting content."
    defaultKeywords = "Interesting keywords."

    # Displays under the title, keep it short. You can use markdown here.
    tagline = "A collection of articles about Linux, Emacs, coding and music."

    # Navbar social links, these must be full URLs.
    github = ""
    bitbucket = ""
    stackOverflow = ""
    linkedin = ""
    googleplus = ""
    facebook = ""
    mastodon = ""
    youtube = ""
    orcid = ""
    flattr = ""
    
    # Mailto link.
    email = "mailto:elias@gmail.com"

    # GPG key.
    gpgkey = "/gpg_public_key.txt"

    # RSS.
    rss = false

    # Privacy statement link.
    privacyPolicy = "https://www.iubenda.com/privacy-policy/76967501"

# Additional menu entries in navbar.
[[menu.main]]
    url = "/posts/"
    name = "Posts"
    weight = 2

Tips

Pages where you specify menu = "main" in the front matter will be linked in the navbar just below the Blog link.
Hugo makes it easy to override theme layout and behaviour, read about it here.
Pagination is set to 30 items by default, change it by updating paginate = 30 in your config.toml.

Questions, ideas, bugs, pull requests?

All feedback is welcome! Head over to the issue tracker.

License

Open sourced under the MIT License.

External libraries

Content:

Search:

dschrempf / skeria