Reference Guide

Front Matter

The following items in the front matter metdata are handled specially by this theme (in addition to the params further below which are for theming / layout):

Enabling Search

In your site configuration file add JSON as an output type, and in set the site parameter enable_search = true.

E.g. for a config.toml you might have:

baseURL = 'https://example.com/'
languageCode = 'en-ca'
languageLang = 'en'
title = 'Site Title'
enableGitInfo = true
theme = 'new-oldnew-mashup'

[outputs]
  home = ["HTML", "JSON", "RSS"]

[params]
  enable_search = true

Enabling Licenses Taxonomy

In your site configuration file add the licenses taxonomy. E.g. for config.toml you might have:

baseURL = 'https://example.com/'
languageCode = 'en-ca'
languageLang = 'en'
title = 'Site Title'
enableGitInfo = true
theme = 'new-oldnew-mashup'

[taxonomies]
  category = "categories"
  tag = "tags"
  license = "licenses"

Site Params

Set these in your site configuration file in the params section. E.g. for a config.toml you might have:

baseURL = 'https://example.com/'
languageCode = 'en-ca'
languageLang = 'en'
title = 'Site Title'
enableGitInfo = true
theme = 'new-oldnew-mashup'

[params]
  siteid = 'Site Title/ID'
  licenses = ['CC-BY-4.0']
  copyright = '© 2018 Daniel F. Dickinson'
  default_background_color = '#aba'
  default_text_color = '#454'
  GitHubRepo = 'cshoredaniel/new-oldnew-mashup'
  ...

and so on.

Miscellaneous Site Parameters

Site or Page Params

The following may be defined as Site Params (see above) — in that case the parameter becomes the site-wide default — or as a Page param (which applies only to a individual page).

Footer Pages

This theme will looks for the following pages at either /footersection/<page> or /siteentry/<page> (if footersection is not defined). If the page exists the footer will link the page.

Lists / Menus from which pages may be excluded

Theme Styling Parameters

Sidebar Expansion Pages

These pages are a longer lists on a regular page of the sidebar items such as ‘Recent Changes’, ‘News’, and ‘Events’.

These have a few elements to make their magic.

• A shortcode called summary-list-expansion which takes two parameters. The first parameter is the type of page (that it matches pages .Type) or “recent” (meaning all regular pages may match). The second (optional) parameter is the number of pages to display in the summary list (e.g. you can show the first 5 or 25 instead of the default 15).
• The creation of a content page that uses the shortcode. For example:

 ## The 30 most recently published events
 {{\< summary-list-expansion "events" 30 \>}}

• In the sidebar there is a conditional that checks for the site for the following parameters:

• If page exists at the specified path, then the header (e.g. “News”) in the sidebar links to the page at the specified path.

Generic Styles Available

Splash Screen bundle

• Needs to be a content bundle

Sample _index.md for splash_images_bundle

---
title: Splash Images Resources
resources:
  - src: splash-demo-image1.jpg
    params:
      dlinkfile: /siteentry/splash-images/rock-garden-description
      alt: \[Photo of a rock garden in bloom, slightly rotated left with a whie border\]
  - src: splash-demo-image2.jpg
    params:
      dlinkfile: /siteentry/splash-images/grain-elevator-mural-description
      alt: \[Photo of a large outdoor mural on a grain elevator, seen through trees and hydro wires\]
  - src: splash-demo-image3.jpg
    params:
      dlinkfile: /siteentry/splash-images/thecshore-homepage-description
      alt: \[The C Shore Website Screenshot\]
  - src: splash-demo-image4.jpg
    params:
      dlinkfile: /siteentry/splash-images/thecshore-about-page-description
      alt: \[The C Shore About Page Screenshot\]
---

• Notice the resources map
  • Contains a src which is an image in the splash_images_bundle
  • Contains a params map which contains:
    • dlinkfile: URL of the description of the image (for accessibility).
    • alt: ALT text for the image (also for accessibility).

Sample Landing (Home) Page metadata

---
title: "Landing page tab title"
date: 2018-01-06T14:23:41-05:00
copyright: © 2019 Daniel Dickinson
licenses:
  - CC-BY-4.0
author: Somebody Someone
description: Description of the site
categories: [hugo, theme, html, css, test]
aside: >
  An aside. Having an aside is optional. Handy for a  quirky comment on a personal site.
asidefooter: >
  Footer to the main body of the this page (above the footer that appears on every page).
oneliner: A short oneliner for the site
subliner: And a longer sub-oneliner for the site.
---

• The special bits are aside, asidefooter, oneliner, and suboneliner .