Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aerohub/hugo-identity-theme

Little profile/card-style template for Hugo. Based on Identity by HTML5 UP.
https://github.com/aerohub/hugo-identity-theme

card-template hugo hugo-site hugo-theme identity personal-website

Last synced: 3 months ago
JSON representation

Little profile/card-style template for Hugo. Based on Identity by HTML5 UP.

Awesome Lists containing this project

README

        

# Hugo Identity Theme

Hugo Identity Theme is based on [Identity template by HTML5 UP](https://html5up.net/identity). It was ported to Hugo for training and fun. It is rather configurable and flexible despite it's simplicity.

## Demo

[Demo on themes.gohugo.io](https://themes.gohugo.io/theme/hugo-identity-theme/)

## Features

- Responsive design
- Configurable appearance
- Configurable social links
- Contact form
- Google Analytics

## Screenshot

![Hugo Identity Theme screenshot](https://raw.githubusercontent.com/aerohub/hugo-identity-theme/master/images/screenshot.png)

## Contents

- [Installation](#installation)
- [Getting started](#getting-started)
- [The config file](#the-config-file)
- [Make the contact form working](#make-the-contact-form-working)
- [Nearly finished](#nearly-finished)
- [Custom Styling](#custom-styling)
- [Contributing](#contributing)
- [License](#license)
- [Annotations](#annotations)

## Installation

Inside the folder of your Hugo site run:

$ mkdir themes
$ cd themes
$ git clone https://github.com/aerohub/hugo-identity-theme

For more information read the official [setup guide](https://gohugo.io/overview/installing/) of Hugo.

## Getting started

After installing the Identity Theme successfully it requires a just a few more steps to get your site running.

### The config file

Take a look inside the [`exampleSite`](https://github.com/aerohub/hugo-identity-theme/tree/master/exampleSite) folder of this theme. You'll find a file called [`config.toml`](https://github.com/aerohub/hugo-identity-theme/blob/master/exampleSite/config.toml). To use it, copy the [`config.toml`](https://github.com/aerohub/hugo-identity-theme/blob/master/exampleSite/config.toml) in the root folder of your Hugo site. Feel free to change the strings in this theme. Play with already placed avatars and background images or use yours.

### Make the contact form working

Since this page will be static, you can use [formspree.io](https://formspree.io/) as proxy to send the actual email. Each month, visitors can send you up to one thousand emails without incurring extra charges. Begin the setup by following the steps below:

1. Enter your email address under 'email' in the [`config.toml`](https://github.com/aerohub/hugo-identity-theme/blob/master/exampleSite/config.toml)
2. Enable form by setting `enable` to `true` in contact settings
3. Upload the generated site to your server
4. Send a dummy email yourself to confirm your account
5. Click the confirm link in the email from [formspree.io](https://formspree.io/)
6. You're done. Happy mailing!

### Nearly finished

In order to see your site in action, run Hugo's built-in local server.

$ hugo server -w

Now enter `localhost:1313` in the address bar of your browser.

# Custom Styling
To edit the css this theme uses, add your CSS to the assets folder then include it as part one of the `[params]` with the label `custom_css`. More information and an example can be found in the example [`config.toml`](exampleSite/config.toml) file.

## Contributing

Did you found a bug or got an idea for a new feature? Feel free to use the [issue tracker](https://github.com/aerohub/hugo-identity-theme/issues) to let me know. Or make directly a [pull request](https://github.com/aerohub/hugo-identity-theme/pulls).

## License

This work is licensed under the Creative Commons Attribution 3.0 Unported License. For more information read the [License](https://github.com/aerohub/hugo-identity-theme/blob/master/LICENSE.md).

## Annotations

Thanks

- to [spf13](https://github.com/spf13) for creating Hugo and the awesome community around the project
- to [digitalcraftsman](https://github.com/digitalcraftsman) for creating Hugo themes and writing nice READMEs
- to [n33](https://github.com/n33), (of course!) for original Identity Theme