@thegetty/quire-cli 0.20.3 → 0.20.4

package/bin/themes/default/layouts/partials/cite-this.html

@@ -0,0 +1,348 @@
+{{/*
+    Template for the "Cite this Page" feature. Called as a
+    partial, such as:
+
+    partial "cite-this.html" (dict "page" . "site" .Site "type" "chicago" "range" "page")
+
+    Can accept "chicago" or "mla" as a type
+
+    Can accept "page" or "site" as a range
+
+    Follows standard of using "et al" for more than ten
+    authors in Chicago citations, and more than two authors
+    in MLA citations.
+
+    ***Note***
+    Edit this template with care as it is easy to introduce stray spaces occuring around punctuation.
+*/}}
+
+{{ $citationType := .type }}
+{{ $citationRange := .range }}
+
+{{- $endPunctuation := findRE "[!|?]$" .site.Data.publication.title -}}
+{{ $seriesStartNumber := findRE "^[0-9]" .site.Data.publication.number_in_series }}
+
+{{ $siteAuthorCount := "" }}
+{{ $siteEditorCount := "" }}
+
+{{ $siteAuthorCount = len (where .site.Data.publication.contributor "type" "primary") }}
+{{ if ne $siteAuthorCount 0 }}
+{{ $siteEditorCount = len (where .site.Data.publication.contributor "role" "editor") }}
+{{ end }}
+
+
+{{/* ------------  CHICAGO ------------ */}}
+{{- if eq $citationType "chicago" -}}
+
+  {{- if eq $citationRange "page" -}}
+
+    {{ if .page.Params.contributor }}{{ template "page-contributors-chicago" .page }}. {{ end }}{{ if .page.Title }}“{{ partial "page-title.html" .page | markdownify }}.” {{ else if .page.Params.label }}“{{ .page.Params.label }}.” {{ else }}Untitled. {{ end }}In <em>{{ partial "site-title.html" .page }}</em>{{ if gt $siteAuthorCount 0 }}, {{ if gt $siteEditorCount 0 }}edited {{ end }}by {{ template "publication-contributors-chicago" .page }}{{ end }}. {{ template "publishers-chicago" (dict "site" .site)}}{{ with .site.Data.publication.pub_date }}, {{ dateFormat "2006" . }}{{ end }}. <span class="url-string">{{ if .site.Data.publication.identifier.url }}{{ .site.Data.publication.identifier.url }}{{ .page.RelPermalink }}{{ else }}{{ .page.Permalink }}{{ end }}</span>.
+
+  {{- else if eq $citationRange "site" -}}
+
+    {{ template "publication-contributors" (dict "page" .page "Site" .site "type" $citationType) }}. <em>{{ .site.Data.publication.title }}{{ with .site.Data.publication.subtitle }}{{ if $endPunctuation }} {{ else }}: {{ end }}{{ . }}{{ end }}</em>. {{ if .site.Data.publication.series }}{{ .site.Data.publication.series }}{{ with .site.Data.publication.number_in_series }}{{ if $seriesStartNumber }} {{ else }}, {{ end }}{{ . }}{{ end }}.{{ end }} {{ template "publishers-chicago" (dict "site" .site) }}{{ with .site.Data.publication.pub_date }}, {{ dateFormat "2006" . }}{{ end }}.{{ with .site.Data.publication.identifier.url }} <span class="url-string">{{ . }}</span>.{{ end }}
+
+  {{- end -}}
+
+{{/* ------------  MLA ------------ */}}
+{{- else if eq $citationType "mla" -}}
+
+  {{- if eq $citationRange "page" -}}
+
+    {{ if .page.Params.contributor }}{{ template "page-contributors-mla" .page }}. {{ end }}{{ if .page.Title }}“{{ partial "page-title.html" .page | markdownify }}.” {{ else if .page.Params.label }}“{{ .page.Params.label }}.” {{ else }}Untitled. {{ end }}<em>{{ partial "site-title.html" .page }}</em>{{ if gt $siteAuthorCount 0 }}, {{ if gt $siteEditorCount 0 }}edited {{ end }}by {{ template "publication-contributors-mla" .page }}{{ end }}. {{ template "publishers-mla" (dict "site" .site)}}{{ with .site.Data.publication.pub_date }}, {{ dateFormat "2006" . }}{{ end }}. <span class="url-string">{{ if .site.Data.publication.identifier.url }}{{ .site.Data.publication.identifier.url }}{{ .page.RelPermalink }}{{ else }}{{ .page.Permalink }}{{ end }}</span>. Accessed <span class="cite-current-date">DD Mon. YYYY</span>.
+
+  {{- else if eq $citationRange "site" -}}
+
+    {{ template "publication-contributors" (dict "page" .page "Site" .site "type" $citationType) }}. <em>{{ .site.Data.publication.title }}{{ with .site.Data.publication.subtitle }}{{ if $endPunctuation }} {{ else }}: {{ end }}{{ . }}{{ end }}.</em> {{ if .site.Data.publication.series }}{{ .site.Data.publication.series }}{{ with .site.Data.publication.number_in_series }}{{ if $seriesStartNumber }} {{ else }}, {{ end }}{{ . }}{{ end }}.{{ end }} {{ template "publishers-mla" (dict "site" .site) }}{{ with .site.Data.publication.pub_date }}, {{ dateFormat "2006" . }}{{ end }}. {{ with .site.Data.publication.identifier.url }}<span class="url-string">{{ . }}</span>{{ end }}. Accessed <span class="cite-current-date">DD Mon. YYYY</span>.
+
+  {{- end -}}
+
+{{- end -}}
+
+
+{{- define "page-contributors-mla" -}}
+{{- if .Page.Params.contributor -}}
+  {{- $len := len .Page.Params.contributor -}}
+  {{- range $index, $element := .Page.Params.contributor -}}
+    {{- if and (eq $len 1) (eq $index 0) -}}
+    {{ template "contrib-name-reverse-last" (dict "site" $.Site "page" . )}}
+    {{- else if eq $index 0 -}}
+    {{ template "contrib-name-reverse" (dict "site" $.Site "page" . )}}
+    {{- else -}}
+    {{- if eq $len 2 }}, and {{ template "contrib-name-last" (dict "site" $.Site "page" . )}}{{ end -}}
+    {{- end -}}
+  {{- end -}}
+  {{- if gt $len 2 }}, et al{{ end -}}
+{{- end -}}
+{{- end -}}
+
+{{- define "publication-contributors-mla" -}}
+  {{- $len := len (where $.Site.Data.publication.contributor "type" "primary") -}}
+  {{- range $index, $element := (where $.Site.Data.publication.contributor "type" "primary") -}}
+    {{ if eq $index 0 }}
+    {{ template "contrib-name" (dict "site" $.Site "page" . )}}
+    {{- else -}}
+    {{- if eq $len 2 }} and {{ template "contrib-name-last" (dict "site" $.Site "page" . )}}{{ end -}}
+    {{- end -}}
+  {{- end -}}
+  {{- if gt $len 2 }}, et al{{ end -}}
+{{- end -}}
+
+{{- define "page-contributors-chicago" -}}
+{{- if .Page.Params.contributor -}}
+  {{- $len := len .Page.Params.contributor -}}
+  {{- range $index, $element := .Page.Params.contributor -}}
+    {{- if and (eq $len 1) (eq $index 0) -}}
+    {{ template "contrib-name-reverse-last" (dict "site" $.Site "page" . )}}{{- else if eq $index 0 -}}
+    {{ template "contrib-name-reverse" (dict "site" $.Site "page" . )}}, {{ end -}}
+
+    {{- if or (and (eq $len 2) (eq $index 1)) (and (eq $len 3) (eq $index 2)) -}}
+    and {{ template "contrib-name-last" (dict "site" $.Site "page" . )}}
+    {{- end -}}
+
+    {{- if or (and (gt $len 2) (eq $index 1)) (and (gt $len 3) (eq $index 2)) -}}
+    {{ template "contrib-name" (dict "site" $.Site "page" . )}}, {{ end -}}
+  {{- end -}}
+
+  {{- if gt $len 3 -}}
+  et al
+  {{- end -}}
+
+{{- end -}}
+{{- end -}}
+
+{{- define "publication-contributors-chicago" -}}
+  {{- $len := len (where $.Site.Data.publication.contributor "type" "primary") -}}
+  {{- range $index, $element := (where $.Site.Data.publication.contributor "type" "primary") -}}
+    {{- if gt $index 2 -}}
+    {{- else if and (eq $index 0) (eq $len 1) }}
+      {{ template "contrib-name" (dict "site" $.Site "page" . )}}
+    {{- else if eq $index (sub $len 1) }}
+      and {{ template "contrib-name" (dict "site" $.Site "page" . )}}
+    {{- else if and (eq $index 0) (eq $len 2) }}
+      {{ template "contrib-name" (dict "site" $.Site "page" . )}}
+    {{ else -}}
+      {{ template "contrib-name" (dict "site" $.Site "page" . )}},
+    {{ end -}}
+  {{- end -}}
+  {{- if gt $len 3 }}et al{{ end -}}
+{{- end -}}
+
+{{/* This template creates a list of contributors for citations based on the "primary" contributors in the publication. It reverses the first name, adds "et al" as needed when the contributors list is beyond a certain length, handles adding ed(s)/editor(s) as called for. It returns the list without end punctuation, so should be followed by a period.
+
+See https://www.chicagomanualofstyle.org/book/ed17/part3/ch14/psec076.html for rules on the inclusion of contributors.
+--------------------------------------------------------------------------*/}}
+{{- define "publication-contributors" -}}
+
+  {{ $citationType := .type }}
+
+  {{ $contributors := (where $.Site.Data.publication.contributor "type" "primary") }}
+  {{- $contributorLength := len $contributors -}}
+
+  {{- $editors := (where $contributors "role" "eq" "editor") -}}
+  {{- $editorLength := len $editors -}}
+
+  {{/* Set the value of $editorTag
+    If the primary contributors are listed as role: editor, we need to add "ed(s)" or "editor(s)" to the list of contributor names
+  --------------------------------------------------------------------------*/}}
+  {{- $editorTag := "" -}}
+  {{- if eq $editorLength 1 }}
+    {{- if eq $citationType "chicago" -}}
+      {{- $editorTag = "ed" -}}
+    {{- else if eq $citationType "mla" -}}
+      {{- $editorTag = "editor" -}}
+    {{- end -}}
+  {{- else if gt $editorLength 1 -}}
+    {{- if eq $citationType "chicago" -}}
+      {{- $editorTag = "eds" -}}
+    {{- else if eq $citationType "mla" -}}
+      {{- $editorTag = "editors" -}}
+    {{- end -}}
+  {{- end -}}
+
+  {{/* Chicago suggests that et al be used for
+  ------------------------------------------------------------------------*/}}
+  {{- $maxLength := "" -}}
+  {{- $displayLength := "" -}}
+  {{- if eq $citationType "chicago" -}}
+    {{- $maxLength = 10 -}}
+    {{- $displayLength = 7 -}}
+  {{- else if eq $citationType "mla" -}}
+    {{- $maxLength = 2 -}}
+    {{- $displayLength = 1 -}}
+  {{- end -}}
+
+  {{- range $index, $element := $contributors -}}
+
+    {{/* If the number of contributors is beyond a certain number, display only
+      a set ammount ($displayLength), and append the list with et al. Ignore subsequent contributors in the list beyond this. Lenghts vary bewtween Chicago and MLA formats
+    ------------------------------------------------------------------------*/}}
+    {{- if and (gt $contributorLength $maxLength) (eq $index $displayLength) -}}
+
+      et al{{ if $editorTag }}., {{ end -}}
+
+    {{- else if and (gt $contributorLength $maxLength) (gt $index $displayLength) -}}
+
+    {{/* If this is the last name ...
+    ------------------------------------------------------------------------*/}}
+    {{- else if eq $index (sub $contributorLength 1) -}}
+
+      {{/* First check if it's also the first name, and reverse it if so: LastName, FirstName
+      ----------------------------------------------------------------------*/}}
+      {{- if eq $index 0 -}}
+
+        {{/* If there's a role tag to add, leave any ending punctuation in the name, and add a comma
+        --------------------------------------------------------------------*/}}
+        {{- if $editorTag -}}
+
+            {{ template "contrib-name-reverse" (dict "site" $.Site "page" . )}},
+
+        {{/* Otherwise strip any ending punctuation
+        --------------------------------------------------------------------*/}}
+        {{ else -}}
+
+            {{ template "contrib-name-reverse-last" (dict "site" $.Site "page" . )}}
+
+        {{- end -}}
+
+      {{/* Second, if it's not the first name, display it in reading order. FirstName LastName
+      ----------------------------------------------------------------------*/}}
+      {{- else if gt $index 0 -}}
+
+        {{/* If there's a role tag to add, leave any ending punctuation in the name, and add a comma
+        --------------------------------------------------------------------*/}}
+        {{- if ne $editorTag "" -}}
+
+            and {{ template "contrib-name" (dict "site" $.Site "page" . )}},
+
+        {{/* Otherwise strip any ending punctuation
+        --------------------------------------------------------------------*/}}
+        {{ else -}}
+
+            and {{ template "contrib-name-last" (dict "site" $.Site "page" . )}}
+
+        {{- end -}}
+
+      {{- end -}}
+
+    {{/* If this is the first name, reverse it and add a comma: LastName, FirstName,
+    ------------------------------------------------------------------------*/}}
+    {{- else if eq $index 0 -}}
+
+          {{ template "contrib-name-reverse" (dict "site" $.Site "page" . )}},
+
+    {{/* If this is a name in the middle of the list, just add it in with a comma: FirstName LastName,
+    ------------------------------------------------------------------------*/}}
+    {{- else if (gt $index 0) (lt $index (sub $contributorLength 1) ) -}}
+
+      {{ template "contrib-name" (dict "site" $.Site "page" . )}},
+
+    {{ end -}}
+
+  {{/* End the range
+  --------------------------------------------------------------------------*/}}
+  {{- end -}}
+
+  {{/* If there's a role tag to add, do so now
+  --------------------------------------------------------------------------*/}}
+  {{- with $editorTag -}} {{ . }}{{- end -}}
+
+{{- end -}}
+
+
+
+{{- define "contrib-name-reverse" -}}
+  {{- if .page.id -}}
+    {{- range where .site.Data.publication.contributor "id" .page.id -}}
+      {{ template "name-string-reverse" . }}
+    {{- end -}}
+  {{- else -}}
+    {{ template "name-string-reverse" .page }}
+  {{- end -}}
+{{- end -}}
+
+{{- define "contrib-name" -}}
+  {{- if .page.id -}}
+    {{- range where .site.Data.publication.contributor "id" .page.id -}}
+      {{ template "name-string" . }}
+    {{- end -}}
+  {{- else -}}
+    {{ template "name-string" .page }}
+  {{- end -}}
+{{- end -}}
+
+{{- define "name-string" -}}
+  {{- if .full_name -}}
+    {{ .full_name }}
+  {{- else -}}
+    {{ printf "%s%s%s" .first_name " " .last_name }}
+  {{- end -}}
+{{- end -}}
+
+{{- define "name-string-reverse" -}}
+  {{- if .full_name -}}
+    {{ .full_name }}
+  {{- else -}}
+    {{ printf "%s%s%s" .last_name ", " .first_name }}
+  {{- end -}}
+{{- end -}}
+
+
+{{- define "contrib-name-reverse-last" -}}
+  {{- if .page.id -}}
+    {{- range where .site.Data.publication.contributor "id" .page.id -}}
+      {{ template "name-string-reverse-last" . }}
+    {{- end -}}
+  {{- else -}}
+    {{ template "name-string-reverse-last" .page }}
+  {{- end -}}
+{{- end -}}
+
+{{- define "contrib-name-last" -}}
+  {{- if .page.id -}}
+    {{- range where .site.Data.publication.contributor "id" .page.id -}}
+      {{ template "name-string-last" . }}
+    {{- end -}}
+  {{- else -}}
+    {{ template "name-string-last" .page }}
+  {{- end -}}
+{{- end -}}
+
+{{- define "name-string-last" -}}
+  {{- if .full_name -}}
+    {{ $nameLast := .full_name }}
+    {{ replaceRE "[.]$" "" $nameLast }}
+  {{- else -}}
+    {{ $nameLast := printf "%s%s%s" .first_name " " .last_name }}
+    {{ replaceRE "[.]$" "" $nameLast }}
+  {{- end -}}
+{{- end -}}
+
+{{- define "name-string-reverse-last" -}}
+  {{- if .full_name -}}
+    {{ $nameLast := .full_name }}
+    {{ replaceRE "[.]$" "" $nameLast }}
+  {{- else -}}
+    {{ $nameLast := printf "%s%s%s" .last_name ", " .first_name }}
+    {{ replaceRE "[.]$" "" $nameLast }}
+  {{- end -}}
+{{- end -}}
+
+
+{{- define "publishers-chicago" -}}
+  {{ $len := len .site.Data.publication.publisher }}
+  {{ range $index, $element := .site.Data.publication.publisher }}
+    {{ if eq $index (sub $len 1) }}
+    {{ .location }}: {{ .name }}{{ else }}
+    {{ .location }}: {{ .name }}; {{ end }}
+  {{- end }}
+{{- end -}}
+
+{{- define "publishers-mla" -}}
+  {{ $len := len .site.Data.publication.publisher }}
+  {{ range $index, $element := .site.Data.publication.publisher }}
+    {{ if eq $index (sub $len 1) }}
+    {{ .name }}{{ else }}
+    {{ .name }}, {{ end }}
+  {{- end }}
+{{- end -}}

package/bin/themes/default/layouts/partials/contents-list/card-image.html

@@ -0,0 +1,13 @@
+
+{{- $imageDir := "" -}}
+{{- if .Site.Params.imageDir -}}
+  {{- $imageDir = .Site.Params.imageDir -}}
+  {{- else }}
+  {{- $imageDir = "img" -}}
+{{- end }}
+{{- $imgPath := printf "%s/%s" $imageDir .src -}}
+<div class="card-image">
+  <figure class="image">
+    <img src="{{ $imgPath | relURL }}" alt="" />
+  </figure>
+</div>

package/bin/themes/default/layouts/partials/contents-list/closing-tags.html

@@ -0,0 +1,59 @@
+{{/*  If the .File.Dir of the current page matches the START of the .File.Dir of the next page, we’re still in the same section, so do nothing. Otherwise proceed to next section to add the appropriate number of closing /ul/li tags to close section(s)
+--------------------------------------------------------------------------- */}}
+{{- $currentPage := (index .AllPages .PageIndex).File.Dir -}}
+{{- $currentPageDirectory := partial "contents-list/file-dir.html" $currentPage -}}
+
+{{- $nextPage := (index .AllPages (add .PageIndex 1)).File.Dir -}}
+{{- $nextPageDirectory := "" -}}
+{{- if $nextPage }}
+{{- $nextPageDirectory = partial "contents-list/file-dir.html" $nextPage -}}
+{{- end -}}
+
+{{- $findPattern := printf "%s%s" "^" $currentPageDirectory -}}
+
+{{- if (findRE $findPattern $nextPageDirectory) -}}
+
+{{- else -}}
+
+{{- if ne $currentPageDirectory "/" -}}
+
+  {{/* Find the last page within the same .File.Dir as the current page, if the current page IS the last page, we need to add at least one set of closing /ul/li tags. to determine how many sets of tags are needed, check the sub-section level difference between the current page and the next page. For example, a page with a file directory of `section/sub-section/sub-sub-section/` is at sub-section level of 3. If the next page is at `section/`, with sub-section level of 1, there are 2 levels of difference between them and so we need 2 sets of closing tags. (We use a findRE pattern to count the number of instances of one or more characters followed by a slash in the .File.Dir to determine the sub-section level.)
+  ------------------------------------------------------------------------- */}}
+  {{- $currentPageID := .Page.File.UniqueID -}}
+  {{- $pagesInSection := where .AllPages "File.Dir" "eq" $currentPage -}}
+  {{- $openSections := .openSections -}}
+
+  {{- range last 1 $pagesInSection -}}
+
+    {{- if eq .Page.File.UniqueID $currentPageID -}}
+
+      {{- $nextPageSubSectionLevel := len (findRE "(.+?)/" $nextPageDirectory) -}}
+      {{- $currentPageSubSectionLevel := len (findRE "(.+?)/" $currentPageDirectory) -}}
+      {{- $indentDifference := sub $currentPageSubSectionLevel $nextPageSubSectionLevel -}}
+
+      {{- if le $indentDifference 1 -}}
+        </ul></li>
+      {{- else -}}
+        {{- range after 0 (seq $indentDifference) }}
+        </ul></li>
+        {{- end -}}
+      {{- end -}}
+
+      {{/* If the section of the last page rendered is not the same as the section of the next page that’s going to be rendered, we have to add in an additional set of /ul/li tags to close the section.
+      --------------------------------------------------------------------- */}}
+      {{- if and ($nextPageSubSectionLevel) (ne $currentPageSubSectionLevel $nextPageSubSectionLevel) -}}
+        {{ $sectionLevelKey := printf "%s%s" "s" (string $nextPageSubSectionLevel) }}
+        {{- range $key, $value := $openSections -}}
+          {{- if and (eq $key $sectionLevelKey) (ne . $nextPageDirectory) -}}
+          </ul></li>
+          {{- end -}}
+        {{- end -}}
+      {{- end -}}
+
+    {{- end -}}
+
+  {{- end -}}
+
+{{- end -}}
+
+{{- end -}}

package/bin/themes/default/layouts/partials/contents-list/contents-list.html

@@ -0,0 +1,179 @@
+{{/*
+  This partial generates a contents list. It is used in the publication menu
+  and in the "contents" page type, but could be extended for further use. It
+  expects four specific variables to be passed:
+
+  site              .Site
+  contentsScope     Typically .Site.Pages or narrowed down to pages within a
+                    specific section.
+  contentsLocation  Must be either ".Params.menu" or ".Params.toc". Determines
+                    in what context the partial is being shown so that
+                    individual pages can be hidden as called for. For example,
+                    if contentsLocation is "toc" any pages in the publication
+                    with "toc: false" will be omitted from the generated
+                    contents list.
+  contentsPage      Typically . This just passes the page context through to
+                    allow a Scratch variable to be set when creating sections.
+
+  Content can either be in top-level files in the `content` directory, or
+  in sub-directories to create sections.
+
+  For users to customize their publiction, this partial response to `class`
+  values in the page YAML as well. For the menu, the class can be set in the
+  config.yml of the project with the menuClass parameter.
+
+  `grid`            A grid of cards, using images defined in indivudal page
+                    yaml when avaialble
+
+  `abstract`        Title and contributor headings, and a page abstract
+                    if one is provided, or the page Summary. If `abstract` is
+                    an empty value `""`, no abstract or summary will be shown
+                    in the contents list.
+
+  `list`            Lists the title, subtitle and contributors as included. The
+                    default value, if no `class` is specified.
+
+  `brief`           Lists only the title, or short_title when available.
+
+  EXAMPLE PARTIAL USE:
+  partial "contents-list.html" (dict "site" .Site "contentsScope" .Site.Pages "contentsLocation" ".Params.toc" "contentsPage" . )
+
+*/}}
+
+{{- $contentsLocation := .contentsLocation -}}
+
+{{/* List pages, but remove data pages, those hidden from toc/menu, and those hidden from specific output formats as needed
+--------------------------------------------------------------------------- */}}
+{{- $pages := "" -}}
+{{- $pages = where .site.Pages ".Kind" "page" -}}
+{{- $pages = where $pages ".Type" "!=" "data" -}}
+{{- $pages = where $pages .contentsLocation "!=" "false" -}}
+{{- if eq .site.Params.pdf true -}}
+  {{- $pages = where $pages "Params.pdf" "!=" "false" -}}
+{{- else if eq .site.Params.epub true -}}
+  {{- $pages = where $pages "Params.epub" "!=" "false" -}}
+{{- else -}}
+  {{- $pages = where $pages "Params.online" "!=" "false" -}}
+{{- end -}}
+
+{{/* To mark items as frontmatter for page numbering styles in PDF
+--------------------------------------------------------------------------- */}}
+{{- $pageOne := "" -}}
+{{- range first 1 (where $pages "Params.class" "in" "page-one") -}}
+  {{- $pageOne = .Weight -}}
+{{- end -}}
+
+{{- $contentsPageClass := "" -}}
+{{- $contentsPageID := "" -}}
+{{- if eq .contentsLocation ".Params.toc" -}}
+  {{- $contentsPageClass = .contentsPage.Params.class -}}
+  {{- $contentsPageID = .contentsPage.File.UniqueID -}}
+{{- else -}}
+  {{- $contentsPageClass = .site.Params.menuClass -}}
+  {{- $contentsPageID = "" -}}
+{{- end -}}
+
+{{/* This contents list is built based on the number of section levels any given page is at, which is determined by looking at its File.Dir.
+
+  Section level 1: section/
+  Section level 2: section/sub-section/
+  Section level 3: section/sub-section/sub-sub-section/
+  &tc.
+
+In order to properly close the /ul/li elements and nest sub-sections, the logic in this partial compares the File.Dirs, tracks sections that have been rendered but not yet closed, and looks at the difference in section levels from one page to the next.
+--------------------------------------------------------------------------- */}}
+
+{{- $lastSection := "/" -}}
+{{- $openSections := dict -}}
+{{- $renderedSections := "" -}}
+{{- if .contentsScope -}}
+{{- $renderedSections = partial "contents-list/file-dir.html" .contentsScope -}}
+{{- end -}}
+{{- $contentsScopePattern := printf "%s%s" "^" $renderedSections -}}
+{{- $contentsPageID := .contentsPage.File.UniqueID -}}
+
+<ul>
+{{- range $index, $page := $pages -}}
+
+  {{- $section := partial "contents-list/file-dir.html" .File.Dir -}}
+  {{- $sectionLevel := len (findRE "(.+?)/" $section) -}}
+  {{- $sameAsOpenSection := false -}}
+
+  {{/* The $openSections map tracks the File.Dir of most recently rendered page from any give section level. If the new page is part of that same section, the section is still open.
+  ------------------------------------------------------------------------- */}}
+  {{- $sectionLevelKey := printf "%s%s" "s" (string $sectionLevel) -}}
+  {{- range $key, $value := $openSections -}}
+    {{- if and (eq $key $sectionLevelKey) (eq $section $value) -}}
+      {{ $sameAsOpenSection = true }}
+    {{- end -}}
+  {{- end -}}
+  {{- $openSections = merge $openSections (dict $sectionLevelKey $section) -}}
+
+  {{/* Check to make sure the page is within the section that the contents list is being rendederd in (the "contents scope"). If it is, and it’s not also the contents page itself, render the list item for it.
+  ------------------------------------------------------------------------- */}}
+  {{- $pageWithinThisScope := findRE $contentsScopePattern $section -}}
+  {{- if and $pageWithinThisScope (or (eq $contentsLocation ".Params.menu") (and (eq $contentsLocation ".Params.toc") (ne $contentsPageID .File.UniqueID))) -}}
+
+  {{- if and (ne $lastSection $section) (eq $sameAsOpenSection false) -}}
+
+    {{/* This checks all of the parent sections/directories of the current page to see if they've already been rendered in the contents list, if they haven’t a heading is added for each. This is needed in the case where sections don’t have their own child pages and so would have been be skipped over and not rendered without this specific check. Based on the number of levels deep the page is, parent sections are checked one at a time, from the top-most, to the most direct: xxxx/..../..../page
+                                      xxxx/xxxx/..../page
+                                      xxxx/xxxx/xxxx/page
+    ----------------------------------------------------------------------- */}}
+    {{- range $index, $num := (seq (sub $sectionLevel 1)) -}}
+
+      {{- $pattern := printf "%s%s%s" "^((.[^/]*)/){" (string $num) "}" -}}
+      {{- $parentSection := findRE $pattern $section -}}
+      {{- $parentSection = delimit $parentSection "" -}}
+
+      {{- if not (in $renderedSections $parentSection) -}}
+
+        {{/* Update $openSections map
+        ------------------------------------------------------------------- */}}
+        {{- $parentSectionLevel := len (findRE "(.+?)/" $parentSection) -}}
+        {{- $parentSectionLevelKey := printf "%s%s" "s" (string $parentSectionLevel) -}}
+        {{- $openSections = merge $openSections (dict $parentSectionLevelKey $parentSection) -}}
+
+        {{/* Add closing UL tag if this is not a deeper section than the last
+        ------------------------------------------------------------------- */}}
+        {{- $lastSectionLevel := len (findRE "(.+?)/" $lastSection) -}}
+        {{- if gt (sub $lastSectionLevel $parentSectionLevel) 0 -}}
+        </ul>
+        {{- end -}}
+
+        {{/* Add heading for parent section
+        ------------------------------------------------------------------- */}}
+        {{- partial "contents-list/section-heading" (dict "Section" $parentSection "Level" (sub $parentSectionLevel 1) ) -}}
+
+      {{- end -}}
+
+    {{- end -}}
+
+    {{- if ne .Params.slug "." -}}
+
+      {{/* Add heading for file section
+      ------------------------------------------------------------------- */}}
+      {{- partial "contents-list/section-heading" (dict "Section" $section "Level" (sub $sectionLevel 1) ) -}}
+
+      <li class="page-item level-{{ $sectionLevel }}{{ if lt .Page.Weight $pageOne }} frontmatter-page{{ end }}">{{ partial "contents-list/list-item-type" (dict "Page" . "Class" $contentsPageClass) }}</li>
+      {{ partial "contents-list/closing-tags" (dict "Page" . "AllPages" $pages "PageIndex" $index "openSections" $openSections) -}}
+
+    {{- else -}}
+      <li class="section-item level-{{ if eq .Slug "." }}{{ sub $sectionLevel 1 }}{{ else }}{{ $sectionLevel }}{{ end }}{{ if lt .Page.Weight $pageOne }} frontmatter-page{{ end }}">{{ partial "contents-list/list-item-type" (dict "Page" . "Class" $contentsPageClass) }}
+      <ul>
+    {{- end -}}
+
+  {{- else -}}
+
+    <li class="page-item level-{{ $sectionLevel }}{{ if lt .Page.Weight $pageOne }} frontmatter-page{{ end }}">{{ partial "contents-list/list-item-type" (dict "Page" . "Class" $contentsPageClass) }}</li>
+    {{ partial "contents-list/closing-tags" (dict "Page" . "AllPages" $pages "PageIndex" $index "openSections" $openSections) -}}
+
+  {{- end -}}
+
+  {{- $lastSection = $section -}}
+  {{- $renderedSections = delimit (uniq (slice $renderedSections $section)) ", " -}}
+
+  {{- end -}}
+
+{{- end -}}
+</ul>

package/bin/themes/default/layouts/partials/contents-list/file-dir.html

@@ -0,0 +1,7 @@
+{{/* Uses the Hugo `path.Dir` function to return the given path's directory and normalize it, making it consistent for both Windows and macOS/Linux/Unix users
+--------------------------------------------------------------------------- */}}
+{{- $fileDir := path.Dir . -}}
+{{- if ne $fileDir "/" -}}
+  {{- $fileDir = printf "%s%s" $fileDir "/" -}}
+{{- end -}}
+{{- return $fileDir -}}

package/bin/themes/default/layouts/partials/contents-list/file-path.html

@@ -0,0 +1,10 @@
+{{/* Converts the given .File.Dir to a path that uses forward slashes to make it consistent for both Windows and macOS/Linux/Unix users
+--------------------------------------------------------------------------- */}}
+{{- $filePath := path.Dir . -}}
+{{- $foo := printf "%s%s" "Foo: " $filePath -}}
+{{ $foo }}
+{{- $filePath = printf "%s%s" $filePath "/" -}}
+{{- $gradoo := printf "%s%s" "Gradoo: " $filePath -}}
+{{ $gradoo }}
+{{- $filePath = replaceRE "//" "/" $filePath -}}
+{{- return $filePath -}}

package/bin/themes/default/layouts/partials/contents-list/list-item-type.html

@@ -0,0 +1,9 @@
+{{- if in .Class "grid" -}}
+  {{ partial "contents-list/list-item-types/grid.html" .Page }}
+{{- else if in .Class "abstract" -}}
+  {{ partial "contents-list/list-item-types/abstract.html" .Page }}
+{{- else if in .Class "brief" -}}
+  {{ partial "contents-list/list-item-types/brief.html" .Page }}
+{{- else -}}
+  {{ partial "contents-list/list-item-types/default.html" .Page }}
+{{- end -}}

package/bin/themes/default/layouts/partials/contents-list/list-item-types/abstract.html

@@ -0,0 +1,17 @@
+<a href="{{ .Page.Permalink | relURL }}">
+
+{{- with .Page.Params.label }}{{ . }}{{ $.Site.Params.pageLabelDivider }}{{ end -}}
+
+{{- partial "page-title.html" . | markdownify -}}
+
+{{- if .Page.Params.contributor }}<span class="contributor"> — {{ partial "contributor-list.html" (dict "range" .Page.Params.contributor "contributorType" "all" "listType" "string" "Site" .Site) }}</span>{{ end -}}
+
+<span class="arrow remove-from-epub">&nbsp;{{- partial "icon.html" (dict "type" "arrow-forward" "description" "") -}}</span></a>
+
+{{- if .Page.Params.abstract -}}
+<div class="abstract-text">
+  {{/* Returns abstract with any links stripped out
+  ------------------------------------------------------------------------- */}}
+  {{- .Page.Params.abstract | markdownify | replaceRE "</?a(|\\s*[^>]+)>" "" | htmlUnescape | safeHTML -}}
+</div>
+{{- end -}}

package/bin/themes/default/layouts/partials/contents-list/list-item-types/brief.html

@@ -0,0 +1,7 @@
+<a href="{{ .Page.Permalink | relURL }}">
+
+{{- with .Page.Params.label }}{{ . }}{{ $.Site.Params.pageLabelDivider }}{{ end -}}
+
+{{- .Page.Title | markdownify -}}
+
+<span class="arrow remove-from-epub">&nbsp;{{- partial "icon.html" (dict "type" "arrow-forward" "description" "") -}}</span></a>