hugo-snotra/README.md

98 lines
2.3 KiB
Markdown

# 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.
```bash
$ 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
```toml
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:
```toml
pluralizeListTitles = false
```
### Description
You can use some parameters to fill meta tags and bases images:
```toml
[params]
description = "" # Description for the meta tag
favicon = "" # Favicon URL
logo = "" # Logo URL
keyword = "" # Keywords for the meta tag
```
### 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.
```toml
[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:
```toml
[params]
twitterUser = "youruser" # Your Twitter account without @
```
### Custom CSS
```toml
[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:
```toml
[[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.