A simple, clean, and responsive "Hugo - Static Site Generator" theme for bloggers
Branch: master
Clone or download
yudori and ijsucceed More Descriptive 404 link text (#2)
'Am here' isn't exactly grammatically correct. You would probably want 'I'm here' instead. But even that didn't seem so descriptive in terms of the action to be carried out by clicking the link. I think 'Take me home' might be a worthy alternative.
Latest commit ce9dcea Feb 7, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
archetypes Re-upload files Dec 28, 2018
exampleSite Add subscribe link Jan 5, 2019
images
layouts More Descriptive 404 link text (#2) Feb 7, 2019
static Add files via upload Jan 3, 2019
LICENSE Apache 2.0 Licence Dec 30, 2018
README.md Add subscription info Jan 5, 2019
theme.toml Update Jan 4, 2019

README.md

Onepress

Onepress is a simple, clean, and responsive "Hugo - Static Site Generator" theme for bloggers.

Features

Screenshot

Onepress screenshot

Installation

Option 1: Clone Repository

In the root of your Hugo site directory run:

$ cd themes
$ git clone https://github.com/ijsucceed/onepress.git

Option 2: Create Submodule

Create a submodule linked directly to the theme's GitHub repository in order to receive updates:

$ git submodule add https://github.com/ijsucceed/onepress.git themes/onepress

Then run:

$ git submodule update --init --recursive --remote

Configuration

Onepress comes with several configuration options to aid in site customization. This is an example config.toml file:

baseURL = "https://ijsucceed.com/"
languageCode = "en-UK"
title = "Onepress Example Site"
description = "a Blog by Jeremiah Succeed"
config = "config.toml"
tags = ["blog", "sidebar", "SEO"]
theme = "onepress"
# Enter your tracking code to enable Google Analytics
googleAnalytics = " "
# Disable comments by leaving disqusShortname empty
disqusShortname = "your disqus shortname"
copyright = "Copyright © 2019, Jeremiah Succeed; all rights reserved."
canonifyURLS = true
paginate = 12

[params]
	author = "Jeremiah Succeed"
        bio = "Fullstack web developer and Templates designer."
	logo = "/images/onepress-logo.png"
	avatar = "/images/onepress-author.png"
	opengraphImage = "/images/onepress-logo.jpg"
	enableRSS = true

	customCSS = false
        readMore = "Read Up"
    
    # Social
	twitter  = "https://twitter.com/ijsucceed"
	github   = "https://github.com/ijsucceed"
	facebook  = ""
        linkedin  = ""

    
    # Widget
    widgets = true
    
    # Author box and Share button
    authorCard = false 
    shareButton = true
    
    # Code highlighting with highlight.js
    highlightJS = true

# Taxonomies
[taxonomies]
    tag = "tags"

Using Onepress

The two main content types are blog posts and sidebar widgets.

Widgets

To create a widget section that renders on the sidebar, go to your layouts/partials/ folder and locate widgets.html.

<div class="widgets">
      
  <section itemscope itemtype="https://schema.org/Person" class="widget socials">
    <h2 class="widget-title">Socials</h2>
    <ul>
    ....
    </ul>
  </section>
  <!-- You can add multiple widgets section below -->

</div>

The themes has a default widget which is used to display social icons.

You can simply add widget like this below.

  <section class="widget customwidget">
    <h2 class="widget-title">Widget Title</h2>
    // widget body
  </section>

Whatever content you put inside the widget should fit properly to the widget space. This can be ad, affliate banner or call to action.

You can also reorder the widgets simply by placing anyone section above the other.

Removing a widget is simply by commenting(with html comment) that particular widget section or remove the section code entirely.

No sidebar

If you don't want a sidebar you can set the widgets to false in the config.toml. This will remove the sidebar and center your site content.

# Widget
widgets = false

Blog Posts

To create a new blog post, run:

$ hugo new post/post-title.md

Custom CSS

To implement custom CSS sitewide, change the config.toml parameter customCSS from false to true and then go to css.html file in your layouts/partials/ folder and add a css code like the example below:

<style>
  <!-- This will remove the shadow on the navbar -->
  a {
    border-color: orange;
  }
</style>

This will render inline CSS in the head of your site and without adding an extra HTTP request.

Show Author box

If you want to show author box beneath post.

 authorCard = true

Subscribe link

Use the parameter subscribeLink to create a link to a page (internal or external) that contains your email subscription form.

Contributions

If you'd like to help with the continous improvement of this theme, I encourage you to submit a pull request or create an issue if you find a bug. All help is celebrated.

License

This theme is released under the Apache 2.0 license. For more information read the license.