WIP breadcrumb style

See #52

README.md

@@ -1,2 +1,4 @@
 # bobatheme
-Simple Hugo theme
+
+The (boba) best Hugo theme. Contains everything I need for bbaovanc.com and
+boba.best.

archetypes/blog/index.md

@@ -2,6 +2,7 @@
 
 title: {{ replace .Name "-" " " | humanize }}
 date: {{ .Date }}
+lastmod: {{ .Date }}
 toc: true
 comments: true
 draft: true
@@ -9,11 +10,14 @@ draft: true
 authors:
   - {{ with .Site.Author.name }}{{ . }}{{ else }}John Doe{{ end }}
 
+categories:
+  - archetype-stuff
+
 tags:
   - awesome
 
 series:
-  - Archetype
+  - archetype
 
 # this will be shown for the article in list pages and in the page metadata
 # it can be either an image or video (this might change in the future, however)

archetypes/categories/_index.md

@@ -0,0 +1,15 @@
+---
+
+title: {{ replace .Name "-" " " | title }}
+
+---
+
+A short summary of what the category is about.
+
+<!--more-->
+
+Optionally provide more information about the category here. This part will only
+show on the category page, not on the category list page.
+
+If you delete this section, DO NOT delete the summary separator (`<!--more-->`)
+or else the summary won't be shown.

assets/css/bobastyle.css

@@ -3,55 +3,119 @@
  */
 
 :root {
-  --background: #111;
-  --background-2: #222;
-  --background-3: #282828;
-  --background-4: #333;
-  --background-5: #444;
-  --text-normal: #d3d3d3;
-  --link-color: #4da6ff;
-  --figure-border: #1b5b9b;
+  --background-0: #111111;  /* lch(5, 0, X) */
+  --background-1: #212121;  /* lch(12.5, 0, X) */
+  --background-2: #303030;  /* lch(20, 0, X) */
+  --background-3: #414141;  /* lch(27.5, 0, X) */
+
+  --background-pink-1:      #331821;  /* lch(12.5, 15, 0) */
+  --background-red-1:       #331917;  /* lch(12.5, 15, 30) */
+  --background-orange-1:    #2e1c0e;  /* lch(12.5, 15, 60) */
+  --background-yellow-1:    #262008;  /* lch(12.5, 15, 90) */
+  --background-lime-1:      #1b230c;  /* lch(12.5, 15, 120) */
+  --background-green-1:     #0e2516;  /* lch(12.5, 15, 150) */
+  --background-turquoise-1: #012620;  /* lch(12.5, 15, 180) */
+  --background-teal-1:      #00262b;  /* lch(12.5, 15, 210) -- out of sRGB */
+  --background-cerulean-1:  #032432;  /* lch(12.5, 15, 240) */
+  --background-blue-1:      #152135;  /* lch(12.5, 15, 270) */
+  --background-purple-1:    #241d33;  /* lch(12.5, 15, 300) */
+  --background-magenta-1:   #2e1a2b;  /* lch(12.5, 15, 330) */
+
+  --background-pink-2:      #4b2431;  /* lch(20, 20, 0) */
+  --background-red-2:       #4a2623;  /* lch(20, 20, 30) */
+  --background-orange-2:    #432a17;  /* lch(20, 20, 60) */
+  --background-yellow-2:    #373012;  /* lch(20, 20, 90) */
+  --background-lime-2:      #283416;  /* lch(20, 20, 120) */
+  --background-green-2:     #163721;  /* lch(20, 20, 150) */
+  --background-turquoise-2: #003830;  /* lch(20, 20, 180) -- out of sRGB */
+  --background-teal-2:      #00373e;  /* lch(20, 20, 210) -- out of sRGB */
+  --background-cerulean-2:  #013549;  /* lch(20, 20, 240) */
+  --background-blue-2:      #1f314e;  /* lch(20, 20, 270) */
+  --background-purple-2:    #352c4a;  /* lch(20, 20, 300) */
+  --background-magenta-2:   #43263f;  /* lch(20, 20, 330) */
+
+  --background-accent-1: var(--background-blue-1);
+  --background-accent-2: var(--background-blue-2);
+
+  --text-0: #d4d4d4;  /* lch(85, 0, X) */
+  --text-1: #d4d4d4;  /* lch(85, 0, X) */
+  --text-2: #d4d4d4;  /* lch(85, 0, X) */
+  --text-3: #e9e9e9;  /* lch(92.5, 0, X) */
+
+  --text-gray-0: #ababab; /* lch(70, 0, X) */
+  --text-gray-1: #919191; /* lch(60, 0, X) */
+
+  --link-0: #3a94fb; /* lch(60, 60, 270) */
+
+  --figure-border: #1f5593; /* lch(35, 40, 270) */
 
   --pagination-active-hover-text: black;
-  --pagination-active-background: #163b64;
-  --pagination-active-hover-background: #286ab2;
+  --pagination-active-background: #1a3d69; /* lch(25, 30, 270) */
+  --pagination-active-hover-background: #2061a8; /* lch(40, 45, 270) */
 }
 
-@media (prefers-color-scheme: light) {
+@media print, (prefers-color-scheme: light) {
   :root {
-    --background: #eee;
-    --background-2: #ddd;
-    --background-3: #d8d8d8;
-    --background-4: #bbb;
-    --background-5: #aaa;
-    --text-normal: #000;
-    --link-color: #0057bf;
-    --figure-border: #2e7bc9;
+    --background-0: #f1f1f1;  /* lch(95, 0, X) */
+    --background-1: #dbdbdb;  /* lch(87.5, 0, X) */
+    --background-2: #c6c6c6;  /* lch(80, 0, X) */
+    --background-3: #b2b2b2;  /* lch(72.5, 0, X) */
+
+    --background-pink-1:      #f7d1dc;  /* lch(87.5, 15, 0) */
+    --background-red-1:       #f8d2ce;  /* lch(87.5, 15, 30) */
+    --background-orange-1:    #f1d6c3;  /* lch(87.5, 15, 60) */
+    --background-yellow-1:    #e4dbbf;  /* lch(87.5, 15, 90) */
+    --background-lime-1:      #d5dfc2;  /* lch(87.5, 15, 120) */
+    --background-green-1:     #c6e3cc;  /* lch(87.5, 15, 150) */
+    --background-turquoise-1: #bce4db;  /* lch(87.5, 15, 180) */
+    --background-teal-1:      #bae3e9;  /* lch(87.5, 15, 210) */
+    --background-cerulean-1:  #c2e0f4;  /* lch(87.5, 15, 240) */
+    --background-blue-1:      #d0dcf8;  /* lch(87.5, 15, 270) */
+    --background-purple-1:    #e1d7f4;  /* lch(87.5, 15, 300) */
+    --background-magenta-1:   #efd3ea;  /* lch(87.5, 15, 330) */
+
+    --background-pink-2:      #fbb1c8;  /* lch(80, 30, 0) */
+    --background-red-2:       #fbb4ac;  /* lch(80, 30, 30) */
+    --background-orange-2:    #eebc97;  /* lch(80, 30, 60) */
+    --background-yellow-2:    #d6c58e;  /* lch(80, 30, 90) */
+    --background-lime-2:      #b8ce95;  /* lch(80, 30, 120) */
+    --background-green-2:     #9ad4a9;  /* lch(80, 30, 150) */
+    --background-turquoise-2: #81d6c5;  /* lch(80, 30, 180) */
+    --background-teal-2:      #7ad5e1;  /* lch(80, 30, 210) */
+    --background-cerulean-2:  #8cd0f6;  /* lch(80, 30, 240) */
+    --background-blue-2:      #adc8fe;  /* lch(80, 30, 270) */
+    --background-purple-2:    #d0bef7;  /* lch(80, 30, 300) */
+    --background-magenta-2:   #ecb5e3;  /* lch(80, 30, 330) */
+
+    --background-accent-1: var(--background-blue-1);
+    --background-accent-2: var(--background-blue-2);
+
+    --text-0: #262626;  /* lch(15, 0, X) */
+    --text-1: #262626;  /* lch(15, 0, X) */
+    --text-2: #262626;  /* lch(15, 0, X) */
+    --text-3: #171717;  /* lch(72.5, 0, X) */
+
+    --text-gray-0: #474747; /* lch(30, 0, X) */
+    --text-gray-1: #5e5e5e; /* lch(40, 0, X) */
+
+    --link-0: #2061a8; /* lch(40, 45, 270) */
+
+    --figure-border: #367acd; /* lch(50, 50, 270) */
 
     --pagination-active-hover-text: white;
-    --pagination-active-background: #3977bd;
-    --pagination-active-hover-background: #154172;
+    --pagination-active-background: #9fbaf0; /* lch(75, 30, 270) */
+    --pagination-active-hover-background: #6193e0; /* lch(60, 45, 270) */
   }
 }
 
 @media print {
   :root {
-    --background: #fff;
-    --background-2: #ddd;
-    --background-3: #d8d8d8;
-    --background-4: #bbb;
-    --background-5: #aaa;
-    --text-normal: #000;
-    --link-color: #0057bf;
-    --figure-border: #2e7bc9;
-
-    --pagination-active-hover-text: white;
-    --pagination-active-background: #3977bd;
-    --pagination-active-hover-background: #154172;
+    --background-0: #fff;
   }
 }
 
 
+
 /* Post layout (in list pages) */
 .list-page-content {
   display: flex;
@@ -68,6 +132,10 @@
   gap: 40px;
 }
 
+.series-taxonomy ul {
+  gap: 80px;
+}
+
 .page-list li,
 .series-taxonomy li {
   padding-top: 8px;
@@ -75,7 +143,8 @@
   padding-right: 24px;
   padding-bottom: 24px;
   border-radius: 12px;
-  background-color: var(--background-2);
+  background-color: var(--background-1);
+  color: var(--text-1);
 }
 
 .post-series-position {
@@ -84,24 +153,29 @@
   opacity: .75;
 }
 
-.post-title {
+.post-title,
+.author-name {
   margin-bottom: 10px;
 }
 
-.post-title a {
+.post-title a,
+.author-name a {
   color: inherit;
   text-decoration: inherit;
 }
 
-.post-meta-item {
+.post-meta-item,
+.author-meta-item {
   margin-right: 10px;
   display: inline-block;
 }
 
-.post-metadata {
+.post-metadata,
+.author-metadata {
   margin-bottom: 15px;
 }
 
+.categories,
 .tags,
 .series {
   margin-top: 10px;
@@ -111,7 +185,8 @@
   margin-top: 15px;
 }
 
-.post-description {
+.post-description,
+.author-description {
   margin-top: 10px;
 }
 
@@ -121,24 +196,49 @@
 
 
 
-/* Tags list format */
-.tag-list ul {
-  display: flex;
+/* Taxonomy list format */
+.taxonomy-list a,
+.taxonomy-list .taxonomy-metadata {
+  white-space: nowrap;
+}
+
+.taxonomy-list p {
+  margin: 0;
+}
+
+.taxonomy-list ul {
   list-style: none;
-  gap: 10px;
-  flex-flow: row wrap;
   padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
 }
 
-.tag-list a {
-  background-color: var(--background-2);
+.taxonomy-list li {
+  background-color: var(--background-1);
+  color: var(--text-1);
   padding: 8px 12px;
-  border-radius: 12px;
+  border-radius: 8px;
+  display: flex;
+  flex-direction: row;
+  gap: 20px;
 }
 
-.tag-list a:hover {
-  text-decoration: none;
-  background-color: var(--background-4);
+.taxonomy-list-left {
+  display: flex;
+  flex-direction: column;
+}
+
+@media (max-width: 480px) {
+  .taxonomy-list li {
+    flex-direction: column;
+    gap: 4px;
+  }
+
+  .taxonomy-list-left {
+    flex-direction: row;
+    justify-content: space-between;
+  }
 }
 
 
@@ -149,8 +249,8 @@
   gap: 10px;
   flex-flow: row wrap;
   list-style: none;
-  padding: 0;
-  background-color: var(--background);
+  background-color: var(--background-0);
+  color: var(--text-0);
   padding: 8px;
   border-radius: 16px;
 }
@@ -170,13 +270,15 @@
 }
 
 .section {
-  background-color: var(--background-2);
+  background-color: var(--background-1);
+  color: var(--text-1);
   border-radius: 12px;
   padding: 1px 25px;
 }
 
 .section:hover {
-  background-color: var(--background-4);
+  background-color: var(--background-2);
+  color: var(--text-2);
 }
 
 .section-title {
@@ -202,8 +304,8 @@
 
 
 /* Header formatting (website title and article section headers) */
-.top {
-  margin: 20px;
+h1.header {
+  font-size: 1.5em;
 }
 
 .header a,
@@ -220,14 +322,16 @@
 
 /* Content formatting */
 .series-box {
-  background-color: var(--background-2);
+  background-color: var(--background-1);
+  color: var(--text-1);
   padding: 8px 16px;
   border-radius: 8px;
   margin: 15px 0;
 }
 
 .table-of-contents {
-  background-color: var(--background-2);
+  background-color: var(--background-1);
+  color: var(--text-1);
   padding: 8px 20px;
   border-radius: 8px;
   margin: 10px 0;
@@ -242,21 +346,121 @@
   padding: 8px 15px;
 }
 
-.content,
-footer {
-  margin: 20px;
+
+/* Related posts */
+.full-width-page-list {
+  /* make left/right 0 margin so it takes up full width */
+  margin: 25px 0;
 }
 
-footer {
-  text-align: center;
+.full-width-page-list > hr,
+.full-width-page-list > h1 {
+  margin-left: 20px;
+  margin-right: 20px;
 }
 
+.full-width-page-list li {
+  min-width: 300px;
+  max-width: 300px;
+
+}
+
+.full-width-page-list li:first-child {
+  margin-left: 20px;
+}
+.full-width-page-list li:last-child {
+  margin-right: 20px;
+}
+
+@media (max-width: 720px) {
+  /* when the screen is smaller than max size, make sure that the .related div
+   * still reaches the screen edge. then if the posts overflow and require
+   * scrolling, you can see it cut off on the side of your phone screen
+   */
+  .full-width-page-list {
+    margin-left: -20px;
+    margin-right: -20px;
+  }
+}
+
+@media (min-width: 720px) {
+  .full-width-page-list {
+    /* this makes it full width -- 720px max-width on body it is exactly 720px
+     * so .related takes up full width
+     */
+    margin-left: calc(-100vw / 2 + 720px / 2);
+    margin-right: calc(-100vw / 2 + 720px / 2);
+  }
+}
+
+.full-width-page-list .page-list ul {
+  display: flex;
+  flex-direction: row;
+  gap: 20px;
+  overflow-x: scroll;
+}
+
+
+/* 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;
+}
+
+.share-buttons button,
+.share-buttons a {
+  background-color: var(--background-2);
+  color: var(--text-2);
+  padding: 4px;
+  border-radius: 8px;
+}
+
+.share-buttons button {
+  border: none;
+}
+
+.share-buttons svg {
+  width: 32px;
+  height: 32px;
+}
+
+/* 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);
+  color: var(--text-1);
+  padding: 8px 12px;
+  border-radius: 8px;
+  margin: 10px 0;
+}
+
+.see-also p {
+  margin: 0;
+}
+
+
+/* Back to top */
 #back-to-top {
   position: fixed;
   float: right;
   bottom: 25px;
   right: 25px;
-  background-color: var(--background-3);
+  background-color: var(--background-1);
+  color: var(--text-1);
   border-radius: 100%;
   padding: 12px;
   display: none;
@@ -269,7 +473,8 @@ footer {
   display: flex;
   flex-wrap: nowrap;
   flex-direction: row;
-  background-color: var(--background-2);
+  background-color: var(--background-1);
+  color: var(--text-1);
   border-radius: 8px;
   margin-top: 5px;
   padding: 4px;
@@ -278,9 +483,6 @@ footer {
 
 .navbar {
   display: flex;
-}
-
-.navbar {
   flex-grow: 1;
   overflow: auto;
 }
@@ -288,15 +490,21 @@ footer {
 .navbar a {
   padding: 8px 12px;
   border-radius: 12px;
+  white-space: nowrap;
 }
 
 .navbar-item:hover,
 .langpicker summary:hover,
 .langpicker[open] summary {
-  background-color: var(--background-5);
+  background-color: var(--background-3);
   text-decoration: none;
 }
 
+.langpicker summary:hover,
+.langpicker[open] summary {
+  color: var(--text-3);
+}
+
 .topbar .active {
   font-weight: bold;
 }
@@ -317,8 +525,9 @@ footer {
   position: absolute;
   margin-top: 8px;
   right: 0;
-  background-color: var(--background-2);
-  border: 2px solid var(--background-4);
+  background-color: var(--background-1);
+  color: var(--text-1);
+  border: 2px solid var(--background-2);
   padding: 8px 12px;
   border-radius: 8px;
   list-style: none;
@@ -347,14 +556,28 @@ html {
 }
 
 body {
-  background-color: var(--background);
-  color: var(--text-normal);
+  background-color: var(--background-0);
+  color: var(--text-0);
   font-family: "Open Sans", "Noto Sans", sans-serif;
-  margin: auto;
+  margin: 20px;
   max-width: 720px;
   overflow-wrap: break-word;
 }
 
+@media (min-width: 760px) {
+  body {
+    margin: 20px auto;
+  }
+}
+
+footer {
+  text-align: center;
+}
+
+footer p {
+  margin: 0;
+}
+
 img,
 video {
   max-width: 100%;
@@ -383,15 +606,8 @@ figcaption {
   text-align: center;
 }
 
-aside {
-  background-color: var(--background-2);
-  padding: 12px 16px;
-  margin: 16px 0;
-  border-radius: 8px;
-}
-
 a {
-  color: var(--link-color);
+  color: var(--link-0);
   text-decoration: inherit;
 }
 
@@ -400,12 +616,36 @@ a:hover {
 }
 
 blockquote {
-  border-left: 5px solid var(--background-4);
+  border-left: 5px solid var(--background-2);
   padding-left: 15px;
 }
 
 hr {
-  border-color: var(--background-5);
+  border: 1px solid var(--background-3);
+}
+
+table.markdown {
+  border-collapse: collapse;
+  border: 2px solid var(--text-1);
+}
+
+.markdown thead {
+  background-color: var(--background-2);
+  color: var(--text-2);
+}
+
+.markdown th,
+.markdown td {
+  padding: 8px;
+}
+
+.markdown tbody tr:nth-child(odd) {
+  background-color: var(--background-0);
+  color: var(--text-0);
+}
+.markdown tbody tr:nth-child(even) {
+  background-color: var(--background-1);
+  color: var(--text-1);
 }
 
 * {
@@ -425,7 +665,11 @@ hr {
 }
 
 :not(pre) > code {
-  background-color: var(--background-3);
+  background-color: var(--background-2);
+  /* Disable this because it overrides inline code blocks that are
+   * also links
+  color: var(--text-2);
+   */
   padding: 2px 4px;
   overflow-wrap: break-word;
 }
@@ -440,11 +684,53 @@ code {
 
 
 
+/* Asides */
+aside {
+  padding: 8px 16px;
+  margin: 16px 0;
+  border-radius: 8px;
+  color: var(--text-1);
+}
+
+.aside-title {
+  margin-bottom: 8px;
+  padding-bottom: 4px;
+  font-weight: bold;
+}
+
+.aside-content > :first-child {
+  margin-top: 0;
+}
+.aside-content > :last-child {
+  margin-bottom: 0;
+}
+
+aside.note {
+  background-color: var(--background-blue-1);
+}
+aside.info {
+  background-color: var(--background-green-1);
+}
+aside.tip {
+  background-color: var(--background-teal-1);
+}
+aside.warning {
+  background-color: var(--background-yellow-1);
+}
+aside.example {
+  background-color: var(--background-purple-1);
+}
+aside.quote {
+  background-color: var(--background-1);
+}
+
+
+
 /* Icons */
 .icon {
   width: 20px;
   height: 20px;
-  color: var(--text-normal);
+  color: var(--text-1);
   text-align: center;
   display: inline;
   vertical-align: middle;
@@ -471,7 +757,7 @@ h1 svg.icon {
 .page-link {
   padding: 8px 16px;
   border-radius: 5px;
-  color: var(--text-normal);
+  color: var(--text-1);
 }
 
 .page-item.active .page-link {
@@ -482,6 +768,7 @@ h1 svg.icon {
 .page-item.active .page-link:hover {
   background-color: var(--pagination-active-hover-background);
   color: var(--pagination-active-hover-text);
+  cursor: default;
 }
 
 .page-link:hover {
@@ -489,7 +776,7 @@ h1 svg.icon {
 }
 
 :not(li.disabled) > .page-link:hover {
-  background-color: var(--background-5);
+  background-color: var(--background-3);
 }
 
 li.disabled {
@@ -504,22 +791,45 @@ li.disabled > .page-link:hover {
 
 /* Breadcrumb navigation */
 .breadcrumb {
-  margin-top: 40px;
-  margin-bottom: 20px;
-  margin-left: 20px;
+  margin: 16px 0;
 }
 
 .breadcrumb ul {
   padding: 0;
   list-style: none;
+  display: flex;
+  justify-content: space-between;
+  flex-grow: 1;
 }
 
 .breadcrumb li {
   display: inline;
+  padding: 8px;
+  background-color: var(--background-1);
 }
 
-.breadcrumb li+li:before {
-  content: "»"
+.breadcrumb li:hover {
+  background-color: var(--background-2);
+  cursor: pointer;
+}
+
+.breadcrumb li a:hover {
+  text-decoration: none;
+}
+
+.breadcrumb li.active:hover {
+  cursor: default;
+}
+
+.breadcrumb li:first-child {
+  border-top-left-radius: 12px;
+  border-bottom-left-radius: 12px;
+  padding-left: 12px;
+}
+.breadcrumb li:last-child {
+  border-top-right-radius: 12px;
+  border-bottom-right-radius: 12px;
+  padding-right: 12px;
 }
 
 
@@ -537,12 +847,14 @@ li.disabled > .page-link:hover {
   display: flex;
   flex-direction: column;
   color: inherit;
-  background-color: var(--background-2);
+  background-color: var(--background-1);
+  color: var(--text-1);
   padding: 8px 16px;
 }
 
 .prevnext > a:hover {
-  background-color: var(--background-4);
+  background-color: var(--background-2);
+  color: var(--text-2);
   text-decoration: none;
 }
 
@@ -572,12 +884,8 @@ li.disabled > .page-link:hover {
 
 
 /* Light mode */
-@media print, (prefers-color-scheme: light) {
-  /* Basic elements */
-  .section:hover {
-    color: inherit;
-  }
-
+@media print,
+(prefers-color-scheme: light) {
   li.disabled {
     opacity: .25;
   }
@@ -588,10 +896,12 @@ li.disabled > .page-link:hover {
 /* Print compatibility */
 @media print {
   .top,
-  .breadcrumb,
   .section-header-link,
+  .post-meta-edit-history,
   .prevnext,
-  .comments {
+  .share-buttons,
+  .related-posts,
+  .latest-posts {
     display: none;
   }
 

assets/js/share-event.js

@@ -0,0 +1,3 @@
+function share_event(service) {
+    // this function does nothing by default
+}

config.yaml

@@ -4,11 +4,10 @@ markup:
     lineNos: true
 
 params:
-  faviconICO: favicon.ico
-  faviconPNG: favicon.png
   readingtime: true
 
 taxonomies:
+  category: categories
   tag: tags
   author: authors
   series: series

exampleSite/config.yaml

@@ -20,9 +20,9 @@ params:
   # these are for the OpenGraph/Twitter embeds in Hugo
   description: Example website for bobatheme
 
-  # these are for favicons in bobatheme (defaults are shown here)
-  # faviconICO: favicon.ico
-  # faviconPNG: favicon.png
+  # 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
@@ -30,6 +30,26 @@ params:
   # 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
+
+  # display a "Latest Posts" section on the homepage below its content
+  homepageLatestPosts: true
+
+  # 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

i18n/en.yaml

@@ -8,6 +8,12 @@ table_of_contents:
 browser_no_video_support:
   other: "Your browser does not support video."
 
+latest_posts:
+  other: "Latest Posts"
+
+see_also:
+  other: "SEE ALSO:"
+
 
 # Meta items
 long_date:
@@ -21,6 +27,9 @@ readingtime:
   one: "{{ . }} min"
   other: "{{ . }} mins"
 
+edit_history:
+  other: "Edit history"
+
 
 # Post count
 no_posts:
@@ -35,8 +44,8 @@ post_count:
 read_more:
   other: "Read more"
 
-see_also:
-  other: "See also"
+related_posts:
+  other: "Related Posts"
 
 older_post:
   other: "Older"
@@ -55,12 +64,15 @@ aria_back_to_top_button:
 aria_rss_link:
   other: "RSS feed link"
 
-aria_post_meta_view_source:
-  other: "link to page source"
+aria_post_meta_edit_history:
+  other: "link to page edit history"
 
 aria_post_meta_translations:
   other: "translations"
 
+aria_post_meta_categories:
+  other: "categories"
+
 aria_post_meta_tags:
   other: "tags"
 
@@ -82,6 +94,9 @@ aria_post_metadata:
 aria_author_metadata:
   other: "author metadata"
 
+aria_taxonomy_metadata:
+  other: "taxonomy metadata"
+
 aria_post_meta_date:
   other: "date"
 
@@ -94,6 +109,9 @@ aria_author_post_count:
 aria_author_word_count:
   other: "word count"
 
+aria_taxonomy_post_count:
+  other: "post count"
+
 aria_series_metadata:
   other: "series metadata"
 

i18n/es.yaml

@@ -8,6 +8,12 @@ table_of_contents:
 browser_no_video_support:
   other: "Tu navegador de internet no admite video."
 
+latest_posts:
+  other: "Artículos recientes"
+
+see_also:
+  other: "Véase también:"
+
 
 # Meta items
 long_date:
@@ -21,22 +27,25 @@ readingtime:
   one: "{{ . }} min"
   other: "{{ . }} mins"
 
+edit_history:
+  other: "Historial de cambios"
+
 
 # Post count
 no_posts:
   other: "¡No hay contenido para mostrar!"
 
-# post_count:
-#   one: "{{ . }} post"
-#   other: "{{ . }} posts"
+post_count:
+  one: "{{ . }} publicación"
+  other: "{{ . }} publicaciones"
 
 
 # Navigation
 read_more:
   other: "Leer más"
 
-see_also:
-  other: "Véase también"
+related_posts:
+  other: "Publicaciones similares"
 
 older_post:
   other: "Más antiguo"
@@ -55,12 +64,15 @@ newer_post:
 # aria_rss_link:
 #   other: "RSS feed link"
 
-# aria_post_meta_view_source:
-#   other: "link to page source"
+# aria_post_meta_edit_history:
+#   other: "link to page edit history"
 
 # aria_post_meta_translations:
 #   other: "translations"
 
+# aria_post_meta_categories:
+#   other: "categories"
+
 # aria_post_meta_tags:
 #   other: "tags"
 
@@ -82,6 +94,9 @@ newer_post:
 # aria_author_metadata:
 #   other: "author metadata"
 
+# aria_taxonomy_metadata:
+#   other: "taxonomy metadata"
+
 # aria_post_meta_date:
 #   other: "date"
 
@@ -94,6 +109,9 @@ newer_post:
 # aria_author_word_count:
 #   other: "word count"
 
+# aria_taxonomy_post_count:
+#   other: "post count"
+
 # aria_series_metadata:
 #   other: "series metadata"
 

layouts/_default/baseof.html

@@ -14,17 +14,23 @@
             {{ partial "breadcrumb.html" . }}
         {{ end }}
 
-        <div class="content">
+        <main>
             {{ block "main" . }}
-                {{ .Content }}
+                THIS TEXT SHOULD NOT SHOW. YUZSIQGHE (that string is so I can grep for it)
             {{ end }}
-        </div>
+        </main>
 
-        {{ with .Site.Copyright }}
+        {{ if or .Site.Copyright .Site.Params.footer }}
+            <hr>
             <footer>
-                <hr>
                 <small>
-                    {{ . | safeHTML }}
+                    {{ with .Site.Copyright }}
+                        <p>{{ . | safeHTML }}</p>
+                    {{ end }}
+
+                    {{ with .Site.Params.footer }}
+                        {{ . | $.RenderString (dict "display" "block") }}
+                    {{ end }}
                 </small>
             </footer>
         {{ end }}

layouts/_default/list.html

@@ -14,19 +14,7 @@
             </div>
         {{ end }}
 
-        <div class="page-list">
-            {{ with .Paginator.Pages }}
-                <ul>
-                    {{ range . }}
-                        <li>{{ .Render "summary/post" }}</li>
-                    {{ end }}
-                </ul>
-            {{ else }}
-                <div>
-                    {{ i18n "no_posts" }}
-                </div>
-            {{ end }}
-        </div>
+        {{ partial "page-list.html" .Paginator.Pages }}
     </div>
 
     {{ partial "pagination.html" . }}

layouts/_default/single.html

@@ -7,25 +7,7 @@
     </div>
 
     {{ partial "post-metadata/full.html" . }}
-
-    {{ with (.GetTerms "series") }}
-        {{ $series := slice }}
-        {{ range . }}
-            {{ $series = $series | append (printf `<a href="%s">%s</a>` .Permalink .LinkTitle) }}
-        {{ end }}
-
-        <div class="series-box">
-            {{ partial "icon.html" "info" }}
-            {{ if gt (len $series) 1 }}
-                This post is part of multiple series:
-            {{ else }}
-                This post is part of a series:
-            {{ end }}
-
-            {{ delimit $series ", " }}
-        </div>
-    {{ end }}
-
+    {{ partial "series-box.html" . }}
 
     {{ if .Params.Toc }}
         <div class="table-of-contents" aria-label="{{ i18n "aria_table_of_contents" }}">
@@ -42,27 +24,15 @@
 
     {{ with .Resources.GetMatch "feature" }}
         <div class="post-media">
-            {{ partial "figure.html" (dict "src" . "border" true) }}
+            {{ partial "figure.html" (dict "src" .) }}
         </div>
     {{ end }}
 
-    {{ .Content }}
+    <div class="post-content">
+        {{ .Content }}
+    </div>
 
-    {{ $related := .Site.RegularPages.Related . | first 5 }}
-    {{ with $related }}
-        <div class="see-also">
-            <h2>{{ i18n "see_also" }}</h2>
-
-            <ul>
-                {{ range . }}
-                    <li>
-                        {{ with .Parent.Params.icon }}{{ partial "icon.html" . }}{{ end }}
-                        <a href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
-                    </li>
-                {{ end }}
-            </ul>
-        </div>
-    {{ end }}
+    {{ partial "series-box.html" . }}
 
     {{ if or .NextInSection .PrevInSection }}
         <div class="prevnext">
@@ -94,9 +64,26 @@
         </div>
     {{ end }}
 
+    {{ if .Site.Params.shareButtons }}
+        {{ partial "share.html" . }}
+    {{ end }}
+
     {{ if .Params.comments }}
         <div class="comments">
             {{ partial "comments.html" . }}
         </div>
     {{ end }}
+
+    {{ $related := .Site.RegularPages.Related . | first 10 }}
+    {{ with $related }}
+        <div class="related-posts full-width-page-list">
+            <hr>
+            <h1>{{ i18n "related_posts" }}</h1>
+            {{ partial "page-list.html" . }}
+        </div>
+    {{ end }}
+
+    {{ if .Site.Params.latestPostsOnContent }}
+        {{ partialCached "latest-posts.html" . }}
+    {{ end }}
 {{ end }}

layouts/_default/summary/author.html

@@ -1,12 +1,12 @@
-<div class="post">
-    <h2 class="post-title">
+<div class="author">
+    <h2 class="author-name">
         <a href="{{ .Permalink }}">{{ .Title | markdownify }}</a>
         {{ if .Draft }}{{ partial "icon.html" "write" }}{{ end }}
     </h2>
 
     {{ partial "post-metadata/author.html" . }}
 
-    <div class="post-description">
+    <div class="author-description">
         {{ partial "description-or-summary.html" . }}
     </div>
 

layouts/_default/summary/post.html

@@ -9,7 +9,7 @@
 
     {{ with .Resources.GetMatch "feature" }}
         <div class="post-media">
-            {{ partial "figure.html" (dict "src" . "border" true) }}
+            {{ partial "figure.html" (dict "src" .) }}
         </div>
     {{ end }}
 

layouts/_default/summary/series_post.html

@@ -15,7 +15,7 @@
 
     {{ with .Resources.GetMatch "feature" }}
         <div class="post-media">
-            {{ partial "figure.html" (dict "src" . "border" true) }}
+            {{ partial "figure.html" (dict "src" .) }}
         </div>
     {{ end }}
 

layouts/authors/term.html

@@ -7,21 +7,11 @@
 
     {{ partial "post-metadata/author.html" . }}
 
-    {{ .Content }}
+    {{ with .Content }}
+        {{ . }}
+    {{ end }}
 
-    <div class="page-list">
-        {{ with .Paginator.Pages }}
-            <ul>
-                {{ range . }}
-                    <li>{{ .Render "summary/post" }}</li>
-                {{ end }}
-            </ul>
-        {{ else }}
-            <div>
-                {{ i18n "no_posts" }}
-            </div>
-        {{ end }}
-    </div>
+    {{ partial "page-list.html" .Paginator.Pages }}
 
     {{ partial "pagination.html" . }}
 {{ end }}

layouts/index.html

@@ -1,2 +1,21 @@
 {{ define "main" }}
+    {{ with .Content }}
+        <div class="homepage-content">
+            {{ . }}
+        </div>
+        <hr>
+    {{ end }}
+
+    {{ if .Site.Params.homepageLatestPosts }}
+        <div class="homepage-latest-posts">
+            <h1>
+                {{ i18n "latest_posts" }}
+                {{ partial "rss-link.html" . }}
+            </h1>
+
+            {{ partial "page-list.html" (.Paginate .Site.RegularPages).Pages }}
+
+            {{ partial "pagination.html" . }}
+        </div>
+    {{ end }}
 {{ end }}

layouts/partials/additional-head.html

@@ -0,0 +1,4 @@
+{{/*
+    Create a file named `layouts/partials/additional-head.html` at your site root to
+    add extra tags into <head>. Page variables are passed.
+*/}}

layouts/partials/figure.html

@@ -11,7 +11,7 @@
         {{ if eq .MediaType.MainType "image" }}
             <img src="{{ $media.Permalink }}" alt="{{ $media.Title }}" />
         {{ else if eq .MediaType.MainType "video" }}
-            <video controls>
+            <video controls preload="metadata">
                 <source src="{{ $media.Permalink }}" alt="{{ $media.Title }}">
                 {{ i18n "browser_no_video_support" }}
             </video>

layouts/partials/head.html

@@ -12,15 +12,19 @@
     {{ with resources.Get "css/syntax-light.css" | fingerprint "sha512" }}
         <link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous">
     {{ end }}
+
     {{ with resources.Get "js/back-to-top.js" | fingerprint "sha512" }}
         <script defer src="{{ .Permalink }}" type="text/javascript" integrity="{{ .Data.Integrity }}" crossorigin="anonymous"></script>
     {{ end }}
-
-    {{ with .Site.Params.faviconICO }}
-        <link rel="icon" type="image/x-icon" href="{{ . | absURL }}" />
+    {{ with resources.Get "js/share-event.js" | fingerprint "sha512" }}
+        <script defer src="{{ .Permalink }}" type="text/javascript" integrity="{{ .Data.Integrity }}" crossorigin="anonymous"></script>
     {{ end }}
-    {{ with .Site.Params.faviconPNG }}
-        <link rel="icon" type="image/png" href="{{ . | absURL }}" />
+
+    {{ with .Site.Params.faviconSVG }}
+        <link rel="icon" href="{{ . | absURL }}" />
+    {{ end }}
+    {{ with .Site.Params.appleTouchPNG }}
+        <link rel="apple-touch-icon" href="{{ . | absURL }}" />
     {{ end }}
 
     {{ if .IsHome }}
@@ -37,4 +41,6 @@
 
     <meta name="language" content="{{ .Language.Lang }}">
     <meta name="description" content="{{ (partial "seo-tags/description.html" .) | plainify }}">
+
+    {{ partial "additional-head.html" . }}
 </head>

layouts/partials/icon.html

@@ -1,5 +1 @@
-{{- $icon_resource := resources.Get (printf "jam/icons/%s.svg" .) -}}
-{{- $icon := $icon_resource.Content -}}
-{{- $icon = replaceRE `<svg` `<svg class="icon"` $icon -}}
-{{- $icon = replaceRE `</svg>` (printf `<title>%s icon</title></svg>` .) $icon -}}
-{{- $icon | safeHTML -}}
+{{ partialCached "icon_code.html" . . }}

layouts/partials/icon_code.html

@@ -0,0 +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 `<title>%s icon</title></svg>` .) $icon -}}
+{{- $icon = replaceRE `(width|height)="[0-9]*"` "" $icon -}}
+{{- $icon | safeHTML -}}

layouts/partials/latest-posts.html

@@ -0,0 +1,11 @@
+<div class="latest-posts full-width-page-list">
+    <hr>
+    <h1>
+        {{ i18n "latest_posts" }}
+        {{ partial "rss-link.html" .Site.Home }}
+    </h1>
+
+    {{ with .Site.RegularPages | first 5 }}
+        {{ partial "page-list.html" . }}
+    {{ end }}
+</div>

layouts/partials/page-list.html

@@ -0,0 +1,13 @@
+<div class="page-list">
+    {{ with . }}
+        <ul>
+            {{ range . }}
+                <li>{{ .Render "summary/post" }}</li>
+            {{ end }}
+        </ul>
+    {{ else }}
+        <div>
+            {{ i18n "no_posts" }}
+        </div>
+    {{ end }}
+</div>

layouts/partials/post-meta-item/categories.html

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

layouts/partials/post-meta-item/edithistory.html

@@ -0,0 +1,8 @@
+{{ if and .Site.Params.gitHistoryURL .File.Path }}
+    <span class="post-meta-item post-meta-edit-history" aria-label="{{ i18n "aria_post_meta_edit_history" }}">
+        {{ partial "icon.html" "history" }}
+        <a href="{{ printf "%s/content/%s" .Site.Params.gitHistoryURL .File.Path }}" target="_blank" rel="noopener">
+            {{- i18n "edit_history" -}}
+        </a>
+    </span>
+{{ end }}

layouts/partials/post-meta-item/viewsource.html

@@ -1,13 +0,0 @@
-{{ if and .Site.Params.gitFileURL .File.Path }}
-    <span class="post-meta-item" aria-label="{{ i18n "aria_post_meta_view_source" }}">
-        {{ with .Site.Params.gitFileIcon }}
-            {{ partial "icon.html" . }}
-        {{ else }}
-            {{ partial "icon.html" "file" }}
-        {{ end }}
-
-        <a href="{{ printf "%s/content/%s" .Site.Params.gitFileURL .File.Path }}" target="_blank" rel="noopener">
-            View source
-        </a>
-    </span>
-{{ end }}

layouts/partials/post-metadata/author.html

@@ -1,16 +1,16 @@
-<div class="post-metadata" aria-label="{{ i18n "aria_author_metadata" }}">
+<div class="author-metadata" aria-label="{{ i18n "aria_author_metadata" }}">
     {{/* Calculate the total word count */}}
     {{ $total_words := 0 }}
     {{ range .Data.Pages }}
         {{ $total_words = add $total_words .WordCount }}
     {{ end }}
 
-    <span class="post-meta-item" aria-label="{{ i18n "aria_author_post_count" }}">
+    <span class="author-meta-item" aria-label="{{ i18n "aria_author_post_count" }}">
         {{ partial "icon.html" "newspaper" }}
         {{ i18n "post_count" (len .Data.Pages) }}
     </span>
 
-    <span class="post-meta-item" aria-label="{{ i18n "aria_author_word_count" }}">
+    <span class="author-meta-item" aria-label="{{ i18n "aria_author_word_count" }}">
         {{ partial "icon.html" "align-left" }}
         {{ i18n "wordcount" $total_words }}
     </span>

layouts/partials/post-metadata/full.html

@@ -9,6 +9,7 @@
             </span>
 
             {{/* TODO: make this be a tooltip */}}
+            {{/* DISABLED
             {{ if ne (time.Format "2006-01-02" .Lastmod) (time.Format "2006-01-02" .Date) }}
                 <span class="post-meta-item" aria-label="{{ i18n "aria_post_meta_modified_date" }}">
                     {{ partial "icon.html" "pencil" }}
@@ -17,12 +18,14 @@
                     </time>
                     {{ end }}
                 </span>
+            */}}
         {{ end }}
 
         {{ partial "post-meta-item/authors.html" . }}
         {{ partial "post-meta-item/translations.html" . }}
         {{ partial "post-meta-item/readingtime.html" . }}
-        {{ partial "post-meta-item/viewsource.html" . }}
+        {{ partial "post-meta-item/edithistory.html" . }}
+        {{ partial "post-meta-item/categories.html" . }}
         {{ partial "post-meta-item/tags.html" . }}
     </div>
 {{ end }}

layouts/partials/post-metadata/series.html

@@ -16,7 +16,4 @@
     {{ end }}
 
     {{ partial "post-meta-item/translations.html" . }}
-    {{ if .File }}
-        {{ partial "post-meta-item/viewsource.html" . }}
-    {{ end }}
 </div>

layouts/partials/post-metadata/short.html

@@ -13,6 +13,7 @@
         {{ partial "post-meta-item/translations.html" . }}
         {{ partial "post-meta-item/readingtime.html" . }}
         {{ partial "post-meta-item/series.html" . }}
+        {{ partial "post-meta-item/categories.html" . }}
         {{ partial "post-meta-item/tags.html" . }}
     </div>
 {{ end }}

layouts/partials/post-metadata/taxonomy.html

@@ -0,0 +1,6 @@
+<div class="taxonomy-metadata" aria-label="{{ i18n "aria_taxonomy_metadata" }}">
+    <span class="taxonomy-meta-item" aria-label="{{ i18n "aria_taxonomy_post_count" }}">
+        {{ partial "icon.html" "newspaper" }}
+        {{ i18n "post_count" (len .Data.Pages) }}
+    </span>
+</div>

layouts/partials/remote_figure.html

@@ -12,7 +12,7 @@
     {{ if eq $type "image" }}
         <img src="{{ $src }}" alt="{{ $alt }}" />
     {{ else if eq $type "video" }}
-        <video controls>
+        <video controls preload="metadata">
             <source src="{{ $src }}" alt="{{ $alt }}">
             {{ i18n "browser_no_video_support" }}
         </video>

layouts/partials/series-box.html

@@ -0,0 +1,17 @@
+{{ with (.GetTerms "series") }}
+    {{ $series := slice }}
+    {{ range . }}
+        {{ $series = $series | append (printf `<a href="%s">%s</a>` .Permalink .LinkTitle) }}
+    {{ end }}
+
+    <div class="series-box">
+        {{ partial "icon.html" "info" }}
+        {{ if gt (len $series) 1 }}
+            This post is part of multiple series:
+        {{ else }}
+            This post is part of a series:
+        {{ end }}
+
+        {{ delimit $series ", " }}
+    </div>
+{{ end }}

layouts/partials/share.html

@@ -0,0 +1,62 @@
+<div class="share-buttons">
+    {{ if .Site.Params.shareButtons.twitter }}
+        <a class="twitter-share"
+           target="_blank"
+           rel="noopener"
+           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"
+           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"
+           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"
+           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"
+           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 }}
+        <button class="print-share"
+           onclick="window.print(); share_event('Print');">
+            {{- partial "icon.html" "printer" -}}
+        </button>
+    {{ end }}
+</div>

layouts/partials/top.html

@@ -1,6 +1,6 @@
-<h2 class="header">
+<h1 class="header">
     <a href="{{ .Site.Home.Permalink | absLangURL }}">{{ .Site.Title | markdownify }}</a>
-</h2>
+</h1>
 
 <div class="topbar">
     <nav class="navbar" aria-label="{{ i18n "aria_navbar" }}">
@@ -13,7 +13,9 @@
             {{ if or ($.HasMenuCurrent .Menu .) ($.IsMenuCurrent .Menu .) }}
                 {{ $isActive = true }}
             {{ end }}
-            <a class="navbar-item{{ if $isActive }} active{{ end }}" href="{{ .URL }}">{{ .Name }}</a>
+            <a class="navbar-item{{ if $isActive }} active{{ end }}"
+               {{ if strings.HasPrefix .URL "http" }}target="_blank" rel="noopener"{{ end }}
+               href="{{ .URL }}">{{ .Name }}</a>
         {{ end }}
     </nav>
 

layouts/series/term.html

@@ -7,26 +7,14 @@
 
     {{ partial "post-metadata/series.html" . }}
 
-    {{ partial "description-or-summary.html" . }}
+    {{ with .Content }}
+        {{ . }}
+    {{ end }}
+
+    {{ with .Paginator.Pages.Reverse }}
+        {{ partial "page-list.html" . }}
+    {{ end }}
 
-    <div class="page-list">
-        {{ with .Paginator.Pages.Reverse }}
-            <ul>
-                {{ $i := 0 }}
-                {{ $total := len $.Pages }}
-                {{ range . }}
-                    {{ $i = add 1 $i }}
-                    {{ .Scratch.Set "series_position" $i }}
-                    {{ .Scratch.Set "series_total" $total }}
-                    <li>{{ .Render "summary/post" }}</li>
-                {{ end }}
-            </ul>
-        {{ else }}
-            <div>
-                {{ i18n "no_posts" }}
-            </div>
-        {{ end }}
-    </div>
 
     {{ partial "pagination.html" . }}
 {{ end }}

layouts/shortcodes/abbr.html

@@ -0,0 +1,5 @@
+{{ if .IsNamedParams }}
+    <abbr title="{{ .Get "title" }}">{{ .Inner }}</abbr>
+{{ else }}
+    <abbr title="{{ .Get 0 }}">{{ .Inner }}</abbr>
+{{ end }}

layouts/shortcodes/aside.html

@@ -1,7 +1,28 @@
-<aside>
-    {{ with .Inner }}
-        {{ . | markdownify }}
-    {{ else }}
-        {{ errorf "The aside shortcode needs to be a closing one (similar to the highlight shortcode, see https://gohugo.io/templates/shortcode-templates/#inner" }}
-    {{ end }}
+{{ $type := "" }}
+{{ if .IsNamedParams }}
+    {{ $type = .Get "type" | default "note" }}
+{{ else }}
+    {{ $type = .Get 0 | default "note" }}
+{{ end }}
+
+{{/* This idea comes from the LoveIt theme:
+     https://github.com/dillonzq/LoveIt/blob/aa834e89af8349f6c18d4c7ad50a73fd5f1e40e0/layouts/shortcodes/admonition.html#L3-L14
+*/}}
+
+{{ $icons := dict "note" "pencil" }}
+{{ $icons  = dict "info" "info" | merge $icons }}
+{{ $icons  = dict "tip" "lightbulb" | merge $icons }}
+{{ $icons  = dict "warning" "info" | merge $icons }}
+{{ $icons  = dict "example" "flask" | merge $icons }}
+{{ $icons  = dict "quote" "quote" | merge $icons }}
+
+<aside class="{{ $type }}">
+    <div class="aside-title">
+        {{ partial "icon.html" (index $icons $type) }}
+        {{ title $type }}
+    </div>
+
+    <div class="aside-content">
+        {{ .Inner | .Page.RenderString (dict "display" "block") }}
+    </div>
 </aside>

layouts/shortcodes/figure.html

@@ -1,4 +1,9 @@
-{{ $resource := $.Page.Resources.GetMatch (.Get "src") }}
+{{ $resource := "" }}
+{{ if .IsNamedParams }}
+    {{ $resource = $.Page.Resources.GetMatch (.Get "src") }}
+{{ else }}
+    {{ $resource = $.Page.Resources.GetMatch (.Get 0) }}
+{{ end }}
 
 {{ $noborder := false }}
 {{ if .Get "noborder" }}

layouts/shortcodes/see-also.html

@@ -0,0 +1,7 @@
+<div class="see-also">
+    {{ with .Site.GetPage (.Get 0) }}
+        <p>{{ i18n "see_also" }} <a href="{{ .Permalink }}">{{ .Title | markdownify }}</a></p>
+    {{ else }}
+        {{ errorf "Page could not be found for see-also shortcode: %s" .Position }}
+    {{ end }}
+</div>

layouts/shortcodes/table.html

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

layouts/tags/list.html

@@ -1,22 +0,0 @@
-{{ define "main" }}
-    <h1>
-        {{ partial "icon.html" "tag" }}
-        {{ .Title | markdownify }}
-    </h1>
-
-    <div class="tag-list">
-        {{ with .Data.Terms.Alphabetical }}
-            <ul>
-                {{ range . }}
-                    <a href="{{ .Page.Permalink }}">
-                        <li>{{ .Page.Title | markdownify }}</li>
-                    </a>
-                {{ end }}
-            </ul>
-        {{ else }}
-            <div>
-                {{ i18n "no_posts" }}
-            </div>
-        {{ end }}
-    </div>
-{{ end }}

layouts/tags/term.html

@@ -1,24 +0,0 @@
-{{ define "main" }}
-    <h1>
-        {{ partial "icon.html" "tag" }}
-        {{ .Title | markdownify }}
-        {{ partial "rss-link.html" . }}
-    </h1>
-
-    {{ partial "description-or-summary.html" . }}
-    <div class="page-list">
-        {{ with .Paginator.Pages }}
-            <ul>
-                {{ range . }}
-                    <li>{{ .Render "summary/post" }}</li>
-                {{ end }}
-            </ul>
-        {{ else }}
-            <div>
-                {{ i18n "no_posts" }}
-            </div>
-        {{ end }}
-    </div>
-
-    {{ partial "pagination.html" . }}
-{{ end }}

layouts/taxonomy/list.html

@@ -2,6 +2,8 @@
     <h1>
         {{ if eq .Data.Singular "tag" }}
             {{ partial "icon.html" "tag" }}
+        {{ else if eq .Data.Singular "category" }}
+            {{ partial "icon.html" "folder" }}
         {{ else }}
             {{ partial "icon.html" "filter" }}
         {{ end }}
@@ -9,13 +11,21 @@
         {{ .Title | markdownify }}
     </h1>
 
-    <div class="taxonomy">
+    <div class="taxonomy-list">
         {{ with .Data.Terms.Alphabetical }}
             <ul>
                 {{ range . }}
-                    <li>
-                        <a href="{{ .Page.Permalink }}">{{ .Page.Title | markdownify }}</a>
-                    </li>
+                    {{ with .Page }}
+                        <li>
+                            <div class="taxonomy-list-left">
+                                <a href="{{ .Permalink }}">
+                                    <p>{{ .Title | markdownify }}</p>
+                                </a>
+                                {{ partial "post-metadata/taxonomy.html" . }}
+                            </div>
+                            {{ partial "description-or-summary.html" . }}
+                        </li>
+                    {{ end }}
                 {{ end }}
             </ul>
         {{ else }}

layouts/taxonomy/term.html

@@ -2,6 +2,8 @@
     <h1>
         {{ if eq .Data.Singular "tag" }}
             {{ partial "icon.html" "tag" }}
+        {{ else if eq .Data.Singular "category" }}
+            {{ partial "icon.html" "folder" }}
         {{ else }}
             {{ partial "icon.html" "filter" }}
         {{ end }}
@@ -10,20 +12,13 @@
         {{ partial "rss-link.html" . }}
     </h1>
 
-    {{ partial "description-or-summary.html" . }}
-    <div class="page-list">
-        {{ with .Paginator.Pages }}
-            <ul>
-                {{ range . }}
-                    <li>{{ .Render "summary/post" }}</li>
-                {{ end }}
-            </ul>
-        {{ else }}
-            <div>
-                {{ i18n "no_posts" }}
-            </div>
-        {{ end }}
-    </div>
+    {{ partial "post-metadata/taxonomy.html" . }}
+
+    {{ with .Content }}
+        {{ . }}
+    {{ end }}
+
+    {{ partial "page-list.html" .Paginator.Pages }}
 
     {{ partial "pagination.html" . }}
 {{ end }}