Only show hr on home if homepageLatestPosts enabled

Otherwise there's just a random line separator for no reason.

.gitmodules

@@ -1,4 +1,4 @@
 [submodule "assets/jam"]
 	path = assets/jam
-	url = https://github.com/michaelampr/jam.git
+	url = https://github.com/BBaoVanC/jam.git
 	branch = master

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 {
+:root {
-  scroll-behavior: smooth;
+  --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 {
+/* Common elements {{{ */
-  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;
-}
 
 img,
 video {
   max-width: 100%;
 }
 
-.post-media > figure.border img,
+figure > .figure-media {
-.post-media > figure.border video {
   padding: 5px;
-  border: 7px solid var(--figure-border);
 }
 
-figure.border img,
+figure > .figure-media.border {
-figure.border video {
-  padding: 5px;
   border: 2px solid var(--figure-border);
 }
 
+.post-media > figure > .figure-media {
+  border: 7px solid var(--figure-border);
+}
+
 figure {
-  margin: auto;
+  display: block;
-  display: inline-block;
+  text-align: center;
+  margin: 0;
 }
 
 figcaption {
@@ -240,39 +217,31 @@ hr {
   border: 1px solid var(--background-3);
 }
 
-@media (min-width: 720px) {
+table.simple {
-  .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.markdown {
   border-collapse: collapse;
   border: 2px solid var(--text-1);
 }
 
-table.markdown thead {
+table.simple thead {
   background-color: var(--background-2);
   color: var(--text-2);
   border-bottom: 2px solid var(--text-1);
 }
 
-table.markdown th,
+table.simple th,
-table.markdown td {
+table.simple td {
   padding: 8px;
 }
 
-table.markdown :is(th, td) + :is(th, td) {
+table.simple :is(th, td) + :is(th, td) {
   border-left: 2px solid var(--text-1);
 }
 
-table.markdown tbody tr:nth-child(odd) {
+table.simple tbody tr:nth-child(odd) {
   background-color: var(--background-0);
   color: var(--text-0);
 }
-table.markdown tbody tr:nth-child(even) {
+table.simple tbody tr:nth-child(even) {
   background-color: var(--background-1);
   color: var(--text-1);
 }
@@ -291,33 +260,70 @@ table.markdown tbody tr:nth-child(even) {
 
 /* Icons */
 .icon {
-  width: 20px;
+  width: 1em;
-  height: 20px;
+  height: 1em;
   color: var(--text-1);
   text-align: center;
   display: inline;
-  vertical-align: middle;
+  vertical-align: sub;
 }
 
-h1 svg.icon {
+/* workarounds for some icons from jam-icons being non-square aspect ratio */
-  width: 30px;
+.icon-code {
-  height: 30px;
+  width: 1.25em;
 }
 
 /* }}} */
 
 
-/* Heading formatting (article section titles) {{{ */
+/* Baseof formatting {{{ */
 
-/* this is also used i.e. in page-title */
+html {
-.heading-link {
+  scroll-behavior: smooth;
-  color: inherit;
-  font-weight: bold;
 }
 
-.heading-link svg {
+@media screen and (prefers-reduced-motion: reduce) {
-  width: 15px;
+    html {
-  height: 15px;
+        scroll-behavior: auto;
+    }
+}
+
+body {
+  background-color: var(--background-0);
+  color: var(--text-0);
+  overflow-wrap: break-word;
+  margin: 0;
+}
+
+.main-container {
+  margin: var(--page-margin) auto;
+  /* use padding because otherwise there's no way to have margin be both auto, and a minimum value */
+  padding: 0 var(--page-margin);
+  max-width: calc(720px + 2 * var(--page-margin)); /* padding is included in the element's width */
+}
+
+.site-footer {
+  margin: var(--page-margin) 0;
+  text-align: center;
+  font-size: smaller;
+}
+
+.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 */
 }
 
 /* }}} */
@@ -330,23 +336,30 @@ h1 svg.icon {
   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;
 }
 
@@ -361,26 +374,10 @@ h1 svg.icon {
 
 /* }}} */
 
-/* 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;
+  margin: var(--page-margin) 0;
 }
 
 .breadcrumb ul {
@@ -488,6 +485,10 @@ h1 svg.icon {
   margin-bottom: 10px;
 }
 
+.page-title a {
+  color: inherit;
+}
+
 .page-title h1 {
   margin: 0;
 }
@@ -505,6 +506,14 @@ h1 svg.icon {
   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;
 }
@@ -631,14 +640,10 @@ h1 svg.icon {
   margin-bottom: 5px;
 }
 
-.view-section {
-  margin-top: 5px;
-}
-
 /* }}} */
 
 
-/* Content (single) formatting {{{ */
+/* Components exclusive to content/single pages {{{ */
 
 .series-box {
   background-color: var(--background-1);
@@ -676,6 +681,7 @@ h1 svg.icon {
   display: flex;
   gap: 8px;
   justify-content: center;
+  font-size: 32px;
 }
 
 .share-buttons a {
@@ -690,8 +696,7 @@ h1 svg.icon {
 }
 
 .share-buttons svg {
-  width: 32px;
+  display: block;
-  height: 32px;
 }
 
 /* https://stackoverflow.com/a/72073682/19003757 */
@@ -702,19 +707,6 @@ h1 svg.icon {
 }
 */
 
-/* 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 {
@@ -765,6 +757,45 @@ h1 svg.icon {
 
 /* }}} */
 
+/* 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;
@@ -781,10 +812,13 @@ h1 svg.icon {
   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 {
@@ -878,44 +912,23 @@ aside.quote {
 
 /* }}} */
 
-/* }}} */
+/* See also formating */
-
+.see-also {
-/* Related posts section {{{ */
+  background-color: var(--background-1);
-
+  color: var(--text-1);
-.full-width-page-list {
+  padding: 8px 12px;
-  /* make left/right 0 margin so it takes up full width */
+  border-radius: 8px;
-  margin: 25px 0;
+  margin: 10px 0;
 }
 
-.related-posts > hr,
+.see-also p {
-.related-posts > h1 {
+  margin: 0;
-  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;
 }
 
 /* }}} */
 
 
+
 /* @media specializations {{{ */
 
 /* Light mode */
@@ -929,8 +942,10 @@ aside.quote {
 /* Print compatibility {{{ */
 @media print {
   .top > .navbar,
-  .section-header-link,
+  .content-heading-link,
   .post-meta-edit-history,
+  .post-meta-view-markdown,
+  .code-copy-button,
   .prevnext,
   .share-buttons,
   .related-posts {

assets/css/comments.css

@@ -0,0 +1,132 @@
+.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);
+    margin-bottom: 8px;
+}
+
+.isso-comment:not(:first-of-type),
+.isso-follow-up .isso-comment {
+    border-color: var(--background-3);
+}
+
+.isso-author,
+.isso-page-author-suffix,
+.isso-comment-footer,
+.isso-comment-footer .isso-votes {
+    color: var(--text-gray-0);
+}
+
+.isso-comment-header .isso-spacer,
+.isso-spacer:hover,
+.isso-permalink,
+.isso-permalink:hover {
+    color: var(--text-gray-1) !important;
+}
+a.isso-author:hover,
+.isso-permalink:hover {
+    text-decoration: underline !important;
+}
+
+.isso-comment.isso-is-page-author > .isso-text-wrapper {
+    background-color: var(--background-accent-1);
+}
+
+.isso-feedlink:hover,
+.isso-reply {
+    color: var(--link-0) !important;
+    text-shadow: unset !important;
+}
+.isso-reply:hover {
+    text-decoration: underline;
+}
+
+.isso-text pre,
+.isso-text :not(pre) > code {
+    background-color: var(--background-2);
+    border: none;
+    padding: 2px 4px;
+    border-radius: 5px;
+    /* thanks isso.css for setting this to 85% for whatever reason */
+    font-size: 0.75em;
+}
+
+.isso-input-wrapper input,
+.isso-post-action > input,
+.isso-textarea,
+.isso-preview {
+    color: var(--text-1);
+    background-color: var(--background-1);
+    border-color: var(--background-2) !important;
+}
+
+.isso-input-wrapper input:focus,
+.isso-textarea:focus {
+    border-color: var(--background-3) !important;
+}
+
+.isso-post-action > input:hover {
+    background-color: var(--background-2);
+}
+.isso-post-action > input:focus,
+.isso-post-action > input:active {
+    background-color: var(--background-3);
+}
+
+.isso-textarea {
+    margin-bottom: 4px;
+}
+.isso-input-wrapper {
+    display: inline-flex;
+    flex-direction: column;
+    margin-right: 4px;
+    max-width: 25%;
+}
+.isso-input-wrapper input {
+    order: 1;
+}
+.isso-input-wrapper label {
+    order: 2;
+    font-size: small;
+}
+.isso-post-action {
+    margin-left: 4px;
+    margin-top: 0;
+}
+@media screen and (max-width: 600px) {
+    .isso-input-wrapper {
+        display: block;
+        max-width: 100%;
+    }
+}
+
+@media print {
+    .comments {
+        break-before: always;
+    }
+    .isso-comment {
+        max-width: unset;
+    }
+    .isso-text-wrapper {
+        break-inside: avoid;
+    }
+
+    .isso-postbox,
+    .isso-feedlink {
+        display: none;
+    }
+}
+
+.isso-target {
+    animation: target-fade 10s ease-out; /* defined in bobatheme */
+}

assets/css/noscript.css

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

assets/css/search.css

@@ -0,0 +1,9 @@
+/* put on body so it overrides the defaults set in :root by pagefind.css */
+body {
+    /* https://pagefind.app/docs/ui-usage/#customising-the-styles */
+    --pagefind-ui-background: var(--background-1);
+    --pagefind-ui-border: var(--background-2);
+    --pagefind-ui-primary: var(--link-0);
+    --pagefind-ui-tag: var(--background-1);
+    --pagefind-ui-text: var(--text-1);
+}

assets/js/share-event.js

@@ -1,3 +1,3 @@
 function share_event(service) {
-    // this function does nothing by default
+    plausible("Share", {props: {Network: service}});
 }

exampleSite/hugo.yaml

@@ -1,60 +0,0 @@
-baseURL: https://example.com
-theme: bobatheme
-defaultContentLanguage: en
-copyright: '&copy; 2021 bbaovanc <a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/">CC BY-SA 4.0</a>'
-sectionPagesMenu: main
-enableRobotsTXT: true
-paginate: 5
-enableGitInfo: true
-
-taxonomies:
-  _merge: deep
-
-markup: # this just keeps the bobatheme markup styling
-  _merge: deep
-
-params:
-  author:
-    name: bbaovanc
-
-  # these are for the OpenGraph/Twitter embeds in Hugo
-  description: Example website for bobatheme
-
-  # these are for favicons in bobatheme (disabled by default)
-  # faviconSVG: favicon.svg
-  # appleTouchPNG: apple-touch-icon.png
-
-  # show reading time (enabled by default)
-  # readingtime: true
-
-  # used for "View source" (unset by default)
-  # gitFileURL: https://github.com/BBaoVanC/bobatheme/blob/master
-  # gitFileIcon: github-circle
-  # gitHistoryURL: https://github.com/BBaoVanC/bobatheme/commits/master
-
-  # social media share icons
-  # shareButtons:
-  #   twitter: true
-  #   facebook: true
-  #   linkedin: true
-  #   reddit: true
-  #   telegram: true
-  #   print: true
-
-  # show "Latest Posts" section at bottom of content pages
-  # latestPostsOnContent: true
-
-  # footer: >-
-  #   Some example text for the footer.
-
-
-# see https://gohugo.io/about/hugo-and-gdpr/#all-privacy-settings
-# you probably want to keep this default
-privacy:
-  _merge: deep
-
-languages:
-  en:
-    languageName: English
-    title: Example Website
-    weight: 1

hugo.yaml

@@ -2,6 +2,12 @@ markup:
   highlight:
     noClasses: false
     lineNos: true
+  goldmark:
+    parser:
+      attribute:
+        block: true
+        # this is enabled by default already
+        #title: true
 
 params:
   readingtime: true
@@ -12,11 +18,20 @@ taxonomies:
   author: authors
   series: series
 
+outputs:
+  page:
+    - html
+    - markdown
+
+outputFormats:
+  markdown:
+    ugly: true
+
 privacy:
   googleAnalytics:
     disable: true
 
-  twitter:
+  x:
     enableDNT: true
 
   vimeo:

i18n/en.yaml

@@ -7,6 +7,8 @@ table_of_contents:
 
 browser_no_video_support:
   other: "Your browser does not support video."
+browser_no_video_support_link:
+  other: "Click here to download it instead."
 
 latest_posts:
   other: "Latest Posts"
@@ -30,6 +32,9 @@ readingtime:
 edit_history:
   other: "Edit history"
 
+view_markdown:
+  other: "View raw"
+
 
 # Post count
 no_posts:
@@ -67,6 +72,9 @@ aria_rss_link:
 aria_post_meta_edit_history:
   other: "link to page edit history"
 
+aria_post_meta_view_markdown:
+  other: "link to view raw markdown code of page"
+
 aria_post_meta_categories:
   other: "categories"
 

layouts/_default/single.html

@@ -1,88 +0,0 @@
-{{ define "main" }}
-    <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" . }}
-
-    {{ 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 }}
-        </div>
-    {{ end }}
-
-    {{ with .Resources.GetMatch "feature" }}
-        <div class="post-media">
-            {{ partial "figure.html" (dict "src" .) }}
-        </div>
-    {{ end }}
-
-    <article class="post-content">
-        {{ .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 }}
-
-
-{{ 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/_markup/render-heading.html

@@ -1,6 +1,6 @@
 <h{{ .Level }} id="{{ .Anchor | safeURL }}" class="section-heading">
     {{ .Text | safeHTML }}
-    <a class="heading-link" href="#{{ .Anchor | safeURL }}">
+    <a class="content-heading-link" href="#{{ .Anchor | safeURL }}">
         <span aria-label="{{ i18n "aria_heading_link" }}">
             {{ partial "icon.html" "link" }}
         </span>

layouts/_partials/comments.html

@@ -0,0 +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>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>
+    <p class="enable-javascript-notice">
+        Enable JavaScript to see the comment section.
+    </p>
+</noscript>
+
+<section id="isso-thread" data-title="{{ .Title }}"></section>

layouts/_partials/embed-resource.html

@@ -0,0 +1,23 @@
+{{ if eq .ResourceType "image" }}
+    {{/* TODO: figure out whether loading="lazy" should be set because MDN
+       *       claims that images won't work with JS disabled since it would
+       *       make tracking possible, but my experience says otherwise
+       */}}
+    <img class="figure-media" src="{{ .Permalink }}" {{ with .Params.alt }}alt="{{ . }}"{{ end }} />
+{{ else if eq .ResourceType "video" }}
+    <video class="figure-media" controls preload="metadata">
+        {{ with .Params.alt }}
+            {{ warnf "video does not support alt text, '%s'" . }}
+        {{ end }}
+        <source src="{{ .Permalink }}" />
+        {{ i18n "browser_no_video_support" }}
+        <a href="{{ .Permalink }}" target="_blank" rel="noopener">
+            {{ i18n "browser_no_video_support_link" }}
+        </a>
+    </video>
+{{ else }}
+    {{/* TODO: could consider implementing more types, listed at:
+       * https://www.iana.org/assignments/media-types/media-types.xhtml
+       */}}
+    {{ errorf "Handling %q resource not supported" .ResourceType }}
+{{ end }}

layouts/_partials/feature-figure.html

@@ -0,0 +1,10 @@
+{{ with .Resources.Get "feature" }}
+    <div class="post-media">
+        <figure>
+            {{ partial "embed-resource.html" . }}
+            {{ with .Title }}
+                <figcaption>{{ . | markdownify }}</figcaption>
+            {{ end }}
+        </figure>
+    </div>
+{{ end }}

layouts/_partials/head.html

@@ -0,0 +1,106 @@
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    {{ hugo.Generator }}
+
+    {{ 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 }}
+    {{ with resources.Get "css/syntax-light.css" | fingerprint "sha512" }}
+        <link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous" media="print" onload="this.media='all'">
+    {{ end }}
+
+    {{ with resources.Get "js/bobatheme.js" | fingerprint "sha512" }}
+        <script defer src="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous"></script>
+    {{ end }}
+    {{ if not hugo.IsServer }}
+        <script defer data-domain="bbaovanc.com" src="https://plausible.bbaovanc.com/js/bobalytics.outbound-links.js"></script>
+        <script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
+        {{ with resources.Get "js/share-event.js" | fingerprint "sha512" }}
+            <script defer src="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous"></script>
+        {{ end }}
+    {{ end }}
+    {{ $isso_url := .Permalink }}
+    {{ if .IsTranslated }}
+        {{ with index .AllTranslations 0 }}
+            {{ $isso_url = .Permalink }}
+        {{ end }}
+    {{ end }}
+    <script defer src="https://isso.bbaovanc.com/js/embed.min.js"
+            data-isso-id="{{ $isso_url }}"
+            data-isso-default-lang="{{ .Language.Lang }}"
+            data-isso-css="true"
+            data-isso-max-comments-top="inf"
+            data-isso-max-comments-nested="inf"
+            data-isso-reveal-on-click="5"
+            {{/*
+            data-isso-avatar-bg="#111"
+            data-isso-avatar-fg="#9abf88 #5698c4 #e279a3 #9163b6 ..."
+            */}}
+            data-isso-vote="true"
+            {{/*
+            data-isso-vote-levels=""
+            */}}
+            data-isso-feed="true"
+            data-isso-require-email="false"
+            data-isso-reply-notifications="true"
+            data-isso-reply-notifications-default-enabled="true"
+
+            {{ with (.GetTerms "authors") }}
+                {{ $authorHashes := slice }}
+                {{ range . }}
+                    {{ with .Params.issoUserID }}
+                        {{ $authorHashes = $authorHashes | append . }}
+                    {{ end }}
+                {{ end }}
+
+                data-isso-page-author-hashes="{{ delimit $authorHashes "," }}"
+            {{ end }}
+            >
+    </script>
+
+    {{ if eq .Layout "search" }}
+        {{ with resources.Get "css/search.css" | fingerprint "sha512" }}
+            <link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous">
+        {{ end }}
+
+        <link rel="stylesheet" type="text/css" href="{{ absURL "pagefind/pagefind-ui.css" }}" crossorigin="anonymous">
+        <script src="{{ absURL "pagefind/pagefind-ui.js" }}" crossorigin="anonymous"></script>
+        <script>
+            window.addEventListener('DOMContentLoaded', (event) => {
+                new PagefindUI({ element: "#search-box", showSubResults: true });
+            });
+        </script>
+    {{ end }}
+
+    {{ with .Site.Params.faviconSVG }}
+        <link rel="icon" href="{{ . | absURL }}" />
+    {{ end }}
+    {{ with .Site.Params.appleTouchPNG }}
+        <link rel="apple-touch-icon" href="{{ . | absURL }}" />
+    {{ end }}
+
+    <title>{{ .Render "head_title" }}</title>
+
+    {{ range .Site.Params.rel_me }}
+        <link rel="me" href="{{ . }}" />
+    {{ end }}
+
+    {{ partial "seo-tags/opengraph.html" . }}
+    {{ partial "seo-tags/twitter-cards.html" . }}
+    {{ partial "seo-tags/schema.html" . }}
+    {{ partial "seo-tags/link.html" . }}
+    {{ partial "seo-tags/author.html" . }}
+
+    <meta name="language" content="{{ .Language.Lang }}">
+    <meta name="description" content="{{ (partial "seo-description.html" .) | plainify }}">
+</head>

layouts/_partials/icon_code.html

@@ -1,6 +1,6 @@
 {{- $icon_resource := resources.Get (printf "jam/icons/%s.svg" .) -}}
 {{- $icon := $icon_resource.Content -}}
-{{- $icon = replaceRE `<svg` `<svg class="icon"` $icon -}}
+{{- $icon = replaceRE `<svg` (printf `<svg class="icon icon-%s"` .) $icon -}}
 {{- $icon = replaceRE `</svg>` (printf `<title>%s icon</title></svg>` .) $icon -}}
 {{- $icon = replaceRE `(width|height)="[0-9]*"` "" $icon -}}
 {{- $icon | safeHTML -}}

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

@@ -0,0 +1,9 @@
+{{ with .GetTerms "authors" }}
+    <span class="page-metadata-item authors" aria-label="{{ i18n "aria_post_meta_authors" }}">
+        {{ partial "icon.html" "user-circle" }}
+
+        {{ range . }}
+            <a href="{{ .Permalink }}" data-pagefind-filter="author">{{ .LinkTitle }}</a>
+        {{ end }}
+    </span>
+{{ end }}

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

@@ -6,6 +6,8 @@
 
     <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

@@ -0,0 +1,8 @@
+<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
+       * have access to the original page context
+       */}}
+    <a href="{{ .RelPermalink }}#isso-thread">comments</a>
+</span>

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

@@ -0,0 +1,8 @@
+{{ with (.GetTerms "series") }}
+    <div class="page-metadata-section series" aria-label="{{ i18n "aria_post_meta_series" }}">
+        {{ partial "icon.html" "files" }}
+        {{ 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" 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/item/viewraw.html

@@ -0,0 +1,8 @@
+{{ with .OutputFormats.Get "markdown" }}
+    <span class="page-metadata-item post-meta-view-markdown" aria-label="{{ i18n "aria_post_meta_view_markdown" }}">
+        {{ partial "icon.html" "code" }}
+        <a href="{{ .Permalink }}" target="_blank">
+            {{- i18n "view_markdown" -}}
+        </a>
+    </span>
+{{ 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" }}
@@ -20,7 +20,11 @@
         {{ partial "page-metadata/item/authors.html" . }}
         {{ partial "page-metadata/item/readingtime.html" . }}
         {{ partial "page-metadata/item/edithistory.html" . }}
+        {{ partial "page-metadata/item/viewraw.html" . }}
+        {{ partial "page-metadata/item/comments-counter.html" . }}
+
         {{ 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" }}
@@ -9,8 +9,10 @@
 
         {{ partial "page-metadata/item/authors.html" . }}
         {{ partial "page-metadata/item/readingtime.html" . }}
+        {{ partial "page-metadata/item/comments-counter.html" . }}
+
         {{ partial "page-metadata/item/series.html" . }}
         {{ partial "page-metadata/item/categories.html" . }}
         {{ partial "page-metadata/item/tags.html" . }}
-    </div>
+    </section>
 {{ end }}

layouts/_partials/pagination-hugo.html

@@ -0,0 +1,154 @@
+{{- $validFormats := slice "default" "terse" }}
+
+{{- $msg1 := "When passing a map to the internal pagination template, one of the elements must be named 'page', and it must be set to the context of the current page." }}
+{{- $msg2 := "The 'format' specified in the map passed to the internal pagination template is invalid. Valid choices are: %s." }}
+
+{{- $page := . }}
+{{- $format := "default" }}
+
+{{- if reflect.IsMap . }}
+  {{- with .page }}
+    {{- $page = . }}
+  {{- else }}
+    {{- errorf $msg1 }}
+  {{- end }}
+  {{- with .format }}
+    {{- $format = lower . }}
+  {{- end }}
+{{- end }}
+
+{{- if in $validFormats $format }}
+  {{- if gt $page.Paginator.TotalPages 1 }}
+    <ul class="pagination pagination-{{ $format }}">
+      {{- partial (printf "inline/pagination/%s.html" $format) $page }}
+    </ul>
+  {{- end }}
+{{- else }}
+  {{- errorf $msg2 (delimit $validFormats ", ") }}
+{{- end -}}
+
+{{/* Format: default
+{{/* --------------------------------------------------------------------- */}}
+{{- define "_partials/inline/pagination/default.html" }}
+  {{- with .Paginator }}
+    {{- $currentPageNumber := .PageNumber }}
+
+    {{- with .First }}
+      {{- if ne $currentPageNumber .PageNumber }}
+      <li class="page-item">
+        <a href="{{ .URL }}" aria-label="First" class="page-link" role="button"><span aria-hidden="true">&laquo;&laquo;</span></a>
+      </li>
+      {{- else }}
+      <li class="page-item disabled">
+        <a aria-disabled="true" aria-label="First" class="page-link" role="button" tabindex="-1"><span aria-hidden="true">&laquo;&laquo;</span></a>
+      </li>
+      {{- end }}
+    {{- end }}
+
+    {{- with .Prev }}
+      <li class="page-item">
+        <a href="{{ .URL }}" aria-label="Previous" class="page-link" role="button"><span aria-hidden="true">&laquo;</span></a>
+      </li>
+    {{- else }}
+      <li class="page-item disabled">
+        <a aria-disabled="true" aria-label="Previous" class="page-link" role="button" tabindex="-1"><span aria-hidden="true">&laquo;</span></a>
+      </li>
+    {{- end }}
+
+    {{- $slots := 5 }}
+    {{- $start := math.Max 1 (sub .PageNumber (math.Floor (div $slots 2))) }}
+    {{- $end := math.Min .TotalPages (sub (add $start $slots) 1) }}
+    {{- if lt (add (sub $end $start) 1) $slots }}
+      {{- $start = math.Max 1 (add (sub $end $slots) 1) }}
+    {{- end }}
+
+    {{- range $k := seq $start $end }}
+      {{- if eq $.Paginator.PageNumber $k }}
+      <li class="page-item active">
+        <a aria-current="page" aria-label="Page {{ $k }}" class="page-link" role="button">{{ $k }}</a>
+      </li>
+      {{- else }}
+      <li class="page-item">
+        <a href="{{ (index $.Paginator.Pagers (sub $k 1)).URL }}" aria-label="Page {{ $k }}" class="page-link" role="button">{{ $k }}</a>
+      </li>
+      {{- end }}
+    {{- end }}
+
+    {{- with .Next }}
+      <li class="page-item">
+        <a href="{{ .URL }}" aria-label="Next" class="page-link" role="button"><span aria-hidden="true">&raquo;</span></a>
+      </li>
+    {{- else }}
+      <li class="page-item disabled">
+        <a aria-disabled="true" aria-label="Next" class="page-link" role="button" tabindex="-1"><span aria-hidden="true">&raquo;</span></a>
+      </li>
+    {{- end }}
+
+    {{- with .Last }}
+      {{- if ne $currentPageNumber .PageNumber }}
+      <li class="page-item">
+        <a href="{{ .URL }}" aria-label="Last" class="page-link" role="button"><span aria-hidden="true">&raquo;&raquo;</span></a>
+      </li>
+      {{- else }}
+      <li class="page-item disabled">
+        <a aria-disabled="true" aria-label="Last" class="page-link" role="button" tabindex="-1"><span aria-hidden="true">&raquo;&raquo;</span></a>
+      </li>
+      {{- end }}
+    {{- end }}
+  {{- end }}
+{{- end -}}
+
+{{/* Format: terse
+{{/* --------------------------------------------------------------------- */}}
+{{- define "_partials/inline/pagination/terse.html" }}
+  {{- with .Paginator }}
+    {{- $currentPageNumber := .PageNumber }}
+
+    {{- with .First }}
+      {{- if ne $currentPageNumber .PageNumber }}
+      <li class="page-item">
+        <a href="{{ .URL }}" aria-label="First" class="page-link" role="button"><span aria-hidden="true">&laquo;&laquo;</span></a>
+      </li>
+      {{- end }}
+    {{- end }}
+
+    {{- with .Prev }}
+      <li class="page-item">
+        <a href="{{ .URL }}" aria-label="Previous" class="page-link" role="button"><span aria-hidden="true">&laquo;</span></a>
+      </li>
+    {{- end }}
+
+    {{- $slots := 3 }}
+    {{- $start := math.Max 1 (sub .PageNumber (math.Floor (div $slots 2))) }}
+    {{- $end := math.Min .TotalPages (sub (add $start $slots) 1) }}
+    {{- if lt (add (sub $end $start) 1) $slots }}
+      {{- $start = math.Max 1 (add (sub $end $slots) 1) }}
+    {{- end }}
+
+    {{- range $k := seq $start $end }}
+      {{- if eq $.Paginator.PageNumber $k }}
+      <li class="page-item active">
+        <a aria-current="page" aria-label="Page {{ $k }}" class="page-link" role="button">{{ $k }}</a>
+      </li>
+      {{- else }}
+      <li class="page-item">
+        <a href="{{ (index $.Paginator.Pagers (sub $k 1)).URL }}" aria-label="Page {{ $k }}" class="page-link" role="button">{{ $k }}</a>
+      </li>
+      {{- end }}
+    {{- end }}
+
+    {{- with .Next }}
+      <li class="page-item">
+        <a href="{{ .URL }}" aria-label="Next" class="page-link" role="button"><span aria-hidden="true">&raquo;</span></a>
+      </li>
+    {{- end }}
+
+    {{- with .Last }}
+      {{- if ne $currentPageNumber .PageNumber }}
+      <li class="page-item">
+        <a href="{{ .URL }}" aria-label="Last" class="page-link" role="button"><span aria-hidden="true">&raquo;&raquo;</span></a>
+      </li>
+      {{- end }}
+    {{- end }}
+  {{- end }}
+{{- end -}}

layouts/_partials/pagination.html

@@ -0,0 +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 "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 }}
@@ -33,16 +23,42 @@
     <meta property="og:locale" content="{{ . }}">
 {{ end }}
 
-{{ with .Site.Params.title }}
+{{ with .Site.Title }}
     <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

@@ -0,0 +1,43 @@
+{{/* we do not need to duplicate what's already covered by OpenGraph tags
+   * see: https://demo.bbaovanc.com/test/remove-twitter-tags/blog/swapfile-guide/
+   * so, no twitter:image/title/description
+   */}}
+{{ $images := $.Resources.ByType "image" }}
+{{ $featured := $images.GetMatch "*feature*" }}
+{{ if not $featured }}
+    {{ $featured = $images.GetMatch "{*cover*,*thumbnail*}" }}
+{{ end }}
+
+{{ with $featured }}
+    {{ $ratio := 0 }}
+    {{ if gt .Width .Height }}
+        {{ $ratio = div (float .Width) .Height }}
+    {{ else }}
+        {{ $ratio = div (float .Height) .Width }}
+    {{ end }}
+
+    {{ if lt $ratio 1.75 }}
+        <meta name="twitter:card" content="summary_large_image">
+    {{ else }}
+        <meta name="twitter:card" content="summary">
+    {{ end }}
+{{ else }}
+    <meta name="twitter:card" content="summary">
+{{ end }}
+
+{{/* twitter:site is the site author; twitter:creator is page author
+   * https://developer.x.com/en/docs/x-for-websites/cards/guides/getting-started
+   * "Card and Content Attribution"
+   */}}
+{{ 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 . }}
+        {{ with .Params.twitter }}
+            <meta name="twitter:creator" content="@{{ . }}">
+        {{ end }}
+    {{ end }}
+{{ 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,9 +1,9 @@
-<div class="top">
+<header class="top">
-    <header class="header">
+    <div class="brand">
-        <a class="heading-link" href="{{ .Site.Home.Permalink | absLangURL }}">
+        <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/figure.html

@@ -0,0 +1,17 @@
+<figure>
+    {{ $resource_title := "" }}
+    {{ with .Get "src" }}
+        {{ with $.Page.Resources.Get . }}
+            {{ $resource_title = .Title }}
+            {{ partial "embed-resource.html" . }}
+        {{ else }}
+            {{ errorf "resource %q not found" . }}
+        {{ end }}
+    {{ else }}
+        {{ .Inner }}
+    {{ end }}
+
+    {{ with or (.Get "caption") (.Get 0) $resource_title }}
+        <figcaption>{{ (replace . "\\bt" "`") | markdownify }}</figcaption>
+    {{ end }}
+</figure>

layouts/_shortcodes/include.html

@@ -0,0 +1,14 @@
+{{/* https://github.com/gohugoio/hugo/issues/13823#issuecomment-3015270202 */}}
+{{ with .Get 0 -}}
+    {{ with $.Page.GetPage . -}}
+        {{ .RenderShortcodes -}}
+    {{ else with $.Page.Resources.Get . -}}
+        {{ .RenderShortcodes -}}
+    {{ else with resources.Get . -}}
+        {{ .Content -}}
+    {{ else -}}
+        {{ errorf "The %q shortcode was unable to find %q. See %s" $.Name . $.Position -}}
+    {{ end -}}
+{{ else -}}
+    {{ errorf "The %q shortcode requires a positional parameter indicating the logical path of the file to include. See %s" .Name .Position -}}
+{{ end -}}

layouts/_shortcodes/resource.html

@@ -0,0 +1,9 @@
+{{ with .Get 0 }}
+    {{ with $.Page.Resources.Get . }}
+        {{ partial "embed-resource.html" . }}
+    {{ else }}
+        {{ errorf "resource %q not found" . }}
+    {{ end }}
+{{ else }}
+    {{ errorf "resource name not provided as first parameter" }}
+{{ end }}

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">
+{{ with .Summary }}
-    {{ partial "description-or-summary.html" . }}
+    <div class="page-description">
-</div>
+        {{ . }}
+    </div>
+{{ end }}
 
 <div class="readmore">
     <a href="{{ .Permalink }}">{{ i18n "read_more" }} &rarr;</a>

layouts/authors/term.head_title.html

@@ -0,0 +1 @@
+{{ (print .Title "'s Posts | " .Site.Title) | plainify }}

layouts/baseof.html

@@ -18,23 +18,23 @@
                     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 class="site-footer">
+                    {{ with .Site.Copyright }}
+                        {{ . | safeHTML }}
+                    {{ end }}
+
+                    {{ with .Site.Params.footer }}
+                        {{ . | $.RenderString (dict "display" "block") }}
+                    {{ end }}
+                </footer>
+            {{ end }}
         </div>
 
         {{ block "post-body" . }}
             {{/* currently this is only used for related posts */}}
         {{ end }}
-
-        {{ if or .Site.Copyright .Site.Params.footer }}
-            <footer>
-                {{ with .Site.Copyright }}
-                    {{ . | safeHTML }}
-                {{ end }}
-
-                {{ with .Site.Params.footer }}
-                    {{ . | $.RenderString (dict "display" "block") }}
-                {{ end }}
-            </footer>
-        {{ end }}
     </body>
 
 </html>

layouts/head_title.html

@@ -0,0 +1 @@
+{{ (print .Title " | " .Site.Title) | plainify }}

layouts/home.head_title.html

@@ -0,0 +1 @@
+{{ .Site.Title | plainify }}

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

@@ -0,0 +1,86 @@
+{{ define "main" }}
+    <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" . }}
+
+        {{ 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 }}
+            </div>
+        {{ end }}
+
+        {{ partial "feature-figure.html" . }}
+
+        <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>
+{{ 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/page.markdown.md

@@ -0,0 +1,9 @@
+{{ with .File -}}
+  {{ with (.Path | readFile) -}}
+    {{ . -}}
+  {{ else -}}
+    {{ errorf "file not found: %s" .Path -}}
+  {{ end -}}
+{{ else -}}
+  {{ errorf "no file available for markdown template?" -}}
+{{ end -}}

layouts/partials/comments.html

@@ -1,4 +0,0 @@
-{{/*
-    Create a file named `layouts/partials/comments.html` at your site root to
-    add a comment system. Page variables are passed.
-*/}}

layouts/partials/description-or-summary.html

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

layouts/partials/figure.html

@@ -1,28 +0,0 @@
-{{ $hidecaption := index . "hidecaption" }}
-
-{{ if index . "noborder" }}
-    <figure>
-{{ else }}
-    <figure class="border">
-{{ end }}
-
-    {{ with index . "src" }}
-        {{ $media := . }}
-        {{ if eq .MediaType.MainType "image" }}
-            <img src="{{ $media.Permalink }}" alt="{{ $media.Title }}" loading="lazy" />
-        {{ else if eq .MediaType.MainType "video" }}
-            <video controls preload="metadata">
-                <source src="{{ $media.Permalink }}" alt="{{ $media.Title }}">
-                {{ i18n "browser_no_video_support" }}
-            </video>
-        {{ end }}
-
-        {{ if not $hidecaption }}
-            {{ with $media.Title }}
-                <figcaption>
-                    {{ . | markdownify }}
-                </figcaption>
-            {{ end }}
-        {{ end }}
-    {{ end }}
-</figure>

layouts/partials/head.html

@@ -1,46 +0,0 @@
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    {{ hugo.Generator }}
-
-    {{ 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/syntax.css" | fingerprint "sha512" }}
-        <link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous" media="print" onload="this.media='all'">
-    {{ end }}
-    {{ with resources.Get "css/syntax-light.css" | fingerprint "sha512" }}
-        <link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous" media="print" onload="this.media='all'">
-    {{ end }}
-
-    {{ with resources.Get "js/bobatheme.js" | fingerprint "sha512" }}
-        <script defer src="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous"></script>
-    {{ end }}
-    {{ with resources.Get "js/share-event.js" | fingerprint "sha512" }}
-        <script defer src="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous"></script>
-    {{ end }}
-
-    {{ with .Site.Params.faviconSVG }}
-        <link rel="icon" href="{{ . | absURL }}" />
-    {{ end }}
-    {{ with .Site.Params.appleTouchPNG }}
-        <link rel="apple-touch-icon" href="{{ . | absURL }}" />
-    {{ end }}
-
-    {{ if .IsHome }}
-        <title>{{ .Site.Title | plainify }}</title>
-    {{ else }}
-        <title>{{ (print .Title " | " .Site.Title) | plainify }}</title>
-    {{ end }}
-
-    {{ partial "seo-tags/opengraph.html" . }}
-    {{ partial "seo-tags/twitter-cards.html" . }}
-    {{ partial "seo-tags/schema.html" . }}
-    {{ partial "seo-tags/link.html" . }}
-    {{ partial "seo-tags/author.html" . }}
-
-    <meta name="language" content="{{ .Language.Lang }}">
-    <meta name="description" content="{{ (partial "seo-description.html" .) | plainify }}">
-
-    {{ partial "additional-head.html" . }}
-</head>

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

@@ -1,16 +0,0 @@
-{{ with .Params.authors }}
-    <span class="page-metadata-item" 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 . ", " }}
-        {{ end }}
-    </span>
-{{ end }}

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

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

layouts/partials/pagination.html

@@ -1,5 +0,0 @@
-{{ if gt .Paginator.TotalPages 1 }}
-    <nav class="pagination">
-        {{ template "_internal/pagination.html" . }}
-    </nav>
-{{ end }}

layouts/partials/remote_figure.html

@@ -1,28 +0,0 @@
-{{ $hidecaption := index . "hidecaption" }}
-{{ $type := index . "type" }}
-{{ $src := index . "src" }}
-{{ $alt := index . "alt" }}
-
-{{ if index . "border" }}
-    <figure class="border">
-{{ else }}
-    <figure>
-{{ end }}
-
-    {{ if eq $type "image" }}
-        <img src="{{ $src }}" alt="{{ $alt }}" loading="lazy" />
-    {{ else if eq $type "video" }}
-        <video controls preload="metadata">
-            <source src="{{ $src }}" alt="{{ $alt }}">
-            {{ i18n "browser_no_video_support" }}
-        </video>
-    {{ end }}
-
-    {{ if not $hidecaption }}
-        {{ with $alt }}
-            <figcaption>
-                {{ . | markdownify }}
-            </figcaption>
-        {{ end }}
-    {{ end }}
-</figure>

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

@@ -1,29 +0,0 @@
-{{ $images := $.Resources.ByType "image" }}
-{{ $featured := $images.GetMatch "*feature*" }}
-{{ if not $featured }}
-    {{ $featured = $images.GetMatch "{*cover*,*thumbnail*}" }}
-{{ end }}
-
-{{ with $featured }}
-    {{ $ratio := 0 }}
-    {{ if gt .Width .Height }}
-        {{ $ratio = div (float .Width) .Height }}
-    {{ else }}
-        {{ $ratio = div (float .Height) .Width }}
-    {{ end }}
-
-    {{ if lt $ratio 1.75 }}
-        <meta name="twitter:card" content="summary_large_image">
-    {{ else }}
-        <meta name="twitter:card" content="summary">
-    {{ end }}
-
-    <meta name="twitter:image" content="{{ $featured.Permalink }}">
-{{ end }}
-
-<meta name="twitter:title" content="{{ .Title | plainify }}">
-<meta name="twitter:description" content="{{ (partial "seo-description.html" .) | plainify }}">
-
-{{ with .Site.Social.twitter }}
-    <meta name="twitter:site" content="@{{ . }}">
-{{ 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/search.html

@@ -0,0 +1,3 @@
+{{ define "main" }}
+    <div id="search-box"></div>
+{{ end }}

layouts/section.summary.html

@@ -5,8 +5,10 @@
             {{ .Title | markdownify }}
         </h2>
 
-        <div class="section-description">
+        {{ with .Summary }}
-            {{ partial "description-or-summary.html" . }}
+            <div class="section-description">
-        </div>
+                {{ . }}
+            </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">
+{{ with .Summary }}
-    {{ partial "description-or-summary.html" . }}
+    <div class="page-description">
-</div>
+        {{ . }}
+    </div>
+{{ end }}
 
 <div class="page-list series-inner">
     {{ range .Data.Pages.Reverse }}

layouts/shortcodes/figure.html

@@ -1,15 +0,0 @@
-{{ $resource := .Page.Resources.GetMatch (.Get "src") }}
-
-{{ $noborder := false }}
-{{ if .Get "noborder" }}
-    {{ $noborder = true }}
-{{ end }}
-
-{{ $hidecaption := false }}
-{{ if .Get "hidecaption" }}
-    {{ $hidecaption = true }}
-{{ end }}
-
-<p>
-    {{ partial "figure.html" (dict "src" $resource "noborder" $noborder "hidecaption" $hidecaption) }}
-</p>

layouts/shortcodes/full-width-hr.html

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

layouts/shortcodes/include.html

@@ -1,20 +0,0 @@
-{{ $path := "" }}
-{{ $markdown := false }}
-{{ if .IsNamedParams }}
-    {{ $path = .Get "path" }}
-    {{ with .Get "markdown" }}
-        {{ $markdown = . }}
-    {{ end }}
-{{ else }}
-    {{ $path = .Get 0 }}
-{{ end }}
-
-{{ with ($path | readFile) }}
-    {{ if $markdown }}
-        {{ $path | readFile | $.Page.RenderString (dict "display" "block") }}
-    {{ else }}
-        {{ $path | readFile }}
-    {{ end }}
-{{ else }}
-    {{ errorf "file not found: %s" $path }}
-{{ end }}

layouts/shortcodes/remote-figure.html

@@ -1,13 +0,0 @@
-{{ $border := false }}
-{{ if .Get "border" }}
-    {{ $border = true }}
-{{ end }}
-
-{{ $hidecaption := false }}
-{{ if .Get "hidecaption" }}
-    {{ $hidecaption = true }}
-{{ end }}
-
-<p>
-    {{ partial "remote_figure.html" (dict "src" (.Get "src") "border" $border "hidecaption" $hidecaption "type" (.Get "type") "alt" (.Get "alt")) }}
-</p>

layouts/shortcodes/table.html

@@ -1,10 +0,0 @@
-{{/* See https://willschenk.com/articles/2020/styling_tables_with_hugo/ */}}
-
-{{ $class := "markdown" }}
-{{ with .Get "class" }}
-    {{ $class = delimit (slice $class .) " " }}
-{{ end }}
-
-{{ $htmlTable := .Inner | .Page.RenderString (dict "display" "block") }}
-{{ $new := printf `<table class="%s">` $class }}
-{{ (replace $htmlTable "<table>" $new) | safeHTML }}

layouts/summary.html

@@ -1,21 +1,19 @@
 <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/post-short.html" . }}
 
-{{ with .Resources.GetMatch "feature" }}
+{{ partial "feature-figure.html" . }}
-    <div class="post-media">
+
-        {{ partial "figure.html" (dict "src" .) }}
+{{ with .Summary }}
+    <div class="page-description">
+        {{ . }}
     </div>
 {{ end }}
 
-<div class="page-description">
-    {{ partial "description-or-summary.html" . }}
-</div>
-
 <div class="readmore">
     <a href="{{ .Permalink }}">{{ i18n "read_more" }} &rarr;</a>
 </div>

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"