New Oldnew Mashup README
HISTORICAL ONLY (ARCHIVED)
This theme and related site are not in active development and are preserved for historical purposes only.
Some documentation may no longer apply or be out of date.
Examples of Sites Using This Theme
/exampleSite contains some example content as per
“Add a theme to hugoThemes list”,
including the documentation and a sample of how to use the theme.
Even Lazier Blogger Menus and Navigation
This theme implements menus and navigation without requiring additional
menu: entries). First, it automatically creates a
menu bar based on the top level sections and their sibling pages and
sub-sections (from which individual pages or sections can be excluded).
Likewise, on each page we generate buttons for linear traversal
(Previous|Next) and Up. That means, except for pages which are
intentionally excluded, that the entire site can be read from landing
page to last page of the last section by clicking ‘Enter Site’, and then
‘Next’ on every subsequent page.
On a final note: the right sidebar will contain a navigation menu for the current section and one level of subsections.
A note on navigation and display order
The linear traversal mentioned above uses Hugo’s default Page ordering, which means you can set the ‘weight’ metadata in the front-matter of pages that are not naturally in the order you wish (basic ordering is by date). Lower weight sorts earlier.
The theme includes basic support for a contact form (given an appropriate server-side POST receiver).
A note on displaying copyright / licenses
This theme has an archetype and taxonomy that make it easy to indicate the copyright and licensing for your pages. In the front-matter add the license (or licenses) as a list in a licenses field, and copyright in a copyright field.
--- copyright: © 2020 Daniel F. Dickinson licenses: - CC-BY-4.0 ---
The copyright and license information will appear in the colophon in the footer of the page.
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).
Date and Time of Publishing
Three dates and times are available for every page and are included in the footer by default: creation, modification, and site generation.
Hugo’s RSS feed generation is enabled and linked to from the footer.
Goal: 100% W3 valid HTML5 and CSS3
At present, due to the requirement to support IE11, there are non-compliant media queries used to detect IE11.
A Human-readable sitemap shortcode is available.
Hugo Taxonomies are implemented.
Documentation & Quick Start
Avoiding Extended with ‘hugo server’
hugo server the default is to use features found in
the Hugo Extended version. This is because the server by default
runs with the ‘development’ environment.
If you wish to use
hugo server with Hugo Basic you need to pass
and environment parameter other than ‘development’.
hugo server -b http://localhost:1313/ --environment basic.
Some features require Hugo Extended
Changing the styling via Params (e.g. colour selection) requires Hugo Extended as the CSS must be regenerated from the base SCSS, which requires Hugo Extended not just Basic.
Generating Resources Required by Hugo Basic
From the root of the theme execute (for Linux):
rm -rf resources exampleSite/resources exampleSite/public
(cd exampleSite && hugo --environment for-basic)
cp -r exampleSite/resources ./
You should now be able to use Hugo Basic with this theme (although you won’t be able to use user-defined colours and other SCSS-based tweaks to the style).
Issues / Bugs / Enhancements
Go to the New OldNew Mashup Issue Tracker on GitHub.
If you wish to contribute to development of the theme please send a pull request on the New OldNew Mashup Github Repo.
Copyright & License
© 2009-2020 Daniel F. Dickinson Licensed under the Creative Commons Attribution License 4.0
The License Image (above) is Copyright Creative Commons and Licensed under the Creative Commons Share-Alike 4.0 International License