Hugo theme Snotra
Go to file
Gregory Trolliet c108ed7157 [THEME] Fix rss link depreciation 2023-08-21 08:56:25 +02:00
archetypes [LAYOUT] Remove empty image on archetype 2020-06-05 10:41:36 +02:00
data/snotra First standalone version 2020-04-28 12:26:34 +02:00
i18n [THEME] Add 'return to top' button 2020-09-22 15:02:00 +02:00
layouts [THEME] Fix rss link depreciation 2023-08-21 08:56:25 +02:00
static [THEME] Add a forgejo icon 2023-01-06 09:02:18 +01:00
CHANGELOG.md [SHORTCODE] Add better handling of favicon 2020-05-25 11:22:03 +02:00
LICENSE First standalone version 2020-04-28 12:26:34 +02:00
README.md [SHORTCODE] Add readme for the favicon handling 2020-05-25 11:25:30 +02:00
theme.toml First standalone version 2020-04-28 12:26:34 +02:00

README.md

Hugo theme : Snotra

This is a dark and classy Hugo theme.

Installation

To install Simple-site theme, you can simply clone the repository to your site's theme directory.

$ mkdir themes
$ cd themes
$ git clone https://git.vulgarisons.info/raghnarok/hugo_snotra.git snotra

Don't forget to change the theme in your config.toml file.

Configuration

Base

baseurl = "https://yourdoma.in" # The base url of your Hugo website
title = "Title"                 # The title of your website
author = "Author"               # The author of the website
language = "fr"
theme = "snotra"                # The Hugo theme

Menu

The menu is generated following all the files in the root directory and the articles in the blog directory. To avoid the blog entry to be pluralized, add the following option to your config file:

pluralizeListTitles = false

Description

You can use some parameters to fill meta tags and bases images:

[params]
	description = "" # Description for the meta tag
	favicon = ""     # Favicon URL
	logo = ""        # Logo URL
	keyword = ""     # Keywords for the meta tag

The favicon is only the filename, the file should be in static/images directory. If favicon isn't set, the default test values are favicon.svg and favicon.png. If none exists, there will be no favicon.

Home page

The home page use one avatar, the name, one description and a list of social networks. For the social networks, see Social Networks chapter.

[params]
	author = "Author"     # The author of the website
	info   = "Your infos" # Displayed under author name
	avatar = "file.png"   # Placed in static/images

Twitter:card

Twitter cards are automaticly generated. If you want tho have the twitter:site meta generated, add the following option to your config file:

[params]
	twitterUser = "youruser" # Your Twitter account without @

Custom CSS

[params]
	custom_css = ["style.css"] # Your own css files

Social Networks

You can also set some of your networks accounts to display on the home page. Every social network (or not so network) have to be described with thoses options:

[[params.social]]
	name   = "Title of the entry"            # Title, used on hover
	icon   = "facebook"                      # Icon to use
	weight = 1                               # Sort order
	url    = "https://www.facebook.com/user" # Link to your account

You can also add some non social elements, you only need to have an icon.