migrate to decoupled Blowfish layout, fix TOC scrollspy, and update docs

- Theme Decoupling & Cleanup:
      - Fully decoupled and vendored the Blowfish theme directly into root directories (layouts/,
  assets/, static/, data/, i18n/).
      - De-registered and cleaned up legacy Git submodules (themes/blowfish, themes/hugo-admonitions)
  from the Git index to protect the build from upstream breakages.
      - Configured .gitignore to ignore development preview symlinks (content, static,
  config/_default/menus.en.toml), build folders (public/, resources/), and locks.

    - TOC & Layout Fixes:
      - Replaced the custom layouts/_default/single.html template with the Blowfish default to restore
  native container widths and the side-by-side flex layout.
      - Restored TOC to float on the right sidebar on desktop viewports and render inline on mobile
  viewports.
      - Fixed a parameter resolution bug in layouts/partials/toc.html by checking both .Site.Params.
  smartTOC and .Site.Params.article.smartTOC (where it is defined in params.toml).
      - Upgraded the TOC scrollspy JavaScript to target all '#TableOfContents' containers on the page,
  enabling highlight tracking on both desktop and mobile layouts.

    - Documentation Updates (README.md):
      - Restored YAML front matter metadata block at the top.
      - Added detailed notes on the CI/CD build process and Gitea runner deployment targets
  (/srv/www/docs-public and /srv/www/docs-private).
      - Added a categorized and sorted "Shortcodes Quick Reference" table at the top of the shortcodes
  section (ordered by Custom, Hugo Default, and Blowfish).
      - Documented custom shortcodes (Include, Screenshot, Raw HTML) and missing Hugo default
  shortcodes (Highlight, Instagram, Param, Ref, Relref, Twitter, Vimeo, Youtube).
      - Restructured headings to ensure all sub-shortcodes are H3, removed block break tags (<br/>),
  and appended horizontal separators (---) after H2 sections.

layouts/partials/meta/date-updated.html

@@ -0,0 +1,4 @@
+<time datetime="{{ . | time.Format "2006-01-02T15:04:05-07:00" }}">
+  {{- i18n "article.date_updated" (dict "Date" (partial "functions/date.html" .)) -}}
+</time>
+{{- /* Trim EOF */ -}}

layouts/partials/meta/date.html

@@ -0,0 +1,4 @@
+<time datetime="{{ . | time.Format "2006-01-02T15:04:05-07:00" }}">
+  {{- i18n "article.date" (dict "Date" (partial "functions/date.html" .)) -}}
+</time>
+{{- /* Trim EOF */ -}}

layouts/partials/meta/edit.html

@@ -0,0 +1,19 @@
+{{ $url := .Params.editURL | default (.Site.Params.article.editURL | default "#") }}
+{{ $slash := "" }}
+{{ if .Params.editAppendPath | default ( .Site.Params.article.editAppendPath | default false ) }}
+  {{ if ne (substr $url -1 1) "/" }}
+    {{ $slash = "/" }}
+  {{ end }}
+  {{ $url = printf "%s%s%s" $url $slash (path.Join .File.Path) }}
+{{ end }}
+<span class="mb-[2px]">
+  <a
+    href="{{ $url }}"
+    class="text-lg hover:text-primary-500"
+    rel="noopener noreferrer"
+    target="_blank"
+    title="{{ i18n "article.edit_title" }}"
+    ><span class="inline-block align-text-bottom">{{ partial "icon.html" "edit" }}</span></a
+  >
+</span>
+{{- /* Trim EOF */ -}}

layouts/partials/meta/likes.html

@@ -0,0 +1,25 @@
+<span>
+  {{ $id := "null" }}
+  {{ if eq .Kind "taxonomy" }}
+    {{ $id = delimit (slice "likes_taxonomy_" .Page.Data.Plural) "" }}
+  {{ else if eq .Kind "term" }}
+    {{ $id = delimit (slice "likes_term_" .Page.Data.Term) "" }}
+  {{ else }}
+    {{ $translations := .AllTranslations }}
+    {{ with .File }}
+      {{ $path := .Path }}
+      {{ range $translations }}
+        {{ $lang := print "." .Language.Name ".md" }}
+        {{ $path = replace $path $lang ".md" }}
+      {{ end }}
+      {{ $id = delimit (slice "likes_" $path) "" }}
+    {{ end }}
+  {{ end }}
+  <span
+    id="{{ $id }}"
+    class="animate-pulse inline-block text-transparent max-h-3 rounded-full -mt-[2px] align-middle bg-neutral-300 dark:bg-neutral-400"
+    title="likes"
+    >loading</span
+  >
+  <span class="inline-block align-text-bottom">{{ partial "icon.html" "heart" }}</span>
+</span>

layouts/partials/meta/likes_button.html

@@ -0,0 +1,14 @@
+<span>
+  <button
+    id="button_likes"
+    class="rounded-md border border-primary-400 px-1 py-[1px] text-xs font-normal text-primary-700 dark:border-primary-600 dark:text-primary-400">
+    <span id="button_likes_heart" class="inline-block align-text-bottom hidden"
+      >{{ partial "icon.html" "heart" }}
+    </span>
+    <span id="button_likes_emtpty_heart" class="inline-block align-text-bottom"
+      >{{ partial "icon.html" "heart-empty" }}</span
+    >
+    <span id="button_likes_text">&nbsp;Like</span>
+  </button>
+</span>
+{{- /* Trim EOF */ -}}

layouts/partials/meta/reading-time.html

@@ -0,0 +1,4 @@
+<span title="{{ i18n "article.reading_time_title" }}">
+  {{- i18n "article.reading_time" .ReadingTime | markdownify | emojify -}}
+</span>
+{{- /* Trim EOF */ -}}

layouts/partials/meta/views.html

@@ -0,0 +1,25 @@
+<span>
+  {{ $id := "null" }}
+  {{ if eq .Kind "taxonomy" }}
+    {{ $id = delimit (slice "views_taxonomy_" .Page.Data.Plural) "" }}
+  {{ else if eq .Kind "term" }}
+    {{ $id = delimit (slice "views_term_" .Page.Data.Term) "" }}
+  {{ else }}
+    {{ $translations := .AllTranslations }}
+    {{ with .File }}
+      {{ $path := .Path }}
+      {{ range $translations }}
+        {{ $lang := print "." .Language.Name ".md" }}
+        {{ $path = replace $path $lang ".md" }}
+      {{ end }}
+      {{ $id = delimit (slice "views_" $path) "" }}
+    {{ end }}
+  {{ end }}
+  <span
+    id="{{ $id }}"
+    class="animate-pulse inline-block text-transparent max-h-3 rounded-full -mt-[2px] align-middle bg-neutral-300 dark:bg-neutral-400"
+    title="views"
+    >loading</span
+  >
+  <span class="inline-block align-text-bottom">{{ partial "icon.html" "eye" }}</span>
+</span>

layouts/partials/meta/word-count.html

@@ -0,0 +1,4 @@
+<span>
+  {{- i18n "article.word_count" .WordCount | markdownify -}}
+</span>
+{{- /* Trim EOF */ -}}

layouts/partials/meta/zen-mode.html

@@ -0,0 +1,10 @@
+<span class="mb-[2px]">
+  <span
+    id="zen-mode-button"
+    class="text-lg hover:text-primary-500"
+    title="{{ i18n "article.zen_mode_title.enable" }}"
+    data-title-i18n-disable="{{ i18n "article.zen_mode_title.enable" }}"
+    data-title-i18n-enable="{{ i18n "article.zen_mode_title.disable" }}">
+    <span class="inline-block align-text-bottom">{{ partial "icon.html" "expand" }}</span>
+  </span>
+</span>