WIP: use template to generate the individual share buttons

- Hide clickable link icon on headings in articles
- Hide "Copy" button on code blocks
- Hide "View raw" button in page metadata

assets/css/bobastyle.css

@@ -198,14 +198,14 @@ video {
   max-width: 100%;
 }
 
-.post-media > figure.border img,
-.post-media > figure.border video {
+.post-media > figure img,
+.post-media > figure video {
   padding: 5px;
   border: 7px solid var(--figure-border);
 }
 
-figure.border img,
-figure.border video {
+figure img,
+figure video {
   padding: 5px;
   border: 2px solid var(--figure-border);
 }
@@ -924,8 +924,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,121 @@
+/* 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/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

@@ -0,0 +1,3 @@
+function share_event(service) {
+    plausible("Share", {props: {Network: service}});
+}

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"

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

@@ -1,4 +1,15 @@
-{{/*
-    Create a file named `layouts/partials/comments.html` at your site root to
-    add a comment system. Page variables are passed.
-*/}}
+{{ 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;">
+    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>
+</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 src="{{ .Permalink }}" {{ with .Params.alt }}alt="{{ . }}"{{ end }} />
+{{ else if eq .ResourceType "video" }}
+    <video 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/figure.html

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

layouts/_partials/head.html

@@ -16,6 +16,65 @@
     {{ 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 }}" />
@@ -26,6 +85,10 @@
 
     <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" . }}
@@ -34,6 +97,4 @@
 
     <meta name="language" content="{{ .Language.Lang }}">
     <meta name="description" content="{{ (partial "seo-description.html" .) | plainify }}">
-
-    {{ partial "additional-head.html" . }}
 </head>

layouts/_partials/page-metadata/custom-full.html

@@ -1 +0,0 @@
-<!-- Placeholder for website to add custom post metadata to summaries -->

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

@@ -0,0 +1,8 @@
+<span class="page-metadata-item" 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/post-full.html

@@ -21,8 +21,7 @@
         {{ partial "page-metadata/item/readingtime.html" . }}
         {{ partial "page-metadata/item/edithistory.html" . }}
         {{ partial "page-metadata/item/viewraw.html" . }}
-
-        {{ partial "page-metadata/custom-full.html" . }}
+        {{ partial "page-metadata/item/comments-counter.html" . }}
 
         {{ partial "page-metadata/item/categories.html" . }}
 

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

@@ -9,6 +9,7 @@
 
         {{ 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" . }}

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,3 +1,7 @@
+{{/* 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 }}
@@ -17,13 +21,21 @@
     {{ else }}
         <meta name="twitter:card" content="summary">
     {{ end }}
-
-    <meta name="twitter:image" content="{{ $featured.Permalink }}">
+{{ else }}
+    <meta name="twitter:card" content="summary">
 {{ end }}
 
-<meta name="twitter:title" content="{{ .Title | plainify }}">
-<meta name="twitter:description" content="{{ (partial "seo-description.html" .) | plainify }}">
-
+{{/* 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="@{{ . }}">
 {{ end }}
+{{ with .GetTerms "authors" }}
+    {{ range . }}
+        {{ with .Params.twitter }}
+            <meta name="twitter:creator" content="@{{ . }}">
+        {{ end }}
+    {{ end }}
+{{ end }}

layouts/_partials/share.html

@@ -1,4 +1,22 @@
+{{ define "_partials/share-button.html" }}
+    <a class="{{ .ShortName }}-share"
+       target="_blank"
+       rel="noopener"
+       aria-label="{{ i18n (printf "aria_share_%s" .ShortName) }}"
+       onclick="share_event('{{ .ProperName }}');"
+       href="{{ .URL }}">
+        {{- partial "icon.html" (or .IconName .ShortName) -}}
+    </a>
+{{ end }}
+
 <div class="share-buttons">
+    {{ $services := dict
+        "twitter" (dict "ProperName" "Twitter" "URL" (printf "https://twitter.com/intent/tweet?url=%s&text=%s&via=bbaovanc" .Permalink .Title))
+    }}
+    {{ range $name, $info := $services }}
+        {{ $data := merge $info (dict "ShortName" $name) }}
+        {{ partial "share-button.html" $data }}
+    {{ end }}
     {{ if .Site.Params.shareButtons.twitter }}
         <a class="twitter-share"
            target="_blank"

layouts/_shortcodes/figure.html

@@ -1,15 +1,17 @@
-{{ $resource := .Page.Resources.GetMatch (.Get "src") }}
+<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 }}
 
-{{ $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>
+    {{ with or (.Get "caption") (.Get 0) $resource_title }}
+        <figcaption>{{ (replace . "\\bt" "`") | markdownify }}</figcaption>
+    {{ end }}
+</figure>

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

@@ -22,11 +22,7 @@
         </div>
     {{ end }}
 
-    {{ with .Resources.GetMatch "feature" }}
-        <div class="post-media">
-            {{ partial "figure.html" (dict "src" .) }}
-        </div>
-    {{ end }}
+    {{ partial "feature-figure.html" . }}
 
     <article class="post-content">
         {{ .Content }}

layouts/search.html

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

layouts/summary.html

@@ -6,11 +6,7 @@
 
 {{ partial "page-metadata/post-short.html" . }}
 
-{{ with .Resources.GetMatch "feature" }}
-    <div class="post-media">
-        {{ partial "figure.html" (dict "src" .) }}
-    </div>
-{{ end }}
+{{ partial "feature-figure.html" . }}
 
 <div class="page-description">
     {{ partial "description-or-summary.html" . }}