Vitae

... is a blog theme for Hugo that focuses on your content.

Redesign

The theme is now completely rewritten from scratch. In the future it will now be easier to make improvments to the theme.

If you notice anything, please write an issue.

Demo

You can have a look on https://themes.gohugo.io. Link to demo

List of Features

Here is a short list with some of the features that are available for Hugo-Vitae.

For more explanation about various features, scroll down to Features

Easy to use, even with GDPR in mind
Improved part for SEO
Optimized responsiveness for all kinds of devices
Multilingual support for month names and other fixed strings
Various front matter and configuration options for more flexible use.
RSS feed
Disqus comments (optional)
Google Analytics integration (optional)
Twitter cards and Open Graph tags integration
And some other cool features...

Installation

Stable

Download the latest stable release. It's available as .zip or .tar.gz. Decompress it into your themes/ folder.

Development

Change your current work directory into the root directory of your Hugo site and clone the repository:

cd themes
git clone https://github.com/datacobra/hugo-vitae.git hugo-vitae

For more information about installation read the official setup guide of Hugo.

Features

GDPR in mind

The GDPR has many rules for third party assets, so if you don't want to think about GDPR complaints you can disable every third party asset that is integrated.

Some websites using webfonts from third party sites like google. This theme brings FontAwesome and Roboto(-Slab) directly with it, without having to integrate them via third party sites.

Multilingual support for month names and fixed strings

month names

Due to the currently unavailable feature for multilingual dates in .Date from Go. It is possible to create a month.yaml in the data folder of your Hugo site root directory. There is also an example file in exampleSite/data/.

cat > month.yaml << EOF
1: "Jan"
2: "Feb"
3: "Mar"
4: "Apr"
5: "May"
6: "Jun"
7: "Jul"
8: "Aug"
9: "Sep"
10: "Oct"
11: "Nov"
12: "Dec"
EOF

fixed strings

There are some fixed strings in the html files that normally uses only the set language. But if you create a folder i18n/ in the root directory of your hugo site and copy the en.yaml that comes with the theme you can edit the fixed strings to your liking. Don't forget to also set defaultContentLanguage = "en" to the new language.

mkdir i18n
cd i18n
cp ../themes/hugo-vitae/i18n/en.yaml en.yaml
# Edit the new language file

FontAwesome for social icons

FontAwesome is mainly used for the icons of the social navbar in the top right corner of the theme. In the config of your Hugo website there is a param called icon for the params.social section. I could look like this:

[[params.social]]
name = "Github"
icon = "fab fa-github"
url = "https://github.com/dataCobra/hugo-vitae"

On the FontAwesome website, you can look up every free icon and also the information you need to put into this icon param.

Site configuration options

All configuration options can be looked up in the exampleSite/config.toml.

Front matter options

math(bool)

Add math typesetting with KaTeX to the content page.

author(string) and authorlink(string)

Add author of a page and if you want, add a link to the author.

nofeed(bool)

Don't add page to RSS.

notaxonomy(list)

Disable specific taxonomies for a page.

disqus(bool)

Enable/Disable Disqus for this specific page.

hidden(bool)

Hide page from the mainSection of the homepage.

norobots(bool)

Disallow page in robots.txt for search engines.

nodate(bool)

Hide the publish date of the page. Useful for about pages or pages required for legal reasons.

Credits

hugo-ink from which Vitae was forked
freepik for the avatar
google for the roboto fonts
fontawesome for providing amazing icons

Licensed under the GPL-2.0.

hikhvar/hugo-vitae