[Sample Image]
OldNew Theme

Hugo OldNew Mashup

Version 0.5.0

Hugo theme mixing old school design elements with new-era CSS3, HTML5, etc. That is the look is a combination of 90’s and postmodern.

/exampleSite contains some example content as per “Add a theme to hugoThemes list”, including this documentation page and other relevant information for the theme. This theme has now been released as it’s already useful for simple sites, but there is quite a bit more work to do before it’s truly ready for general use.

Required Param ‘themes’

In config.toml it is required to have both the top-level theme = '_themedir_' setting as well as theme = '_themedir_' under [params].

Even Lazier Blogger Menus and Navigation

This theme automatically creates the top nav bar based on the top level sections and their sibling pages and sub-sections. Furthermore on each page it generates buttons for linear traversal (Previous|Next) as well up a level. And finally, on each page on which you don’t suppress the right sidebar (and you don’t do a site-wide supression), the right sidebar will contain a navigation menu for the current section and one level of subsections.

A note on navigation and display order

This theme comes with the option to do a linear traversal from the main page (the one you get by pressing ‘Enter Site’) to the last page in the sitemap, without missing any pages. To ensure this is ordered the way you wish, you may set the ‘weight’ metadata in the frontmatter of pages that are not naturally in the order you wish (basic ordering is by date). Lower weight sorts earlier.

Further if top-level sections (subdirectories of content) are not in the correct order, or you want to use a different name for the section than subdir name, you need to create an _index.md in the appropriate subdir (for example to rename content/lorem1 as Lorem, under content/lorem1 add a content file _index.md with front matter such as:

date: 2018-05-20T01:21:20-04:00
title: "Lorem"
copyright: 2018 Daniel F. Dickinson and Expired
license: Expired&CC0-1.0
weight: 100

Note that the above information also applies to the automatically created floating navbar. Submenus are for sub-sections (that is, nested sections aka topsection1/subsection1/_index.md). NB for Hugo, subsections must have an _index.md.

A note on licenses

This theme has an archetype and layouts that make it easy to indicate the copyright and licensing for your pages. In the frontmatter add the license (or licenses, separated by &) in a license field.

E.g. for YAML:

date: (some date)
title: An Essay
copyright: 2018 Joe Smith and 1818 John Smith (expired)
license: CC-BY-SA-4.0&Expired

Then in a directory named ‘licenses’ in your site’s source root create a file name ‘Expired’ which contains the license, e.g.:

Copyright expires after a certain number of years in each jurisdiction.
This work's copyright has expired in all known jurisdictions.

Likewise create a file CC-BY-SA-4.0 with the content of CC-BY-SA-4.0 Plaintext

Then issue the command hugo new licenses/Expired.md and hugo new licenses/CC-BY-SA-4.0.md.

(This presumes that the CC-BY-SA-4.0 license is being applied to the overall page and look and Expired applies to the primary content).

You can mix and match licenses as you wish (in terms of the above scheme, whether the licenses can actually work together is another story).

This theme Copyright © 2018 Daniel F. Dickinson and released under the Creative Commons BY (Attribution) 4.0 License. See CC-BY-4.0 Plaintext for terms.

Fork me on GitHub