jeffreyalles/hugo-identity-theme

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

Hugo Identity Theme

Hugo Identity Theme is based on Identity template by HTML5 UP. 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

Features

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

Screenshot

Contents

• Installation
• Getting started
  • The config file
  • Make the contact form working
  • Nearly finished
  • Custom Styling
• Contributing
• License
• 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 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 folder of this theme. You'll find a file called config.toml. To use it, copy the 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 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
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
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 file.

Contributing

Did you found a bug or got an idea for a new feature? Feel free to use the issue tracker to let me know. Or make directly a pull request.

License

This work is licensed under the Creative Commons Attribution 3.0 Unported License. For more information read the License.

Annotations

Thanks

• to spf13 for creating Hugo and the awesome community around the project
• to digitalcraftsman for creating Hugo themes and writing nice READMEs
• to n33, (of course!) for original Identity Theme