8000 GitHub - simonsan/hugo-universal-theme: Port of the Universal theme to Hugo
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

simonsan/hugo-universal-theme

BranchesTags
 
 

Repository files navigation

Universal Theme for Hugo

Build Status Code Climate

Universal is a clean and stylish website template built with Bootstrap. It stands out with its clean design and elegant typography.

This Hugo theme was ported from Bootstrapious for training and fun. It has a very nice and customizable landing page, a comments system by Disqus, site search by Google, contact forms by Formspree, Google Analytics, and optional widgets for the sidebar.

screenshot

Table of Contents

Features

  • Responsive design
  • Customizable landing page
    • Carousel
    • Testimonials
    • Features
    • Customers
    • Recent posts
  • Layout
    • Accordion
  • Contact form by Formspree
  • Google search
  • Disqus comments
  • Google Analytics

Installation

Go to the directory where you have your Hugo site and run:

$ mkdir themes
$ cd themes
$ git clone https://github.com/devcows/hugo-universal-theme

For more information read the official setup guide of Hugo.

Configuration

After installing the Universal theme successfully, we recommend you to take a look at the exampleSite directory. You will find a working Hugo site configured with the Universal theme that you can use as a starting point for your site.

First, let's take a look at the config.toml. It will be useful to learn how to customize your site. Feel free to play around with the settings.

Language

Available translations are in the /i18n directory. You can configure the language modifying the following key.

defaultContentLanguage = "en"

Style

You can change the color of the theme by modifying the following key.

style = "default"

Available options are: default (light-blue), blue, green, marsala, pink, red, turquoise, violet.

Comments

The optional comments system is powered by Disqus. If you want to enable comments, create an account in Disqus and write down your shortname.

disqusShortname = "devcows"

You can disable the comments system by leaving the disqusShortname empty.

Google Analytics

You can optionally enable Google Analytics. Type your tracking code in the ``.

googleAnalytics = "UA-XXXXX-X"

Leave the googleAnalytics key empty to disable it.

Logo

You can select the logos using the logo and logo_small parameters. The logo_small value will be used when the site is rendered on small screens.

Contact form

You can optionally create a contact page and include a contact form.

A contact page is just like a regular Hugo page. But it must include the field id with the value contact.

+++
title = "Contact"
id = "contact"
+++

You can optionally add the google maps widget defining latitude and longitude in the section params at config.toml. On pin click opens Google Maps directions with the coordinates. Additionally you can define direction if you want to have a different target set for directions or the google maps entry of your company.:

[params]
    ...
    latitude = "-12.043333"
    longitude = "-77.028333"
    direction = "Desamparados Station, Distrito de Lima 15001, Peru"

Since this Hugo sites are static, the contact form uses Formspree as a proxy. The form makes a POST request to their servers to send the actual email. Visitors can send up to a 1000 emails each month for free.

To enable the form in the contact page, just type your Formspree email in the config.toml file, and specify whether to use ajax(paid) to send request or plain HTTP POST(free).

[params]
email = "your@email.com"
contact_form_ajax = false

Menu

You can also define the menu items that will appear in the top bar. Edit the [[params.menu]] entries to create your menu.

[[params.menu]]
    name = "Contact"
    url  = "/contact"
    weight = 4

Important: Do not change the identifier key of existing menu entries!

The weight parameter will determine the order of the menu entries. A top level menu item can contain a dropdown with an optional image, sections and multiple columns of menu items.

To create a single list of menu items in the dropdown, first give your top level menu item unique identifier:

[[menu.main]]
    name       = "Home"
    identifier = "menu.home"
    url        = "/"
    weight     = 1

Now create additional menu items and use the above unique identifier as the value for the parent attribute:

[[menu.main]]
    name       = "Option 1: Default Page"
    url        = "/"
    weight     = 1
    parent     = "menu.home"

[[menu.main]]
    name       = "Option 2: Application"
    url        = "/"
    weight     = 2
    parent     = "menu.home"

It is also possible to display a dropdown menu with 4 columns. This theme supports 2 variations:

  • 4 columns of menu items with sections
  • 2 column wide image + 2 columns of menu items with sections

To display 4 columns of menu items, start using sections. Sections are menu items threated special by this theme:

[[menu.main]]
    name       = "All Pages"
    identifier = "menu.allpages"
    url        = ""
    weight     = 4

[[menu.main]]
    name       = "Home"
    identifier = "section.ap-home"
    url        = ""
    weight     = 1
    parent     = "menu.allpages"
    post       = 1

[[menu.main]]
    name       = "Portfolio"
    identifier = "section.ap-portfolio"
    url        = ""
    weight     = 1
    parent     = "menu.allpages"
    post       = 2

[[menu.main]]
    name       = "Shop"
    identifier = "section.ap-shop"
    url        = ""
    weight     = 1
    parent     = "menu.allpages"
    post       = 3

[[menu.main]]
    name       = "Blog"
    identifier = "section.ap-blog"
    url        = ""
    weight     = 3
    parent     = "menu.allpages"
    post       = 4

[[menu.main]]
    name       = "Blog Listing Big"
    url        = "/blog/"
    weight     = 1
    parent     = "section.ap-blog"

The above example shows a reduced version of the All Pages menu item from the example site. As you can see, we first create menu items with an identifier starting with section.. If you create entries like this, these will appear as section headers in your drop down.

Each of these entries contain values for both the weight and post attribute. The post attribute is hijacked to indicate in which column a section will be put in. Within a column, the weight value is respected to show the sections top to bottom.

Use to the unique section identifier (e.g. section.ap-blog) as the parent value to add a menu item to a specific section. Using weight and post on the sections allow you to balance the columns with approximately the same amount of entries.

To display a 2 column wide image and 2 columns of menu items, the process is similar as above. However, we hijack the url field of the top level menu item to link the image from our static assets:

[[menu.main]]
    name       = "Portfolio"
    identifier = "menu.portfolio"
    url        = "/img/template-homepage.png"
    weight     = 3

When a url is filled in, only column 1 and 2 (the post value in the section menu items) will be displayed. When using an image, don't configure section menu items in column 3 or 4. These will not be rendered.

Sidebar widgets

You can enable/disable the sidebar widgets that will be shown in the blog section. The following widgets are currently available:

  • Search bar (powered by Google)
  • Categories list
  • Tags list

You can enable/disable them under params.widgets.

[params.widgets]
    search = true
    categories = true
    tags = true

Top bar

The top bar is typically used to provide contact information and social links. It is disabled by default, and it can be enabled inside the params.topbar settings.

[params.topbar]
    enable = true
    text = "<p>Contact us on +420 777 555 333 or hello@universal.com.</p>"

The text shows up on the left side and accepts HTML.

The social links on the right side are configured as a top-level menu.

[[menu.topbar]]
    weight = 1
    name = "GitHub"
    url = "https://github.com/devcows/hugo-universal-theme"
    pre = "<i class='fas fa-2x fa-github'></i>"

[[menu.topbar]]
    weight = 2
    name = "Facebook"
    url = "http://facebook.com"
    pre = "<i class='fas fa-2x fa-facebook'></i>"

Blog post thumbnails

After creating a new post you can define a banner by entering the relative path to the image.

banner = "img/banners/banner-4.jpg"

It must contain a relative path to the banner inside the static directory.

Landing page

The landing page consists in many sections that can be activated and configured individually. Let's go through all sections from top to bottom.

Carousel

The carousel content is configured in the data directory.

data
└── carousel
    ├── customizable.yaml
    ├── design.yaml
    ├── features.yaml
    └── multipurpose.yaml

Each carousel entry is represented as a YAML file inside data/carousel. Let's see the customizable.yaml as an example of a carousel entry.

weight: 4
title: "Easy to customize"
description: >
  <ul class="list-style-none">
    <li>7 preprepared colour variations.</li>
    <li>Easily to change fonts</li>
  </ul>
image: "img/carousel/template-easy-code.png"

The weight field determines the position of the entry. title is a text-only field. The description field accepts HTML code. And the image must contain the relative path to the image inside the static directory.

Once the carousel is configured, it must be explicitly enabled in the config.toml file.

[params.carousel]
    enable = true

Features

Features are also defined in the data directory just like the carousel:

data
└── features
    ├── consulting.yaml
    ├── email.yaml
    ├── print.yaml
    ├── seo.yaml
    ├── uiux.yaml
    └── webdesign.yaml

The content of the consulting.yaml example feature file looks like this:

weight: 4
name: "Consulting"
icon: "fas fa-lightbulb"
url: ""
description: "Fifth abundantly made Give sixth hath. Cattle creature i be don't them behold green moved fowl Moved life us beast good yielding. Have bring."

The meaning of the individual YAML keys is as follows:

Key Description
weight A means to set the order of multiple features; features with a lower weight are displayed first (left to right, top to bottom)
name The title text below the feature icon; Markdown is supported
icon The CSS class of the feature icon; in this example we have used icons powered by FontAwesome
url An optional URL the feature icon should point to; if specified, the icon will become a clickable hyperlink
description A short text below the title text to describe the feature; Markdown is supported

Once you have completed your features, enable them in the config.toml file.

[params.features]
    enable = true

Testimonials

Testimonials are defined in the data directory.

data
└── testimonials
    ├── 1.yaml
    ├── 2.yaml
    ├── 3.yaml
    ├── 4.yaml
    └── 5.yaml

You can add as many testimonials files as you want. Be sure you fill in all fields as in the following example.

text: "One morning, when Gregor Samsa woke from troubled dreams, he found himself transformed in his bed into a horrible vermin. He lay on his armour-like back, and if he lifted his head a little he could see his brown belly, slightly domed and divided by arches into stiff sections."
name: "John McIntyre"
position: "CEO, TransTech"
avatar: "img/testimonials/person-1.jpg"

Then, enable it in the configuration file and add a title and subtitle.

[params.testimonials]
    enable = true
    title = "Testimonials"
    subtitle = "We have worked with many clients and we always like to hear they come out from the cooperation happy and satisfied. Have a look what our clients said about us."

See more

This section is used to provide a link to another place. It can be an external site, or a page or post within your Hugo site.

You can enable it in the configuration file.

[params.see_more]
    enable = true
    icon = "far fa-file-alt"
    title = "Do you want to see more?"
    subtitle = "We have prepared for you more than 40 different HTML pages, including 5 variations of homepage."
    link_url = "http://your-site.com/more"
    link_text = "Check other homepages"

Clients

The clients section is used to show a list of logos of companies you have collaborated with. The clients are defined in the data directory as YAML files.

data
└── clients
    ├── 1.yaml
    ├── 2.yaml
    ├── 3.yaml
    ├── 4.yaml
    ├── 5.yaml
    └── 6.yaml

Each client file contains the following information.

name: "customer-1"
image: "img/clients/customer-1.png"
url: "http://www.customer-1.com"

The name of the client. image is a relative path to the logo inside the static directory. And url is an optional field in case you want to link the logo to the client's website.

Then, you can enable the section in the configuration file.

[params.clients]
    enable = true
    title = "Our Partners"
    subtitle = "We have proudly collaborated with the following companies."

Recent posts

The recent posts sections shows the four latest published blog posts, with their featured image and a summary. It defaults to show recent posts from all main sections. This is either the section with the most posts or can be set explicitly in the configuration file (see linked docs).

You can enable it in the configuration file.

[params.recent_posts]
    enable = true
    title = "From our blog"
    subtitle = "Pellen

Meta tags

The following HTML metadata can be set for every page. While the default value for some of them can be defined in config.toml, all of these properties can also be set through the respective Hugo front matter variables:

HTML meta name/property Hugo front matter variable Default variable in config.toml
article:author facebook_author -
article:publisher facebook_site facebook_site
author author -
description / og:description / twitter:description description defaultDescription
keywords keywords defaultKeywords
og:image / twitter:image banner default_sharing_image
title / og:title / twitter:title title -
twitter:creator twitter_author -
twitter:site twitter_site twitter_site

Besides, certain Open Graph metadata is automatically set:

You can set default values for all pages in the config.toml file as below:

[params]
    defaultKeywords = ["devcows", "hugo", "go"]
    defaultDescription = "Site template made by Devcows using Hugo"
    default_sharing_image = "img/sharing-default.png"
    facebook_site = "https://www.facebook.com/GolangSociety/"
    twitter_site = "GoHugoIO"

The resulting HTML will be the following:

<meta name="keywords" content="devcows, hugo, go">
<meta name="description" content="Site template made by Devcows using Hugo">
<meta property="og:description" content="Site template made by Devcows using Hugo">
<meta property="og:image" content="img/sharing-default.png">
<meta property="og:image:type" content="image/png">
<meta property="og:image:width" content="800">
<meta property="og:image:height" content="420">
<meta property="article:publisher" content="https://www.facebook.com/GolangSociety/">
<meta name="twitter:description" content="Site template made by Devcows using Hugo">
<meta name="twitter:site" content="@GoHugoIO">

You can also override the default values from the config.toml by setting the respective keys in the individual pages front matter. As an example, here's the front matter from the faq.md file in the exampleSite directory:

+++
title = "FAQ"
description = "Frequently asked questions"
keywords = ["FAQ","How do I","questions","what if"]
+++

Which results in the following HTML:

<title>FAQ</title>
<meta name="keywords" content="FAQ,How do I,questions,what if">
<meta name="description" content="Frequently asked questions">
<meta property="og:description" content="Frequently asked questions">
<meta name="twitter:description" content="Frequently asked questions">

Layout

The theme contains a number of partials that can be easily reused on any type of page. The intent is to give the user of the theme a maximum amount of flexibility in using, reusing and combining these partials.

Accordion

The intent of the accordion partial is, in line with Hugo, to split content from layout. So it is up to the site builder to provide the data that is past to the partial.

Let's go over an example usage in the exampleSite. In content/template-accordions.md, we call a shortcode defined in the site itself:

{{% accordion-example id="accordion-test" data="accordion-data" %}}

This shortcode expects a single argument which refers to a specific set of data files from the data folder:

{{ $contentIndex := .Get "data" }}
{{ $content := index .Site.Data $contentIndex }}
{{ partial "accordion.html" (dict "context" . "accordionid" (.Get "id") "content" $content) }}

The partial is called with a dict containing these key/value pairs:

  • context: the current context (.)
  • accordionid: the id for this accordion and it's set of items. This allows the accordion to be used multiple times on the same page.
  • content: a list of maps containing the content to be rendered. In the case of the example site, the list contains the 3 YAML files from data/accordion-data, each made available as a map.

You can use data from the data folder or use Data Driven Content. What the data is or where it comes from is totally up to the site author.

This theme expects an item of an accordion to have the following key/value pairs:

  • id: to identify each item within the accordion
  • title: the text box title
  • content: the text to render below the text box title.
  • img: an optional image to show left of the content

If you want to render data with more key/value pairs, copy the theme's layouts/partials/accordion-item.html to your site layouts/partials/ folder and adapt at will.

Usage

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.

For more information check out the official Hugo documentation.

Contributing

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

License

This port is released under the MIT License. Check the original theme license for additional licensing information.

Thanks

Thanks to Steve Francia for creating Hugo and the awesome community around the project. And also thanks to Bootstrapious for creating this awesome theme.

About

Port of the Universal theme to Hugo

Resources

Readme

License

MIT license
Activity

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

4 tags

Packages

No packages published

Languages

  • CSS 84.1%
  • JavaScript 8.1%
  • HTML 7.8%
0