Merge branch 'markdown-output'

Add "View raw" button to page to view raw markdown code of page
Make markdown output "ugly"
2025-07-04 11:07:32 -05:00 · 2024-10-01 13:30:00 -05:00 · 2024-10-01 13:29:14 -05:00 · 2024-10-01 13:28:19 -05:00 · 2024-09-28 20:10:22 -05:00 · 2024-09-24 21:17:41 -05:00
7 changed files with 45 additions and 2 deletions
--- a/exampleSite/hugo.yaml
+++ b/exampleSite/hugo.yaml
@ -4,15 +4,23 @@ 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
+
+outputFormats:
+  _merge: deep
+
 params:
  author:
    name: bbaovanc
--- a/hugo.yaml
+++ b/hugo.yaml
@ -12,6 +12,15 @@ taxonomies:
  author: authors
  series: series

+outputs:
+  page:
+    - html
+    - markdown
+
+outputFormats:
+  markdown:
+    ugly: true
+
 privacy:
  googleAnalytics:
    disable: true
--- a/i18n/en.yaml
+++ b/i18n/en.yaml
@ -30,6 +30,9 @@ readingtime:
 edit_history:
  other: "Edit history"

+view_markdown:
+  other: "View raw"
+

 # Post count
 no_posts:
@ -67,6 +70,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"

--- a/layouts/_default/single.markdown.md
+++ b/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 -}}
--- a/layouts/partials/page-metadata/item/viewraw.html
+++ b/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 }}
--- a/layouts/partials/page-metadata/post-full.html
+++ b/layouts/partials/page-metadata/post-full.html
@ -20,7 +20,10 @@
        {{ 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/categories.html" . }}
+
        {{ partial "page-metadata/item/tags.html" . }}
    </div>
 {{ end }}
--- a/layouts/partials/seo-tags/twitter-cards.html
+++ b/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 }}
Author	SHA1	Message	Date
BBaoVanC	ddb57e0120	Merge branch 'markdown-output'	2024-10-01 13:30:00 -05:00
BBaoVanC	9b851ce0e4	Add "View raw" button to page to view raw markdown code of page	2024-10-01 13:29:14 -05:00
BBaoVanC	f34cffb849	Make markdown output "ugly" This makes it so, for example, `/blog/swapfile-guide` has markdown file at `/blog/swapfile-guide.md` instead of `/blog/swapfile-guide/index.md`.	2024-10-01 13:28:19 -05:00
BBaoVanC	91994df910	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	2024-09-28 20:10:22 -05:00
BBaoVanC	e84f334591	Replace paginate with pagination.pagerSize in hugo.yaml	2024-09-24 21:17:41 -05:00
BBaoVanC	ebf39263a6	Replace use of deprecated .Site.Social	2024-08-29 20:39:34 -05:00