Add series

2023-03-15 18:08:23 -07:00
parent 5fb76c35f6
commit a66f33962c
9 changed files with 74 additions and 7 deletions
--- a/README.md
+++ b/README.md
@@ -40,6 +40,7 @@ It's a versatile canvas that serves most web needs.
 - Safari and Firefox Reader View support
 - Search
 - Sections
+- Series
 - Single column
 - Social links
 - Table of contents
@@ -816,6 +817,8 @@ Use these CSS selectors to extend the default styling:
    <dd>The pagination links in the list and term layouts.</dd>
    <dt><code>#paige-root</code></dt>
    <dd>The outermost element in the body.</dd>
+    <dt><code>#paige-series</code></dt>
+    <dd>The page series.</dd>
 </dl>

 If you hide `#paige-credit`, please credit this project in a post to help others find it.
@@ -830,11 +833,13 @@ try the following in your `layouts/partials/paige/style-first.css`:
 #paige-authors,
 #paige-credit,
 #paige-reading-time,
+#paige-series,
 #paige-terms,
 #paige-toc,
 #paige-pages .paige-authors,
 #paige-pages .paige-date,
 #paige-pages .paige-reading-time,
+#paige-pages .paige-series,
 #paige-pages .paige-summary,
 #paige-pages .paige-terms {
    display: none;
--- a/exampleSite/config.yaml
+++ b/exampleSite/config.yaml
@@ -26,18 +26,22 @@ languages:
        name: "Customization"
        url: "/customization/"
        weight: 50
+      - identifier: "series"
+        name: "Series"
+        url: "/series/"
+        weight: 60
      - identifier: "categories"
        name: "Categories"
        url: "/categories/"
-        weight: 60
+        weight: 70
      - identifier: "tags"
        name: "Tags"
        url: "/tags/"
-        weight: 70
+        weight: 80
      - identifier: "search"
        name: "Search"
        url: "/search/"
-        weight: 80
+        weight: 90
    weight: 10
 markup:
  goldmark:
@@ -62,6 +66,10 @@ params:
  paige:
    git:
      commit_url_prefix: "https://github.com/willfaught/paige/commit/"
+taxonomies:
+  category: "categories"
+  series: "series"
+  tag: "tags"
 theme: "paige"
 timezone: "America/Los_Angeles"
 titlecasestyle: "Go"
--- a/exampleSite/content/customization/_index.md
+++ b/exampleSite/content/customization/_index.md
@@ -9,16 +9,19 @@ paige:
    #paige-credit,
    #paige-date,
    #paige-reading-time,
+    #paige-series,
    #paige-terms,
    #paige-toc,
    #paige-pages .paige-authors,
    #paige-pages .paige-date,
    #paige-pages .paige-date-header,
    #paige-pages .paige-reading-time,
+    #paige-pages .paige-series,
    #paige-pages .paige-summary,
    #paige-pages .paige-terms {
        display: block;
    }
+series: ["demo"]
 tags: ["sections"]
 title: "Customization"
 ---
@@ -38,12 +41,14 @@ paige:
    #paige-credit,
    #paige-date,
    #paige-reading-time,
+    #paige-series,
    #paige-terms,
    #paige-toc,
    #paige-pages .paige-authors,
    #paige-pages .paige-date,
    #paige-pages .paige-date-header,
    #paige-pages .paige-reading-time,
+    #paige-pages .paige-series,
    #paige-pages .paige-summary,
    #paige-pages .paige-terms {
        display: block;
--- a/exampleSite/content/customization/show.md
+++ b/exampleSite/content/customization/show.md
@@ -9,19 +9,21 @@ paige:
    #paige-credit,
    #paige-date,
    #paige-reading-time,
+    #paige-series,
    #paige-terms,
    #paige-toc,
    #paige-pages .paige-authors,
    #paige-pages .paige-date,
    #paige-pages .paige-date-header,
    #paige-pages .paige-reading-time,
+    #paige-pages .paige-series,
    #paige-pages .paige-summary,
    #paige-pages .paige-terms {
        display: block;
    }
+series: ["demo"]
 tags: ["show", "singles"]
 title: "Show Data"
-weight: 10
 ---

 This site hides some single page data by default. This page shows it all.
@@ -39,12 +41,14 @@ paige:
    #paige-credit,
    #paige-date,
    #paige-reading-time,
+    #paige-series,
    #paige-terms,
    #paige-toc,
    #paige-pages .paige-authors,
    #paige-pages .paige-date,
    #paige-pages .paige-date-header,
    #paige-pages .paige-reading-time,
+    #paige-pages .paige-series,
    #paige-pages .paige-summary,
    #paige-pages .paige-terms {
        display: block;
--- a/exampleSite/content/customization/style.md
+++ b/exampleSite/content/customization/style.md
@@ -9,12 +9,14 @@ paige:
    #paige-credit,
    #paige-date,
    #paige-reading-time,
+    #paige-series,
    #paige-terms,
    #paige-toc,
    #paige-pages .paige-authors,
    #paige-pages .paige-date,
    #paige-pages .paige-date-header,
    #paige-pages .paige-reading-time,
+    #paige-pages .paige-series,
    #paige-pages .paige-summary,
    #paige-pages .paige-terms {
        display: block;
@@ -24,16 +26,19 @@ paige:
    #paige-date { font-style: italic; }
    #paige-description { font-style: italic; }
    #paige-reading-time { font-style: italic; }
+    #paige-series { font-style: italic; }
    #paige-terms { font-style: italic; }
    #paige-title { font-style: italic; }
    #paige-toc { font-style: italic; }
    #paige-copyright { font-style: italic; }
    #paige-credit { font-style: italic; }
    #paige-pages .paige-authors { font-style: italic; }
-    #paige-pages .paige-date-header { font-style: italic; }
    #paige-pages .paige-date { font-style: italic; }
+    #paige-pages .paige-date-header { font-style: italic; }
+    #paige-pages .paige-series { font-style: italic; }
    #paige-pages .paige-summary { font-style: italic; }
    #paige-pages .paige-term { font-style: italic; }
+series: ["demo"]
 tags: ["singles", "style"]
 title: "Style Data"
 weight: 20
@@ -54,12 +59,14 @@ paige:
    #paige-credit,
    #paige-date,
    #paige-reading-time,
+    #paige-series,
    #paige-terms,
    #paige-toc,
    #paige-pages .paige-authors,
    #paige-pages .paige-date,
    #paige-pages .paige-date-header,
    #paige-pages .paige-reading-time,
+    #paige-pages .paige-series,
    #paige-pages .paige-summary,
    #paige-pages .paige-terms {
        display: block;
@@ -69,14 +76,16 @@ paige:
    #paige-date { font-style: italic; }
    #paige-description { font-style: italic; }
    #paige-reading-time { font-style: italic; }
+    #paige-series { font-style: italic; }
    #paige-terms { font-style: italic; }
    #paige-title { font-style: italic; }
    #paige-toc { font-style: italic; }
    #paige-copyright { font-style: italic; }
    #paige-credit { font-style: italic; }
    #paige-pages .paige-authors { font-style: italic; }
-    #paige-pages .paige-date-header { font-style: italic; }
    #paige-pages .paige-date { font-style: italic; }
+    #paige-pages .paige-date-header { font-style: italic; }
+    #paige-pages .paige-series { font-style: italic; }
    #paige-pages .paige-summary { font-style: italic; }
    #paige-pages .paige-term { font-style: italic; }
 ```
--- a/exampleSite/content/series/demo/_index.md
+++ b/exampleSite/content/series/demo/_index.md
@@ -0,0 +1,4 @@
+---
+description: "Demonstration of a series."
+title: "Demo Series"
+---
--- a/exampleSite/layouts/partials/paige/style-first.css
+++ b/exampleSite/layouts/partials/paige/style-first.css
@@ -2,12 +2,14 @@
 #paige-credit,
 #paige-date,
 #paige-reading-time,
+#paige-series,
 #paige-terms,
 #paige-toc,
 #paige-pages .paige-authors,
 #paige-pages .paige-date,
 #paige-pages .paige-date-header,
 #paige-pages .paige-reading-time,
+#paige-pages .paige-series,
 #paige-pages .paige-summary,
 #paige-pages .paige-terms {
    display: none;
--- a/layouts/partials/paige/metadata.html
+++ b/layouts/partials/paige/metadata.html
@@ -18,6 +18,7 @@
 {{ $id := not $fullpages }}
 {{ $nogap := "mb-0" }}
 {{ $readingtime := $page.ReadingTime }}
+{{ $series := $page.Params.series }}
 {{ $tags := $page.Params.tags | default slice | uniq }}
 {{ $title := $page.Title | markdownify }}
 {{ $titlelink := $page.Params.link }}
@@ -54,8 +55,22 @@
        </p>
    {{ end }}

-    {{ if or $authors $date $readingtime }}
+    {{ if or $authors $date $readingtime $series }}
        <div class="mb-3">
+            {{ with $series }}
+                <p class="mb-0 {{ if $class }} paige-series {{ end }} text-center text-secondary" {{ if $id }} id="paige-series" {{ end }}>
+                    {{ range $i, $name := . -}}
+                        {{- if gt $i 0 }}, {{ end -}}
+
+                        {{- with site.GetPage (print "series/" $name) -}}
+                            <a class="link-secondary text-decoration-none" href="{{ .RelPermalink }}">{{ .Title | default $name }}</a>
+                        {{- else -}}
+                            {{- $name -}}
+                        {{- end -}}
+                    {{- end }}
+                </p>
+            {{ end }}
+
            {{ with $authors }}
                <p class="mb-0 {{ if $class }} paige-authors {{ end }} text-center text-secondary" {{ if $id }} id="paige-authors" {{ end }}>{{ . }}</p>
            {{ end }}
--- a/layouts/partials/paige/page.html
+++ b/layouts/partials/paige/page.html
@@ -11,6 +11,7 @@
 {{ $modified := and .PublishDate .Lastmod (lt .PublishDate .Lastmod) }}
 {{ $pinned := .Params.paige.pin }}
 {{ $readingtime := .ReadingTime }}
+{{ $series := .Params.series }}
 {{ $summary := .Summary | htmlUnescape | plainify }}
 {{ $tags := .Params.tags | default slice | uniq }}
 {{ $title := .Title | markdownify }}
@@ -74,6 +75,20 @@
        </p>
    {{ end }}

+    {{ with $series }}
+        <p class="mb-0 paige-series text-center text-secondary">
+            {{ range $i, $name := . -}}
+                {{- if gt $i 0 }}, {{ end -}}
+
+                {{- with site.GetPage (print "series/" $name) -}}
+                    <a class="link-secondary text-decoration-none" href="{{ .RelPermalink }}">{{ .Title | default $name }}</a>
+                {{- else -}}
+                    {{- $name -}}
+                {{- end -}}
+            {{- end }}
+        </p>
+    {{ end }}
+
    {{ with $authors }}
        <p class="mb-0 paige-authors text-center text-secondary">{{ . }}</p>
    {{ end }}