WIP: use template to generate the individual share buttons

assets/css/bobastyle.css

@@ -158,38 +158,61 @@ pre > code {
 
 /* }}} */
 
-/* Common distances/sizes {{{ */
+/* Basic elements {{{ */
 
-:root {
-  --page-margin: 16px;
+html {
+  scroll-behavior: smooth;
 }
 
-/* }}} */
+@media screen and (prefers-reduced-motion: reduce) {
+    html {
+        scroll-behavior: auto;
+    }
+}
 
+body {
+  background-color: var(--background-0);
+  color: var(--text-0);
+  overflow-wrap: break-word;
+  margin: 0;
+}
 
-/* Common elements {{{ */
+.main-container {
+  margin: 20px auto;
+  padding: 0 20px;
+  max-width: 760px; /* 720px + 20px for left & right padding */
+}
+
+footer {
+  margin: 20px 0;
+  text-align: center;
+  font-size: smaller;
+}
+
+footer p {
+  margin: 0;
+}
 
 img,
 video {
   max-width: 100%;
 }
 
-figure > .figure-media {
+.post-media > figure img,
+.post-media > figure video {
   padding: 5px;
-}
-
-figure > .figure-media.border {
-  border: 2px solid var(--figure-border);
-}
-
-.post-media > figure > .figure-media {
   border: 7px solid var(--figure-border);
 }
 
+figure img,
+figure video {
+  padding: 5px;
+  border: 2px solid var(--figure-border);
+}
+
 figure {
-  display: block;
-  text-align: center;
-  margin: 0;
+  margin: auto;
+  display: inline-block;
 }
 
 figcaption {
@@ -217,6 +240,14 @@ hr {
   border: 1px solid var(--background-3);
 }
 
+@media (min-width: 720px) {
+  .full-width-hr {
+    /* see also: the related-posts section too */
+    margin-left: calc(-100vw / 2 + 760px / 2);
+    margin-right: calc(-100vw / 2 + 760px / 2);
+  }
+}
+
 table.simple {
   border-collapse: collapse;
   border: 2px solid var(--text-1);
@@ -276,40 +307,12 @@ table.simple tbody tr:nth-child(even) {
 /* }}} */
 
 
-/* Baseof formatting {{{ */
+/* Heading formatting (article section titles) {{{ */
 
-html {
-  scroll-behavior: smooth;
-}
-
-@media screen and (prefers-reduced-motion: reduce) {
-    html {
-        scroll-behavior: auto;
-    }
-}
-
-body {
-  background-color: var(--background-0);
-  color: var(--text-0);
-  overflow-wrap: break-word;
-  margin: 0;
-}
-
-.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 */
-}
-
-footer {
-  margin: var(--page-margin) 0;
-  text-align: center;
-  font-size: smaller;
-}
-
-footer p {
-  margin: 0;
+/* this is also used i.e. in page-title */
+.heading-link {
+  color: inherit;
+  font-weight: bold;
 }
 
 /* }}} */
@@ -322,30 +325,23 @@ footer p {
   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 {
   flex-grow: 1;
-  margin: 8px var(--page-margin);
+  margin: 8px 16px;
   font-size: 1.25em;
   display: flex;
   align-items: center;
 }
 
-.header a {
-  color: inherit;
-  font-weight: bold;
-}
-
 .navbar {
   display: flex;
   flex-wrap: wrap;
 }
 
 .navbar-item {
-  padding: 12px var(--page-margin);
+  padding: 12px 16px;
   white-space: nowrap;
 }
 
@@ -379,7 +375,7 @@ footer p {
 /* Breadcrumb navigation {{{ */
 
 .breadcrumb {
-  margin: var(--page-margin) 0;
+  margin: 20px 0;
 }
 
 .breadcrumb ul {
@@ -487,10 +483,6 @@ footer p {
   margin-bottom: 10px;
 }
 
-.page-title a {
-  color: inherit;
-}
-
 .page-title h1 {
   margin: 0;
 }
@@ -641,7 +633,7 @@ footer p {
 /* }}} */
 
 
-/* Components exclusive to content/single pages {{{ */
+/* Content (single) formatting {{{ */
 
 .series-box {
   background-color: var(--background-1);
@@ -668,6 +660,43 @@ footer p {
   padding: 8px 15px;
 }
 
+/* Social media share buttons */
+
+.share-buttons {
+  background: var(--background-1);
+  color: var(--text-1);
+  margin: 25px 0;
+  padding: 8px 0;
+  border-radius: 8px;
+  display: flex;
+  gap: 8px;
+  justify-content: center;
+  font-size: 32px;
+}
+
+.share-buttons a {
+  background-color: var(--background-2);
+  color: var(--text-2);
+  padding: 4px;
+  border-radius: 8px;
+}
+.share-buttons a:hover {
+  background-color: var(--background-3);
+  color: var(--text-3);
+}
+
+.share-buttons svg {
+  display: block;
+}
+
+/* https://stackoverflow.com/a/72073682/19003757 */
+/*
+.telegram-share > svg {
+  transform: scale(1.5);
+  margin: 9px -9px -9px 9px;
+}
+*/
+
 /* See also formating */
 .see-also {
   background-color: var(--background-1);
@@ -844,16 +873,19 @@ 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
- */
+.full-width-page-list {
+  /* make left/right 0 margin so it takes up full width */
+  margin: 25px 0;
+}
 
 .related-posts > hr,
 .related-posts > h1 {
-  margin: var(--page-margin);
+  margin-left: 20px;
+  margin-right: 20px;
 }
 
 .related-posts .page {
@@ -863,24 +895,21 @@ aside.quote {
 }
 
 .related-posts .page:first-child {
-  margin-left: var(--page-margin);
+  margin-left: 20px;
 }
 .related-posts .page:last-child {
-  margin-right: var(--page-margin);
+  margin-right: 20px;
 }
 
 .related-posts .page-list {
   display: flex;
   flex-direction: row;
   gap: 20px;
-  overflow-x: auto;
-  margin-bottom: var(--page-margin);
+  overflow-x: scroll;
 }
 
 /* }}} */
 
-/* }}} */
-
 
 /* @media specializations {{{ */
 
@@ -900,6 +929,7 @@ aside.quote {
   .post-meta-view-markdown,
   .code-copy-button,
   .prevnext,
+  .share-buttons,
   .related-posts {
     display: none;
   }

assets/js/share-event.js

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

i18n/en.yaml

@@ -125,3 +125,21 @@ aria_navbar:
 
 aria_table_of_contents:
   other: "table of contents"
+
+aria_share_twitter:
+  other: "share to twitter button"
+
+aria_share_facebook:
+  other: "share to facebook button"
+
+aria_share_linkedin:
+  other: "share to linkedin button"
+
+aria_share_reddit:
+  other: "share to reddit button"
+
+aria_share_telegram:
+  other: "share to telegram button"
+
+aria_share_print:
+  other: "print article button"

layouts/_partials/description-or-summary.html

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

layouts/_partials/embed-resource.html

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

layouts/_partials/head.html

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

layouts/_partials/pagination.html

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

layouts/_partials/share.html

@@ -0,0 +1,87 @@
+{{ 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"
+           rel="noopener"
+           aria-label="{{ i18n "aria_share_twitter" }}"
+           onclick="share_event('Twitter');"
+           href="https://twitter.com/intent/tweet?url={{ .Permalink }}&text={{ .Title }}&via=bbaovanc">
+            {{- partial "icon.html" "twitter" -}}
+        </a>
+    {{ end }}
+
+    {{ if .Site.Params.shareButtons.facebook }}
+        <a class="facebook-share"
+           target="_blank"
+           rel="noopener"
+           aria-label="{{ i18n "aria_share_facebook" }}"
+           onclick="share_event('Facebook');"
+           href="https://www.facebook.com/sharer.php?u={{ .Permalink }}">
+            {{- partial "icon.html" "facebook" -}}
+        </a>
+    {{ end }}
+
+    {{ if .Site.Params.shareButtons.linkedin }}
+        <a class="linkedin-share"
+           target="_blank"
+           rel="noopener"
+           aria-label="{{ i18n "aria_share_linkedin" }}"
+           onclick="share_event('LinkedIn');"
+           href="https://www.linkedin.com/sharing/share-offsite/?url={{ .Permalink }}">
+            {{- partial "icon.html" "linkedin" -}}
+        </a>
+    {{ end }}
+
+    {{ if .Site.Params.shareButtons.reddit }}
+        <a class="reddit-share"
+           target="_blank"
+           rel="noopener"
+           aria-label="{{ i18n "aria_share_reddit" }}"
+           onclick="share_event('Reddit');"
+           href="https://reddit.com/submit?url={{ .Permalink }}&title={{ .Title }}">
+            {{- partial "icon.html" "reddit" -}}
+        </a>
+    {{ end }}
+
+    {{/* Telegram icon doesn't have `viewbox` set, which breaks the sizing.
+            https://stackoverflow.com/q/72073399/19003757
+            https://github.com/michaelampr/jam/issues/39
+    {{ if .Site.Params.shareButtons.telegram }}
+        <a class="telegram-share"
+           target="_blank"
+           rel="noopener"
+           aria-label="{{ i18n "aria_share_telegram" }}"
+           onclick="share_event('Telegram');"
+           href="https://t.me/share/url?url={{ .Permalink }}&text={{ .Title }}">
+            {{- partial "icon.html" "telegram" -}}
+        </a>
+    {{ end }}
+    */}}
+
+    {{ if .Site.Params.shareButtons.print }}
+        <a class="print-share"
+           aria-label="{{ i18n "aria_share_print" }}"
+           href="javascript:void(0)"
+           onclick="window.print(); share_event('Print');">
+            {{- partial "icon.html" "printer" -}}
+        </a>
+    {{ end }}
+</div>

layouts/_partials/top.html

@@ -1,6 +1,6 @@
 <div class="top">
     <header class="header">
-        <a href="{{ .Site.Home.Permalink | absLangURL }}">
+        <a class="heading-link" href="{{ .Site.Home.Permalink | absLangURL }}">
             {{ .Site.Title | markdownify }}
         </a>
     </header>

layouts/_shortcodes/full-width-hr.html

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

layouts/authors/summary.html

@@ -1,15 +1,13 @@
 <h2 class="page-title">
-    <a href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
+    <a class="heading-link" href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
     {{ if .Draft }}{{ partial "icon.html" "write" }}{{ end }}
 </h2>
 
 {{ partial "page-metadata/author.html" . }}
 
-{{ 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>

layouts/baseof.html

@@ -13,28 +13,28 @@
                 {{ partial "breadcrumb.html" . }}
             {{ end }}
 
-            <main id="main-content">
+            <main id="main-content" {{ if .IsPage }}data-pagefind-body{{ end }}>
                 {{ block "main" . }}
                     THIS TEXT SHOULD NOT SHOW. YUZSIQGHE (that string is so I can grep for it)
                 {{ end }}
             </main>
-
-            {{ if or .Site.Copyright .Site.Params.footer }}
-                <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/page.html

@@ -24,7 +24,7 @@
 
     {{ partial "feature-figure.html" . }}
 
-    <article class="post-content" data-pagefind-body>
+    <article class="post-content">
         {{ .Content }}
     </article>
 
@@ -60,6 +60,10 @@
         </div>
     {{ end }}
 
+    {{ if .Site.Params.shareButtons }}
+        {{ partial "share.html" . }}
+    {{ end }}
+
     {{ if .Params.comments }}
         <div class="comments">
             {{ partial "comments.html" . }}

layouts/section.summary.html

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

layouts/series/summary.html

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

layouts/summary.html

@@ -1,6 +1,6 @@
 <h2 class="page-title">
     {{ with .Parent.Params.icon }}{{ partial "icon.html" . }}{{ end }}
-    <a href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
+    <a class="heading-link" href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
     {{ if .Draft }}{{ partial "icon.html" "write" }}{{ end }}
 </h2>
 
@@ -8,11 +8,9 @@
 
 {{ partial "feature-figure.html" . }}
 
-{{ 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>

layouts/taxonomy.html

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