WIP body-module and smarter usage of container divs

I think this version has the newest features that I'm using. Hopefully I
didn't miss/forget about something when skimming through the Hugo
release history just now.

archetypes/blog/index.md

@@ -24,7 +24,17 @@ series:
 resources:
   - name: feature
     src: something.webp
-    title: Some image (image format can be anything; webp is just an example)
+    title: >-
+      Fallback title if one is not provided when calling figure shortcode with
+      this listed as the src
+    params:
+      alt: Write an accessible description of this image. Don't over-write.
+
+  - src: demonstration.webp
+    params:
+      alt: >-
+        Annotate an image without giving it an explicit name (the filename is
+        simply used as the `name` instead).
 
 ---
 

assets/css/bobastyle.css

@@ -158,61 +158,38 @@ pre > code {
 
 /* }}} */
 
-/* Basic elements {{{ */
+/* Common distances/sizes {{{ */
 
-html {
-  scroll-behavior: smooth;
+:root {
+  --page-margin: 16px;
 }
 
-@media screen and (prefers-reduced-motion: reduce) {
-    html {
-        scroll-behavior: auto;
-    }
-}
+/* }}} */
 
-body {
-  background-color: var(--background-0);
-  color: var(--text-0);
-  overflow-wrap: break-word;
-  margin: 0;
-}
 
-.main-container {
-  margin: 20px auto;
-  padding: 0 20px;
-  max-width: 760px; /* 720px + 20px for left & right padding */
-}
-
-footer {
-  margin: 20px 0;
-  text-align: center;
-  font-size: smaller;
-}
-
-footer p {
-  margin: 0;
-}
+/* Common elements {{{ */
 
 img,
 video {
   max-width: 100%;
 }
 
-.post-media > figure img,
-.post-media > figure video {
+figure > .figure-media {
   padding: 5px;
-  border: 7px solid var(--figure-border);
 }
 
-figure img,
-figure video {
-  padding: 5px;
+figure > .figure-media.border {
   border: 2px solid var(--figure-border);
 }
 
+.post-media > figure > .figure-media {
+  border: 7px solid var(--figure-border);
+}
+
 figure {
-  margin: auto;
-  display: inline-block;
+  display: block;
+  text-align: center;
+  margin: 0;
 }
 
 figcaption {
@@ -240,14 +217,6 @@ hr {
   border: 1px solid var(--background-3);
 }
 
-@media (min-width: 720px) {
-  .full-width-hr {
-    /* see also: the related-posts section too */
-    margin-left: calc(-100vw / 2 + 760px / 2);
-    margin-right: calc(-100vw / 2 + 760px / 2);
-  }
-}
-
 table.simple {
   border-collapse: collapse;
   border: 2px solid var(--text-1);
@@ -307,12 +276,72 @@ table.simple tbody tr:nth-child(even) {
 /* }}} */
 
 
-/* Heading formatting (article section titles) {{{ */
+/* Baseof formatting {{{ */
 
-/* this is also used i.e. in page-title */
-.heading-link {
-  color: inherit;
-  font-weight: bold;
+html {
+  scroll-behavior: smooth;
+}
+
+@media screen and (prefers-reduced-motion: reduce) {
+    html {
+        scroll-behavior: auto;
+    }
+}
+
+body {
+  background-color: var(--background-0);
+  color: var(--text-0);
+  overflow-wrap: break-word;
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: var(--page-margin);
+}
+
+.body-module {
+  width: 100%; /* without, it collapses inside flexbox for some reason TODO: figure out why */
+}
+
+.body-module--marginless {
+  margin: 0;
+}
+
+.body-module--full-width {
+  margin: 0 var(--page-margin);
+  /*
+  margin-left: var(--page-margin);
+  margin-right: var(--page-margin);
+  */
+}
+.body-module--wide {
+  margin-left: var(--page-margin);
+  margin-right: var(--page-margin);
+  max-width: 720px;
+}
+
+footer {
+  margin-bottom: var(--page-margin);
+  text-align: center;
+  font-size: smaller;
+}
+
+footer p {
+  margin: 0;
+}
+
+#skip-to-main {
+  position: absolute;
+  padding: 8px;
+  background-color: var(--text-0);
+  color: var(--background-0);
+  transform: translateY(-100%);
+}
+#skip-to-main:focus {
+  transform: translateY(0%);
+}
+#main-content:target {
+  animation: none; /* prevent it from turning yellow */
 }
 
 /* }}} */
@@ -325,23 +354,30 @@ table.simple tbody tr:nth-child(even) {
   flex-wrap: wrap;
   justify-content: space-between;
   background-color: var(--background-1);
+  /* padding can't be here because then the first navbar element will be shifted too far over,
+   * or it will need its hover background to be chopped off on the left */
 }
 
-.header {
+.brand {
   flex-grow: 1;
-  margin: 8px 16px;
+  margin: 8px var(--page-margin);
   font-size: 1.25em;
   display: flex;
   align-items: center;
 }
 
+.brand a {
+  color: inherit;
+  font-weight: bold;
+}
+
 .navbar {
   display: flex;
   flex-wrap: wrap;
 }
 
 .navbar-item {
-  padding: 12px 16px;
+  padding: 12px var(--page-margin);
   white-space: nowrap;
 }
 
@@ -356,28 +392,8 @@ table.simple tbody tr:nth-child(even) {
 
 /* }}} */
 
-/* Skip to main content {{{ */
-#skip-to-main {
-  position: absolute;
-  padding: 8px;
-  background-color: var(--text-0);
-  color: var(--background-0);
-  transform: translateY(-100%);
-}
-#skip-to-main:focus {
-  transform: translateY(0%);
-}
-#main-content:target {
-  animation: none; /* prevent it from turning yellow */
-}
-/* }}} */
-
 /* Breadcrumb navigation {{{ */
 
-.breadcrumb {
-  margin: 20px 0;
-}
-
 .breadcrumb ul {
   margin: 0;
   padding: 0;
@@ -483,6 +499,10 @@ table.simple tbody tr:nth-child(even) {
   margin-bottom: 10px;
 }
 
+.page-title a {
+  color: inherit;
+}
+
 .page-title h1 {
   margin: 0;
 }
@@ -500,6 +520,14 @@ table.simple tbody tr:nth-child(even) {
   margin-top: 10px;
 }
 
+:is(
+  .page-metadata-section:is(.categories, .tags, .series),
+  .page-metadata-item.authors
+) > a:not(:last-child):after {
+  color: var(--text-0);
+  content: ",";
+}
+
 .post-media {
   margin-top: 15px;
 }
@@ -626,14 +654,10 @@ table.simple tbody tr:nth-child(even) {
   margin-bottom: 5px;
 }
 
-.view-section {
-  margin-top: 5px;
-}
-
 /* }}} */
 
 
-/* Content (single) formatting {{{ */
+/* Components exclusive to content/single pages {{{ */
 
 .series-box {
   background-color: var(--background-1);
@@ -697,19 +721,6 @@ table.simple tbody tr:nth-child(even) {
 }
 */
 
-/* See also formating */
-.see-also {
-  background-color: var(--background-1);
-  color: var(--text-1);
-  padding: 8px 12px;
-  border-radius: 8px;
-  margin: 10px 0;
-}
-
-.see-also p {
-  margin: 0;
-}
-
 /* Previous and next page buttons {{{ */
 
 .prevnext {
@@ -760,6 +771,45 @@ table.simple tbody tr:nth-child(even) {
 
 /* }}} */
 
+/* Related posts section {{{ */
+
+/* set the margins on the contents instead of the parent .related-posts
+ * so that the posts in the list clip off the edge of the screen,
+ * which makes a more obvious indicator that it's scrollable
+ */
+
+.related-posts > hr,
+.related-posts > h1 {
+  margin: var(--page-margin);
+}
+
+.related-posts .page {
+  min-width: 300px;
+  max-width: 300px;
+
+}
+
+.related-posts .page:first-child {
+  margin-left: var(--page-margin);
+}
+.related-posts .page:last-child {
+  margin-right: var(--page-margin);
+}
+
+.related-posts .page-list {
+  display: flex;
+  flex-direction: row;
+  gap: 20px;
+  overflow-x: auto;
+  margin-bottom: var(--page-margin);
+}
+
+/* }}} */
+
+/* }}} */
+
+/* Content components (can appear both in single and list pages) {{{ */
+
 /* Code & code blocks {{{ */
 .code-block {
   display: flex;
@@ -776,10 +826,13 @@ table.simple tbody tr:nth-child(even) {
   padding: 4px 8px;
   border-top-left-radius: 8px;
   border-top-right-radius: 8px;
+  height: 2em;
+}
+.code-block > .code-header > * {
+  margin: auto 0;
 }
 .code-block > .code-header > .code-type {
   border-top-left-radius: 8px;
-  margin: auto 0;
 }
 /* TODO: make the code copy button prettier */
 .code-block > .code-header > .code-copy-button {
@@ -873,44 +926,23 @@ aside.quote {
 
 /* }}} */
 
-/* }}} */
-
-/* Related posts section {{{ */
-
-.full-width-page-list {
-  /* make left/right 0 margin so it takes up full width */
-  margin: 25px 0;
+/* See also formating */
+.see-also {
+  background-color: var(--background-1);
+  color: var(--text-1);
+  padding: 8px 12px;
+  border-radius: 8px;
+  margin: 10px 0;
 }
 
-.related-posts > hr,
-.related-posts > h1 {
-  margin-left: 20px;
-  margin-right: 20px;
-}
-
-.related-posts .page {
-  min-width: 300px;
-  max-width: 300px;
-
-}
-
-.related-posts .page:first-child {
-  margin-left: 20px;
-}
-.related-posts .page:last-child {
-  margin-right: 20px;
-}
-
-.related-posts .page-list {
-  display: flex;
-  flex-direction: row;
-  gap: 20px;
-  overflow-x: scroll;
+.see-also p {
+  margin: 0;
 }
 
 /* }}} */
 
 
+
 /* @media specializations {{{ */
 
 /* Light mode */

assets/css/comments.css

@@ -1,3 +1,14 @@
+.comments > h2 {
+    margin-bottom: 0;
+}
+.comments .email-address-notice {
+    margin: 0;
+    font-size: smaller;
+}
+.comments .enable-javascript-notice {
+    font-style: italic;
+}
+
 /* Isso styling */
 h4.isso-thread-heading {
     color: var(--text-0);

assets/css/noscript.css

@@ -0,0 +1,4 @@
+.page-meta-comments-counter,
+.code-copy-button {
+  display: none;
+}

layouts/_partials/breadcrumb.html

@@ -1,4 +1,4 @@
-<nav class="breadcrumb" aria-label="{{ i18n "aria_breadcrumbnav" }}">
+<nav class="body-module body-module--wide breadcrumb" aria-label="{{ i18n "aria_breadcrumbnav" }}">
     <ul>
         {{ template "breadcrumbnav" (dict "p1" . "p2" .) }}
     </ul>

layouts/_partials/comments.html

@@ -1,15 +1,20 @@
+{{/* put comments CSS here instead of in <head> so that it doesn't get
+   * loaded unnecessarily on regular pages
+   */}}
 {{ with resources.Get "css/comments.css" | fingerprint "sha512" }}
     <link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous">
 {{ end }}
 
-<h2 style="margin-bottom: 0;">Comments</h2>
-<p style="margin: 0; font-size: smaller;">
+<h2>Comments</h2>
+<p class="email-address-notice">
     If you provide an email address, you can enable notifications for
     replies to your comment. It will not be shown publicly.
 </p>
 
 <noscript>
-    <i>Enable JavaScript to see the comment section.</i>
+    <p class="enable-javascript-notice">
+        Enable JavaScript to see the comment section.
+    </p>
 </noscript>
 
 <section id="isso-thread" data-title="{{ .Title }}"></section>

layouts/_partials/description-or-summary.html

@@ -1,7 +0,0 @@
-{{ with .Description }}
-    <p>{{ . | markdownify }}</p>
-{{ else }}
-    {{ with .Summary }}
-        {{ . }}
-    {{ end }}
-{{ end }}

layouts/_partials/embed-resource.html

@@ -3,9 +3,9 @@
        *       claims that images won't work with JS disabled since it would
        *       make tracking possible, but my experience says otherwise
        */}}
-    <img src="{{ .Permalink }}" {{ with .Params.alt }}alt="{{ . }}"{{ end }} />
+    <img class="figure-media" src="{{ .Permalink }}" {{ with .Params.alt }}alt="{{ . }}"{{ end }} />
 {{ else if eq .ResourceType "video" }}
-    <video controls preload="metadata">
+    <video class="figure-media" controls preload="metadata">
         {{ with .Params.alt }}
             {{ warnf "video does not support alt text, '%s'" . }}
         {{ end }}

layouts/_partials/head.html

@@ -6,6 +6,12 @@
     {{ with resources.Get "css/bobastyle.css" | fingerprint "sha512" }}
         <link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous">
     {{ end }}
+    {{ with resources.Get "css/noscript.css" | fingerprint "sha512" }}
+        <noscript>
+            <link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous">
+        </noscript>
+    {{ end }}
+
     {{ with resources.Get "css/syntax.css" | fingerprint "sha512" }}
         <link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous" media="print" onload="this.media='all'">
     {{ end }}

layouts/_partials/page-metadata/item/authors.html

@@ -1,16 +1,9 @@
-{{ with .Params.authors }}
-    <span class="page-metadata-item" data-pagefind-meta="authors" aria-label="{{ i18n "aria_post_meta_authors" }}">
+{{ with .GetTerms "authors" }}
+    <span class="page-metadata-item authors" aria-label="{{ i18n "aria_post_meta_authors" }}">
         {{ partial "icon.html" "user-circle" }}
 
-        {{ if index $.Site.Taxonomies "authors" }}
-            {{ $authors := slice }}
-            {{ range . }}
-                {{ $url := (printf "authors/%s" (. | anchorize)) | absLangURL }}
-                {{ $authors = $authors | append (printf `<a href="%s">%s</a>` $url .) }}
-            {{ end }}
-            {{ delimit $authors ", " | safeHTML }}
-        {{ else }}
-            {{ delimit . ", " }}
+        {{ range . }}
+            <a href="{{ .Permalink }}" data-pagefind-filter="author">{{ .LinkTitle }}</a>
         {{ end }}
     </span>
 {{ end }}

layouts/_partials/page-metadata/item/categories.html

@@ -4,8 +4,10 @@
         {{ $categories = $categories | append (printf `<a href="%s">%s</a>` .Permalink .LinkTitle) }}
     {{ end }}
 
-    <div class="page-metadata-section categories" data-pagefind-meta="categories" aria-label="{{ i18n "aria_post_meta_categories" }}">
+    <div class="page-metadata-section categories" aria-label="{{ i18n "aria_post_meta_categories" }}">
         {{ partial "icon.html" "folder" }}
-        {{ delimit $categories ", " | safeHTML }}
+        {{ range . }}
+            <a href="{{ .Permalink }}" data-pagefind-filter="category">{{ .LinkTitle }}</a>
+        {{ end }}
     </div>
 {{ end }}

layouts/_partials/page-metadata/item/comments-counter.html

@@ -1,4 +1,4 @@
-<span class="page-metadata-item" aria-label="comments counter">
+<span class="page-metadata-item page-meta-comments-counter" aria-label="comments counter">
     {{ partial "icon.html" "message" }}
     {{/* TODO: figure out if there's a nicer way to generate this URL
        * the current issue is that we can't use RelRef, since content view means that we don't

layouts/_partials/page-metadata/item/series.html

@@ -1,11 +1,8 @@
 {{ with (.GetTerms "series") }}
-    {{ $series := slice }}
-    {{ range . }}
-        {{ $series = $series | append (printf `<a href="%s">%s</a>` .Permalink .LinkTitle) }}
-    {{ end }}
-
-    <div class="page-metadata-section series" data-pagefind-meta="series" aria-label="{{ i18n "aria_post_meta_series" }}">
+    <div class="page-metadata-section series" aria-label="{{ i18n "aria_post_meta_series" }}">
         {{ partial "icon.html" "files" }}
-        {{ delimit $series ", " | safeHTML }}
+        {{ range . }}
+            <a href="{{ .Permalink }}" data-pagefind-filter="series">{{ .LinkTitle }}</a>
+        {{ end }}
     </div>
 {{ end }}

layouts/_partials/page-metadata/item/tags.html

@@ -1,11 +1,10 @@
 {{ with (.GetTerms "tags") }}
     {{ $tags := slice }}
-    {{ range . }}
-        {{ $tags = $tags | append (printf `<a href="%s">%s</a>` .Permalink .LinkTitle) }}
-    {{ end }}
 
-    <div class="page-metadata-section tags" data-pagefind-meta="tags" aria-label="{{ i18n "aria_post_meta_tags" }}">
+    <div class="page-metadata-section tags" aria-label="{{ i18n "aria_post_meta_tags" }}">
         {{ partial "icon.html" "tag" }}
-        {{ delimit $tags ", " | safeHTML }}
+        {{ range . }}
+            <a href="{{ .Permalink }}" data-pagefind-filter="tag">{{ .LinkTitle }}</a>
+        {{ end }}
     </div>
 {{ end }}

layouts/_partials/pagination.html

@@ -1,6 +1,6 @@
 {{ if gt .Paginator.TotalPages 1 }}
     <nav class="pagination">
         {{/* https://github.com/gohugoio/hugo/blob/a88b488181279befd50e1d127f9f67604f2f9854/tpl/tplimpl/embedded/templates/_partials/pagination.html */}}
-        {{ partial "_internal/pagination.html" . }}
+        {{ partial "pagination-hugo.html" . }}
     </nav>
 {{ end }}

layouts/_partials/seo-tags/opengraph.html

@@ -3,16 +3,6 @@
 <meta property="og:type" content="{{ if .IsPage }}article{{ else }}website{{ end }}">
 <meta property="og:url" content="{{ .Permalink }}">
 
-{{ $images := $.Resources.ByType "image" }}
-{{ $featured := $images.GetMatch "*feature*" }}
-{{ if not $featured }}
-    {{ $featured = $images.GetMatch "{*cover*,*thumbnail*}" }}
-{{ end }}
-
-{{ with $featured }}
-    <meta property="og:image" content="{{ $featured.Permalink }}">
-{{ end }}
-
 {{ with .Section }}
     <meta property="article:section" content="{{ . }}">
 {{ end }}
@@ -37,12 +27,38 @@
     <meta property="og:site_name" content="{{ . }}">
 {{ end }}
 
+{{ $images := $.Resources.ByType "image" }}
+{{ $featured := $images.GetMatch "*feature*" }}
+{{ if not $featured }}
+    {{ $featured = $images.GetMatch "{*cover*,*thumbnail*}" }}
+{{ end }}
+
+{{ with $featured }}
+    <meta property="og:image" content="{{ $featured.Permalink }}">
+    {{ with .Params.alt }}
+        <meta property="og:image:alt" content="{{ . }}">
+    {{ end }}
+    {{ with .MediaType }}
+        <meta property="og:image:type" content="{{ . }}">
+    {{ end }}
+    {{ with .Width }}
+        <meta property="og:image:width" content="{{ . }}">
+    {{ end }}
+    {{ with .Height }}
+        <meta property="og:image:height" content="{{ . }}">
+    {{ end }}
+{{ end }}
+
 {{ $videos := $.Resources.ByType "video" }}
 {{ $featured_video := $videos.GetMatch "*feature*" }}
 {{ if not $featured_video }}
     {{ $featured_video = $videos.GetMatch "{*cover*,*thumbnail*}" }}
 {{ end }}
 
+
 {{ with $featured_video }}
     <meta property="og:video" content="{{ $featured_video.Permalink | absURL }}">
+    {{ with .MediaType }}
+        <meta property="og:video:type" content="{{ . }}">
+    {{ end }}
 {{ end }}

layouts/_partials/seo-tags/twitter-cards.html

@@ -31,6 +31,8 @@
    */}}
 {{ with .Site.Params.social.twitter }}
     <meta name="twitter:site" content="@{{ . }}">
+{{ else }}
+    {{ errorf "a twitter username is required for twitter cards to work" }}
 {{ end }}
 {{ with .GetTerms "authors" }}
     {{ range . }}

layouts/_partials/top.html

@@ -1,9 +1,9 @@
-<div class="top">
-    <header class="header">
-        <a class="heading-link" href="{{ .Site.Home.Permalink | absLangURL }}">
+<header class="body-module body-module--marginless top">
+    <div class="brand">
+        <a href="{{ .Site.Home.Permalink | absLangURL }}">
             {{ .Site.Title | markdownify }}
         </a>
-    </header>
+    </div>
 
     <nav class="navbar" aria-label="{{ i18n "aria_navbar" }}">
         {{ with .Site.Home }}
@@ -21,4 +21,4 @@
                href="{{ .URL }}">{{ .Name }}</a>
         {{ end }}
     </nav>
-</div>
+</header>

layouts/_shortcodes/full-width-hr.html

@@ -1 +0,0 @@
-<hr class="full-width-hr">

layouts/authors/summary.html

@@ -1,13 +1,15 @@
 <h2 class="page-title">
-    <a class="heading-link" href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
+    <a href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
     {{ if .Draft }}{{ partial "icon.html" "write" }}{{ end }}
 </h2>
 
 {{ partial "page-metadata/author.html" . }}
 
-<div class="page-description">
-    {{ partial "description-or-summary.html" . }}
-</div>
+{{ with .Summary }}
+    <div class="page-description">
+        {{ . }}
+    </div>
+{{ end }}
 
 <div class="readmore">
     <a href="{{ .Permalink }}">{{ i18n "read_more" }} &rarr;</a>

layouts/baseof.html

@@ -8,24 +8,20 @@
 
         {{ partial "top.html" . }}
 
-        <div class="main-container">
-            {{ if not .IsHome }}
-                {{ partial "breadcrumb.html" . }}
-            {{ end }}
-
-            <main id="main-content" {{ if .IsPage }}data-pagefind-body{{ end }}>
-                {{ block "main" . }}
-                    THIS TEXT SHOULD NOT SHOW. YUZSIQGHE (that string is so I can grep for it)
-                {{ end }}
-            </main>
-        </div>
-
-        {{ block "post-body" . }}
-            {{/* currently this is only used for related posts */}}
+        {{ if not .IsHome }}
+            {{ partial "breadcrumb.html" . }}
         {{ end }}
 
+        {{ block "pre-body" . }}{{ end }}
+
+        <main id="main-content">
+            {{ block "main" . }}
+                THIS TEXT SHOULD NOT SHOW. YUZSIQGHE (that string is so I can grep for it)
+            {{ end }}
+        </main>
+
         {{ if or .Site.Copyright .Site.Params.footer }}
-            <footer>
+            <footer class="body-module body-module--wide">
                 {{ with .Site.Copyright }}
                     {{ . | safeHTML }}
                 {{ end }}
@@ -35,6 +31,10 @@
                 {{ end }}
             </footer>
         {{ end }}
+
+        {{ block "post-body" . }}
+            {{/* currently this is only used for related posts */}}
+        {{ end }}
     </body>
 
 </html>

layouts/home.html

@@ -1,13 +1,13 @@
 {{ define "main" }}
     {{ with .Content }}
-        <article class="homepage-content">
+        <article class="body-module body-module--wide">
             {{ . }}
         </article>
-        <hr>
+        <hr class="body-module body-module--wide">
     {{ end }}
 
     {{ if .Site.Params.homepageLatestPosts }}
-        <div class="homepage-latest-posts">
+        <div class="body-module body-module--wide">
             <h1>
                 {{ i18n "latest_posts" }}
                 {{ partial "rss-link.html" . }}

layouts/page.html

@@ -1,84 +1,86 @@
 {{ define "main" }}
-    <div class="page-title">
-        <h1>
-            {{ .Title | markdownify }}
-            {{ if .Draft }}{{ partial "icon.html" "write" }}{{ end }}
-        </h1>
-    </div>
+    <article class="body-module body-module--wide">
+        <div class="page-title">
+            <h1>
+                {{ .Title | markdownify }}
+                {{ if .Draft }}{{ partial "icon.html" "write" }}{{ end }}
+            </h1>
+        </div>
 
-    {{ partial "page-metadata/post-full.html" . }}
-    {{ partial "series-box.html" . }}
+        {{ partial "page-metadata/post-full.html" . }}
+        {{ partial "series-box.html" . }}
 
-    {{ if .Params.Toc }}
-        <div class="table-of-contents" aria-label="{{ i18n "aria_table_of_contents" }}">
-            <details>
-                <summary>{{ i18n "table_of_contents" }}</summary>
+        {{ if .Params.Toc }}
+            <div class="table-of-contents" aria-label="{{ i18n "aria_table_of_contents" }}">
+                <details>
+                    <summary>{{ i18n "table_of_contents" }}</summary>
+                    {{ .TableOfContents }}
+                </details>
+            </div>
+            <div class="table-of-contents print">
+                {{ i18n "table_of_contents" }}
                 {{ .TableOfContents }}
-            </details>
-        </div>
-        <div class="table-of-contents print">
-            {{ i18n "table_of_contents" }}
-            {{ .TableOfContents }}
-        </div>
+            </div>
+        {{ end }}
+
+        {{ partial "feature-figure.html" . }}
+
+        <article class="post-content" data-pagefind-body>
+            {{ .Content }}
+        </article>
+
+        {{ partial "series-box.html" . }}
+
+        {{ if or .NextInSection .PrevInSection }}
+            <div class="prevnext">
+                {{ with .NextInSection }}
+                    <a class="prev" href="{{ .Permalink }}">
+                        <div class="prev-caption">
+                            &larr; {{ i18n "newer_post" }}
+                        </div>
+                        <div class="prev-post">
+                            {{ .Title | markdownify }}
+                        </div>
+                    </a>
+                {{ else }}
+                    <div class="prev"></div>
+                {{ end }}
+
+                {{ with .PrevInSection }}
+                    <a class="next" href="{{ .Permalink }}">
+                        <div class="next-caption">
+                            {{ i18n "older_post" }} &rarr;
+                        </div>
+                        <div class="next-post">
+                            {{ .Title | markdownify }}
+                        </div>
+                    </a>
+                {{ else }}
+                    <div class="next"></div>
+                {{ end }}
+            </div>
+        {{ end }}
+
+        {{ if .Site.Params.shareButtons }}
+            {{ partial "share.html" . }}
+        {{ end }}
+
+        {{ if .Params.comments }}
+            <div class="comments">
+                {{ partial "comments.html" . }}
+            </div>
+        {{ end }}
     {{ end }}
 
-    {{ partial "feature-figure.html" . }}
 
-    <article class="post-content">
-        {{ .Content }}
+    {{ define "post-body" }}
+        {{ $related := .Site.RegularPages.Related . | first 10 }}
+        {{ with $related }}
+            <div class="related-posts">
+                <hr>
+                <h1>{{ i18n "related_posts" }}</h1>
+                {{ partial "page-list.html" . }}
+            </div>
+        {{ end }}
     </article>
-
-    {{ partial "series-box.html" . }}
-
-    {{ if or .NextInSection .PrevInSection }}
-        <div class="prevnext">
-            {{ with .NextInSection }}
-                <a class="prev" href="{{ .Permalink }}">
-                    <div class="prev-caption">
-                        &larr; {{ i18n "newer_post" }}
-                    </div>
-                    <div class="prev-post">
-                        {{ .Title | markdownify }}
-                    </div>
-                </a>
-            {{ else }}
-                <div class="prev"></div>
-            {{ end }}
-
-            {{ with .PrevInSection }}
-                <a class="next" href="{{ .Permalink }}">
-                    <div class="next-caption">
-                        {{ i18n "older_post" }} &rarr;
-                    </div>
-                    <div class="next-post">
-                        {{ .Title | markdownify }}
-                    </div>
-                </a>
-            {{ else }}
-                <div class="next"></div>
-            {{ end }}
-        </div>
-    {{ end }}
-
-    {{ if .Site.Params.shareButtons }}
-        {{ partial "share.html" . }}
-    {{ end }}
-
-    {{ if .Params.comments }}
-        <div class="comments">
-            {{ partial "comments.html" . }}
-        </div>
-    {{ end }}
-{{ end }}
-
-
-{{ define "post-body" }}
-    {{ $related := .Site.RegularPages.Related . | first 10 }}
-    {{ with $related }}
-        <div class="related-posts">
-            <hr>
-            <h1>{{ i18n "related_posts" }}</h1>
-            {{ partial "page-list.html" . }}
-        </div>
-    {{ end }}
 {{ end }}

layouts/robots.txt

@@ -1,2 +1,6 @@
 User-Agent: *
 Sitemap: {{ "sitemap.xml" | absLangURL }}
+
+{{/* It complains about the raw markdown output having no title tag */ -}}
+User-Agent: Bingbot
+Disallow: /blog/*.md$

layouts/section.summary.html

@@ -5,8 +5,10 @@
             {{ .Title | markdownify }}
         </h2>
 
-        <div class="section-description">
-            {{ partial "description-or-summary.html" . }}
-        </div>
+        {{ with .Summary }}
+            <div class="section-description">
+                {{ . }}
+            </div>
+        {{ end }}
     </div>
 </a>

layouts/series/summary.html

@@ -1,14 +1,16 @@
 <h2 class="page-title">
     {{ with .Parent.Params.icon }}{{ partial "icon.html" . }}{{ end }}
-    <a class="heading-link" href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
+    <a href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
     {{ if .Draft }}{{ partial "icon.html" "write" }}{{ end }}
 </h2>
 
 {{ partial "page-metadata/series.html" . }}
 
-<div class="page-description">
-    {{ partial "description-or-summary.html" . }}
-</div>
+{{ with .Summary }}
+    <div class="page-description">
+        {{ . }}
+    </div>
+{{ end }}
 
 <div class="page-list series-inner">
     {{ range .Data.Pages.Reverse }}

layouts/summary.html

@@ -1,6 +1,6 @@
 <h2 class="page-title">
     {{ with .Parent.Params.icon }}{{ partial "icon.html" . }}{{ end }}
-    <a class="heading-link" href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
+    <a href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
     {{ if .Draft }}{{ partial "icon.html" "write" }}{{ end }}
 </h2>
 
@@ -8,9 +8,11 @@
 
 {{ partial "feature-figure.html" . }}
 
-<div class="page-description">
-    {{ partial "description-or-summary.html" . }}
-</div>
+{{ with .Summary }}
+    <div class="page-description">
+        {{ . }}
+    </div>
+{{ end }}
 
 <div class="readmore">
     <a href="{{ .Permalink }}">{{ i18n "read_more" }} &rarr;</a>

layouts/taxonomy.html

@@ -28,7 +28,7 @@
                             </a>
                             {{ partial "page-metadata/taxonomy.html" . }}
                         </div>
-                        {{ partial "description-or-summary.html" . }}
+                        {{ .Summary }}
                     </article>
                 {{ end }}
             {{ end }}

theme.toml

@@ -8,7 +8,7 @@ description = "Simple Hugo theme for boba.best and bbaovanc.com"
 homepage = "https://bbaovanc.com"
 tags = []
 features = []
-min_version = "0.93.0"
+min_version = "0.146.0"
 
 [author]
   name = "bbaovanc"