# Hugo Theme Massively

![](https://img.shields.io/badge/Hugo-%5E0.54.0-ff4088?style=flat-square&logo=hugo) [![e2e tests](https://github.com/curtiscde/hugo-theme-massively/actions/workflows/e2e.yml/badge.svg)](https://github.com/curtiscde/hugo-theme-massively/actions/workflows/e2e.yml)

Massively theme ported from [HTML5 UP](https://html5up.net/) for use with the [Hugo static site generator](https://gohugo.io/).

![](images/device-screenshots.png)

## Demo

https://hugo-theme-massively.netlify.com/

## Setup

### Configuration

See the demo's configuration as an example:

https://github.com/curtiscde/hugo-theme-massively/blob/master/exampleSite/config-prod.toml

#### Hugo Internal Templates
The theme currently also supports the following ["internal templates" supplied by Hugo](https://gohugo.io/templates/internal/)

 - [Disqus](https://gohugo.io/templates/internal/#disqus)
 - [Google Analytics](https://gohugo.io/templates/internal/#configure-google-analytics)

### Cover Image
The cover image URL is hard-coded, therefore to replace this add an image to the following location in your Hugo application:

```
/static/images/bg.jpg
```

### Supported Languages
 - [English](https://github.com/curtiscde/hugo-theme-massively/blob/master/i18n/en.toml)
 - [Dutch](https://github.com/curtiscde/hugo-theme-massively/blob/master/i18n/nl.toml)
 - [French](https://github.com/curtiscde/hugo-theme-massively/blob/master/i18n/fr.toml)
 - [Japanese](https://github.com/curtiscde/hugo-theme-massively/blob/master/i18n/ja.toml)
 - [Simplified Chinese](https://github.com/curtiscde/hugo-theme-massively/blob/master/i18n/zh.toml)
 - [Spanish](https://github.com/curtiscde/hugo-theme-massively/blob/master/i18n/es.toml)

## Custom Front Matter
 - `disableComments` - If set to `true` this will disable comments on the post when Disqus is enabled.

## Custom `<head>`

If you wish to add custom CSS overrides, or other elements in the `<head>`, then this can be done by adding the following to the root of your Hugo app: `layouts/partials/htmlhead.custom.html`. Any content added to this file will then be injected at the end of the `<head>`.

## Development
### Example Site Production Deployment
#### Production Deployment

```
$ cd exampleSite
$ hugo --config config-prod.toml
```

#### Running Locally

```shell
$ npm i
$ npm run hugo-dev
```
OR
```shell
$ cd exampleSite
$ hugo server --themesDir ../..
```

## Original Theme Credits

 - [Massively by HTML5 UP](https://html5up.net/massively)

 ## License

This hugo theme is licensed under the [Creative Commons Attribution 3.0 License](https://creativecommons.org/licenses/by/3.0/). 

Read More - [LICENSE](LICENSE)
