Create markdown output template

Further progress is blocked by Hugo feature requests:

- https://discourse.gohugo.io/t/render-alternative-output-format-outside-of-leaf-bundle-subdirectory/46968
- https://github.com/gohugoio/hugo/issues/8927

assets/css/bobastyle.css

@@ -641,7 +641,7 @@ h1 svg.icon {
 /* Content (single) formatting {{{ */
 
 .series-box {
-  background-color: var(--background-1); /* remember to update print styling */
+  background-color: var(--background-1);
   color: var(--text-1);
   padding: 8px 16px;
   border-radius: 8px;
@@ -649,7 +649,7 @@ h1 svg.icon {
 }
 
 .table-of-contents {
-  background-color: var(--background-1); /* remember to update print styling */
+  background-color: var(--background-1);
   color: var(--text-1);
   padding: 8px 20px;
   border-radius: 8px;
@@ -704,7 +704,7 @@ h1 svg.icon {
 
 /* See also formating */
 .see-also {
-  background-color: var(--background-1); /* remember to update print styling */
+  background-color: var(--background-1);
   color: var(--text-1);
   padding: 8px 12px;
   border-radius: 8px;
@@ -770,14 +770,14 @@ h1 svg.icon {
   display: flex;
   flex-direction: column;
   margin: 16px 0;
-  background-color: var(--background-1); /* remember to update print styling */
+  background-color: var(--background-1);
   border-radius: 8px;
 }
 .code-block > .code-header {
   display: flex;
   flex-direction: row;
   justify-content: space-between;
-  background-color: var(--background-2); /* remember to update print styling */
+  background-color: var(--background-2);
   padding: 4px 8px;
   border-top-left-radius: 8px;
   border-top-right-radius: 8px;
@@ -857,7 +857,6 @@ aside {
   margin-bottom: 0;
 }
 
-/* remember to update print styling for all the following asides */
 aside.note {
   background-color: var(--background-blue-1);
 }
@@ -973,19 +972,6 @@ aside.quote {
   .table-of-contents.print {
     display: block;
   }
-
-  /* replace background colors with borders {{{ */
-  .series-box {
-  }
-  .table-of-contents {
-  }
-  .see-also {
-  }
-  .code-block {
-  }
-  .code-block > .code-header {
-  }
-  /* all the asides */
 }
 
 /* }}} */

exampleSite/hugo.yaml

@@ -4,15 +4,20 @@ 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
 
+pagination:
+  pagerSize: 5
+
 taxonomies:
   _merge: deep
 
 markup: # this just keeps the bobatheme markup styling
   _merge: deep
 
+outputs:
+  _merge: deep
+
 params:
   author:
     name: bbaovanc

hugo.yaml

@@ -12,6 +12,11 @@ taxonomies:
   author: authors
   series: series
 
+outputs:
+  page:
+    - html
+    - markdown
+
 privacy:
   googleAnalytics:
     disable: true

layouts/_default/single.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/seo-tags/twitter-cards.html

@@ -24,6 +24,6 @@
 <meta name="twitter:title" content="{{ .Title | plainify }}">
 <meta name="twitter:description" content="{{ (partial "seo-description.html" .) | plainify }}">
 
-{{ with .Site.Social.twitter }}
+{{ with .Site.Params.social.twitter }}
     <meta name="twitter:site" content="@{{ . }}">
 {{ end }}