Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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.
- Host: GitHub
- URL: https://github.com/aerohub/hugo-identity-theme
- Owner: aerohub
- License: other
- Created: 2016-03-31T15:43:08.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2023-08-14T11:36:07.000Z (over 1 year ago)
- Last Synced: 2024-10-27T14:43:43.537Z (3 months ago)
- Topics: card-template, hugo, hugo-site, hugo-theme, identity, personal-website
- Language: JavaScript
- Homepage:
- Size: 2.36 MB
- Stars: 89
- Watchers: 3
- Forks: 44
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
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-themeFor 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