Add arrow in the right side of list page section buttons

This makes it more obvious that you can click this to view a different
area.

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

@@ -302,16 +302,30 @@ body {
   max-width: calc(720px + 2 * var(--page-margin)); /* padding is included in the element's width */
 }
 
-footer {
+.site-footer {
   margin: var(--page-margin) 0;
   text-align: center;
   font-size: smaller;
 }
 
-footer p {
+.site-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 */
+}
+
 /* }}} */
 
 /* Top bar formatting {{{ */
@@ -326,7 +340,7 @@ footer p {
    * or it will need its hover background to be chopped off on the left */
 }
 
-.header {
+.top-brand {
   flex-grow: 1;
   margin: 8px var(--page-margin);
   font-size: 1.25em;
@@ -334,48 +348,32 @@ footer p {
   align-items: center;
 }
 
-.header a {
+.top-brand > a {
   color: inherit;
   font-weight: bold;
 }
 
-.navbar {
+.top-navbar {
   display: flex;
   flex-wrap: wrap;
 }
 
-.navbar-item {
+.top-navbar-item {
   padding: 12px var(--page-margin);
   white-space: nowrap;
 }
 
-.navbar-item:hover {
+.top-navbar-item:hover {
   background-color: var(--background-2);
   text-decoration: none;
 }
 
-.navbar-item.active {
+.top-navbar-item--active {
   font-weight: bold;
 }
 
 /* }}} */
 
-/* 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 {
@@ -448,13 +446,6 @@ footer p {
 
 /* List layout {{{ */
 
-/* flexbox container for sections and main page list */
-.list-page-container {
-  display: flex;
-  flex-direction: column;
-  gap: 40px;
-}
-
 .page-list {
   display: flex;
   flex-direction: column;
@@ -508,6 +499,14 @@ footer p {
   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;
 }
@@ -601,6 +600,7 @@ footer p {
 /* Subsections on list pages {{{ */
 
 .sections {
+  margin-bottom: 60px;
   display: flex;
   flex-direction: column;
   gap: 10px;
@@ -611,6 +611,9 @@ footer p {
   color: var(--text-1);
   border-radius: 12px;
   padding: 1px 25px;
+  display: flex;
+  flex-direction: row;
+  justify-content: space-between;
 }
 
 .section:hover {
@@ -634,8 +637,14 @@ footer p {
   margin-bottom: 5px;
 }
 
-.view-section {
-  margin-top: 5px;
+.section-arrow {
+  margin-block: auto;
+  max-height: fit-content;
+  float: right;
+}
+.section-arrow > .icon {
+  height: 48px;
+  width: 48px;
 }
 
 /* }}} */
@@ -705,19 +714,6 @@ footer p {
 }
 */
 
-/* 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 {
@@ -768,6 +764,45 @@ footer p {
 
 /* }}} */
 
+/* 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;
@@ -884,42 +919,21 @@ aside.quote {
 
 /* }}} */
 
-/* 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);
+/* 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 .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);
+.see-also p {
+  margin: 0;
 }
 
 /* }}} */
 
-/* }}} */
 
 
 /* @media specializations {{{ */

assets/css/noscript.css

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

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/page-metadata/post-full.html

@@ -1,5 +1,5 @@
 {{ if or .Date .Params.authors .Site.Params.readingtime .Site.Params.gitFileURL }}
-    <div class="page-metadata" aria-label="{{ i18n "aria_post_metadata" }}">
+    <section class="page-metadata" aria-label="{{ i18n "aria_post_metadata" }}">
         {{ if .Date }}
             <span class="page-metadata-item" aria-label="{{ i18n "aria_post_meta_date" }}">
                 {{ partial "icon.html" "calendar" }}
@@ -26,5 +26,5 @@
         {{ partial "page-metadata/item/categories.html" . }}
 
         {{ partial "page-metadata/item/tags.html" . }}
-    </div>
+    </section>
 {{ end }}

layouts/_partials/page-metadata/post-short.html

@@ -1,5 +1,5 @@
 {{ if or .Date .Params.authors .Site.Params.readingtime }}
-    <div class="page-metadata" aria-label="{{ i18n "aria_post_metadata" }}">
+    <section class="page-metadata" aria-label="{{ i18n "aria_post_metadata" }}">
         {{ if .Date }}
             <span class="page-metadata-item" aria-label="date">
                 {{ partial "icon.html" "calendar" }}
@@ -14,5 +14,5 @@
         {{ partial "page-metadata/item/series.html" . }}
         {{ partial "page-metadata/item/categories.html" . }}
         {{ partial "page-metadata/item/tags.html" . }}
-    </div>
+    </section>
 {{ end }}

layouts/_partials/share.html

@@ -1,4 +1,4 @@
-<div class="share-buttons">
+<section class="share-buttons">
     {{ if .Site.Params.shareButtons.twitter }}
         <a class="twitter-share"
            target="_blank"
@@ -66,4 +66,4 @@
             {{- partial "icon.html" "printer" -}}
         </a>
     {{ end }}
-</div>
+</section>

layouts/_partials/top.html

@@ -1,13 +1,13 @@
-<div class="top">
-    <header class="header">
+<header class="top">
+    <div class="top-brand">
         <a href="{{ .Site.Home.Permalink | absLangURL }}">
             {{ .Site.Title | markdownify }}
         </a>
-    </header>
+    </div>
 
-    <nav class="navbar" aria-label="{{ i18n "aria_navbar" }}">
+    <nav class="top-navbar" aria-label="{{ i18n "aria_navbar" }}">
         {{ with .Site.Home }}
-            <a class="navbar-item{{ if $.IsHome }} active{{ end }}" href="{{ .Permalink | absLangURL }}">{{ .Title | markdownify }}</a>
+            <a class="top-navbar-item{{ if $.IsHome }} top-navbar-item--active{{ end }}" href="{{ .Permalink | absLangURL }}">{{ .Title | markdownify }}</a>
         {{ end }}
 
         {{ range .Site.Menus.main }}
@@ -16,9 +16,9 @@
             {{ if or ($.HasMenuCurrent .Menu .) (eq .Page $) }}
                 {{ $isActive = true }}
             {{ end }}
-            <a class="navbar-item{{ if $isActive }} active{{ end }}"
+            <a class="top-navbar-item{{ if $isActive }} top-navbar-item--active{{ end }}"
                {{ if strings.HasPrefix .URL "http" }}target="_blank" rel="noopener"{{ end }}
                href="{{ .URL }}">{{ .Name }}</a>
         {{ end }}
     </nav>
-</div>
+</header>

layouts/baseof.html

@@ -20,7 +20,7 @@
             </main>
 
             {{ if or .Site.Copyright .Site.Params.footer }}
-                <footer>
+                <footer class="site-footer">
                     {{ with .Site.Copyright }}
                         {{ . | safeHTML }}
                     {{ end }}

layouts/home.html

@@ -3,10 +3,10 @@
         <article class="homepage-content">
             {{ . }}
         </article>
-        <hr>
     {{ end }}
 
     {{ if .Site.Params.homepageLatestPosts }}
+        <hr>
         <div class="homepage-latest-posts">
             <h1>
                 {{ i18n "latest_posts" }}

layouts/page.html

@@ -1,74 +1,76 @@
 {{ define "main" }}
-    <div class="page-title">
-        <h1>
-            {{ .Title | markdownify }}
-            {{ if .Draft }}{{ partial "icon.html" "write" }}{{ end }}
-        </h1>
-    </div>
+    <article>
+        <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 }}
+            <section class="table-of-contents" aria-label="{{ i18n "aria_table_of_contents" }}">
+                <details>
+                    <summary>{{ i18n "table_of_contents" }}</summary>
+                    {{ .TableOfContents }}
+                </details>
+            </section>
+            <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>
-    {{ end }}
+            </div>
+        {{ end }}
 
-    {{ partial "feature-figure.html" . }}
+        {{ partial "feature-figure.html" . }}
 
-    <article class="post-content" data-pagefind-body>
-        {{ .Content }}
+        <div class="post-content" data-pagefind-body>
+            {{ .Content }}
+        </div>
+
+        {{ partial "series-box.html" . }}
+
+        {{ if or .NextInSection .PrevInSection }}
+            <nav 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 }}
+            </nav>
+        {{ end }}
+
+        {{ if .Site.Params.shareButtons }}
+            {{ partial "share.html" . }}
+        {{ end }}
+
+        {{ if .Params.comments }}
+            <section class="comments">
+                {{ partial "comments.html" . }}
+            </section>
+        {{ 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 }}
 
 

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.html

@@ -9,17 +9,15 @@
         {{ . }}
     {{ end }}
 
-    <div class="list-page-container">
-        {{ with .Sections }}
-            <div class="sections">
-                {{ range . }}
-                    {{ .Render "summary" }}
-                {{ end }}
-            </div>
-        {{ end }}
+    {{ with .Sections }}
+        <div class="sections">
+            {{ range . }}
+                {{ .Render "summary" }}
+            {{ end }}
+        </div>
+    {{ end }}
 
-        {{ partial "page-list.html" .Paginator.Pages }}
-    </div>
+    {{ partial "page-list.html" .Paginator.Pages }}
 
     {{ partial "pagination.html" . }}
 {{ end }}

layouts/section.summary.html

@@ -1,14 +1,20 @@
 <a class="section-anchor" href="{{ .Permalink }}">
     <div class="section">
-        <h2 class="section-title">
-            {{ with .Params.icon }}{{ partial "icon.html" . }}{{ end }}
-            {{ .Title | markdownify }}
-        </h2>
+        <div>
+            <h2 class="section-title">
+                {{ with .Params.icon }}{{ partial "icon.html" . }}{{ end }}
+                {{ .Title | markdownify }}
+            </h2>
 
-        {{ with .Summary }}
-            <div class="section-description">
-                {{ . }}
-            </div>
-        {{ end }}
+            {{ with .Summary }}
+                <div class="section-description">
+                    {{ . }}
+                </div>
+            {{ end }}
+        </div>
+
+        <div class="section-arrow">
+            {{ partial "icon.html" "arrow-right" }}
+        </div>
     </div>
 </a>

layouts/series/taxonomy.html

@@ -1,8 +1,10 @@
 {{ define "main" }}
-    <h1>
-        {{ partial "icon.html" "files" }}
-        {{ .Title | markdownify }}
-    </h1>
+    <div class="page-title">
+        <h1>
+            {{ partial "icon.html" "files" }}
+            {{ .Title | markdownify }}
+        </h1>
+    </div>
 
     {{ with .Content }}
         {{ . }}

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"