mirror of
https://github.com/hugo-fixit/FixIt.git
synced 2026-08-24 15:28:57 +00:00
658f03d1e5
* refactor(params)!: snake_case config + eliminate params.page + use .Param
BREAKING CHANGE: All params keys renamed from camelCase to snake_case,
[params.page] section eliminated (moved to [params] level), and users
must update their hugo.toml and front matter accordingly.
Key changes:
- All camelCase config keys → snake_case (e.g., defaultTheme → default_theme)
- [params.page] flat keys and sub-sections moved to [params] level
- Removed function/params.html (manual merge), replaced with Hugo .Param
- New function/param.html partial for page-level section params with
shorthand boolean support and site defaults merging
- New function/camel-case.html for string conversion
- snake2camel.html renamed to camel-case-keys.html
- New function/get-cover.html for cover image resolution
- Deprecation warnings in detection-deprecated.html for old config keys
- Front matter only params (subtitle, featured_image, password, repost,
weight, message) use .Params.xxx instead of .Param
- Page-level sections use param.html partial
- Simplified patch.html (siteTime only) and init/index.html
Refs: camel-case-keys.html#29 (planned v1.0 breaking change)
* refactor(params)!: move params.link to page-level, simplify link guard
- Move [params.link] and [params.link.guard] to page-level section
- link.html: .Page optional, use param.html when available for
page-level override, fall back to site config without .Page
- Remove $guardConfig variable, use $config.guard directly
- Remove unnecessary .Page from callers that don't need page override
- friends.html: use param.html for link guard instead of link_guard
* refactor(params)!: move image/codeblock/json_viewer/filetree to page-level
- Move [params.image], [params.codeblock], [params.json_viewer],
[params.filetree] to page-level sub-sections
- Templates use param.html for merged config (page override + site defaults)
- image.html: .Page optional, falls back to site config without .Page
- Add v1- prefix to all deprecation warnidf IDs
- Fix camelCase key access in image.html (blackList, cacheRemote)
- Fix Hugo-lowered camelCase keys in code-block-wrapper.html
- Add deprecation warnings for codeblock camelCase Markdown attributes
- Add deprecation warnings for file-tree camelCase Markdown attributes
- Update render-codeblock-toggle.html for snake_case attribute names
* style: standardize @param comment style across all HTML templates
- PascalCase types: {string} → {String}, {boolean} → {Boolean},
{int} → {Int}, {map} → {Map}, {array} → {Array}
- Add missing ` - ` separator between param name and description
- Remove extra alignment spaces between type and param name
* refactor(params)!: move params.mermaid to page-level, extract gen/ templates
- Move [params.mermaid] to page-level sub-sections
- Mermaid config injected into window.config (per-page override support)
- mermaid.ts reads config from window.config.mermaid instead of parameter
- Create _partials/gen/ directory for JS content generators
- Move mermaid-bootstrap.html from plugin/ to gen/
- Extract window.config JS generation into gen/config.html
- mermaid.html uses param.html for wrapper config
* refactor(params)!: consolidate link_to_* into params.post_link section
- Move link_to_markdown/source/edit/report/vscode into [params.post_link]
- Rename keys: markdown, source, edit, report (bool), editor (string)
- editor defaults to "vscode", supports "trae" etc. via protocol template
- footer.html uses .Param "post_link" for all link toggles
- Remove link_to_* from deprecated keys list
* fix: add fallback for deprecated camelCase attributes and expand deprecation warnings
- render-codeblock-file-tree.html: folderSlash attribute fallback
- render-codeblock-toggle.html: lineNosToggler/lineWrapToggler fallback + warnings
- code-block-wrapper.html: maxShownLines/wrapperClass fallback
- detection-deprecated.html: add nested key warnings for 13 sections
(header, breadcrumb, navigation, watermark, busuanzi, image, mermaid,
codeblock, filetree, math.katex, math.mathjax.options, post_summary, footer)
- detection-deprecated.html: add link_guard front matter deprecation warning
* fix(mermaid): fix rendering in hidden tab panels and neutral layer scheduling
- isRenderContextActive: check tab-panel visibility via getBoundingClientRect
instead of panel.hidden (tab-container uses slot-based hiding, not hidden attr)
- bindTabContainerChanged: render neutral layers when switching tabs so
print/fallback scenarios work correctly
255 lines
13 KiB
HTML
255 lines
13 KiB
HTML
{{- define "title" -}}
|
|
{{- cond (.Param "capitalize_titles") (title .Title) .Title -}}
|
|
{{- if .Site.Params.with_site_title }} {{ .Site.Params.title_delimiter }} {{ .Site.Title }}{{- end -}}
|
|
{{- end -}}
|
|
|
|
{{- define "content" -}}
|
|
{{- $title := cond (.Param "capitalize_titles") (title .Title) .Title -}}
|
|
{{- $toc := dict "Page" . "Key" "toc" | partial "function/param.html" -}}
|
|
{{- $tableOfContents := .Fragments.ToHTML ($toc.start_level | int) ($toc.end_level | int) ($toc.ordered | default false) -}}
|
|
{{- $showToc := $toc.enable | and (ne $tableOfContents `<nav id="TableOfContents"></nav>`) -}}
|
|
{{- .Store.Set "showToc" $showToc -}}
|
|
{{- $tableOfContents = dict "Content" $tableOfContents "Ruby" (.Param "ruby") "Fraction" (.Param "fraction") "Fontawesome" (.Param "fontawesome") | partial "function/content.html" | safeHTML -}}
|
|
{{- $pagefindEnabled := and .Site.Params.search.enable (eq .Site.Params.search.type "pagefind") -}}
|
|
|
|
<aside class="aside-collection animate__animated animate__fadeIn animate__faster" aria-label="{{ T "collections" }}">
|
|
{{- /* Collection List */ -}}
|
|
{{- partial "single/collection-list.html" . -}}
|
|
|
|
{{- /* Related Content */ -}}
|
|
{{- partial "single/related-aside.html" . -}}
|
|
|
|
{{- /* Custom Aside */ -}}
|
|
{{- block "custom-aside" . }}{{ end -}}
|
|
</aside>
|
|
|
|
<article class="page single"{{ with .Params.fromAdapters }} data-adapters="{{ . }}"{{ end }}>
|
|
<div class="header">
|
|
{{- /* Title */ -}}
|
|
<h1 class="single-title animate__animated animate__flipInX"{{ if $pagefindEnabled }} data-pagefind-body{{ end }}>
|
|
{{- $repost := .Params.repost | default dict -}}
|
|
{{- with $repost -}}
|
|
{{- if eq .Enable true -}}
|
|
{{- $icon := dict "Class" "fa-solid fa-share" -}}
|
|
{{- $iconTitle := cond (hasPrefix .Url "http") (printf "%v -> %v" (T "single.repost") .Url ) (T "single.repost") -}}
|
|
{{- if hasPrefix .Url "http" -}}
|
|
{{ dict "Destination" .Url "Icon" $icon "Class" "icon-repost" "Title" $iconTitle "ExternalIcon" false | partial "plugin/link.html" -}}
|
|
{{- else -}}
|
|
<span title="{{ $iconTitle }}" class="icon-repost">{{- $icon | partial "plugin/icon.html" -}}</span>
|
|
{{- end -}}
|
|
{{- end -}}
|
|
{{- end -}}
|
|
<span>{{ $title }}</span>
|
|
</h1>
|
|
|
|
{{- /* Subtitle */ -}}
|
|
{{- with .Params.subtitle -}}<p class="single-subtitle animate__animated animate__fadeIn">{{ . | $.RenderString }}</p>{{- end -}}
|
|
</div>
|
|
|
|
{{- /* Meta */ -}}
|
|
<div class="post-meta">
|
|
<div class="post-meta-line">
|
|
{{- partial "single/post-author.html" . -}}
|
|
{{- partial "single/post-included-in.html" . -}}
|
|
</div>
|
|
{{- /* TODO add disclaimer or space between meta and content */ -}}
|
|
<div class="post-meta-line">
|
|
{{- with .PublishDate | dateFormat (.Site.Params.date_format | default "2006-01-02") -}}
|
|
<span title="{{ dict "Date" ("2006-01-02 15:04:05" | $.PublishDate.Format) | T "single.publishedOnDate" }}">
|
|
{{- dict "Class" "fa-solid fa-calendar-days me-1" | partial "plugin/icon.html" -}}
|
|
{{- printf `<time datetime="%v">%v</time>` . . | safeHTML -}}
|
|
</span>
|
|
{{- end -}}
|
|
{{- if (ne .Lastmod.Unix .PublishDate.Unix) | and (.Param "show_lastmod") -}}
|
|
{{- with .Lastmod | dateFormat (.Site.Params.date_format | default "2006-01-02") -}}
|
|
<span title="{{ dict "Date" ("2006-01-02 15:04:05" | $.Lastmod.Format) | T "single.updatedOnDate" }}">
|
|
{{- dict "Class" "fa-regular fa-calendar-check me-1" | partial "plugin/icon.html" -}}
|
|
{{- printf `<time datetime="%v">%v</time>` . . | safeHTML -}}
|
|
</span>
|
|
{{- end -}}
|
|
{{- end -}}
|
|
{{- if .Param "word_count" -}}
|
|
<span title="{{ T "single.wordCount" .WordCount }}">
|
|
{{- dict "Class" "fa-solid fa-pencil-alt me-1" | partial "plugin/icon.html" -}}
|
|
{{- T "single.fuzzyWordCount" .FuzzyWordCount -}}
|
|
</span>
|
|
{{- end -}}
|
|
{{- if .Param "reading_time" -}}
|
|
<span>
|
|
{{- dict "Class" "fa-regular fa-clock me-1" | partial "plugin/icon.html" -}}
|
|
{{- T "single.readingTime" .ReadingTime -}}
|
|
</span>
|
|
{{- end -}}
|
|
|
|
{{- /* If the article expires, close the comment or not */ -}}
|
|
{{- $expirationReminder := dict "Page" . "Key" "expiration_reminder" | partial "function/param.html" | default dict -}}
|
|
{{- if
|
|
$expirationReminder.enable
|
|
| and (gt (div (sub now.Unix .Lastmod.Unix) 86400) ($expirationReminder.warning | default 180))
|
|
| and $expirationReminder.close_comment -}}
|
|
{{- .Store.Set "commentExpired" true -}}
|
|
{{- end -}}
|
|
{{- $comment := .Store.Get "comment" | default dict -}}
|
|
{{- $visitorIcon := dict "Class" "fa-regular fa-eye me-1" | partial "plugin/icon.html" -}}
|
|
{{- $commentIcon := dict "Class" "fa-regular fa-comments me-1" | partial "plugin/icon.html" -}}
|
|
{{- /* Visitor Count */ -}}
|
|
{{- if $comment.enable | and $comment.artalk.enable -}}
|
|
<span class="comment-visitors" data-flag-title="{{ $title }}">
|
|
{{- $visitorIcon }}<span class="artalk-visitor-count" data-page-key="{{ .RelPermalink }}">-</span> {{ T "single.views" }}
|
|
</span>
|
|
{{- else if $comment.enable | and $comment.valine.enable | and $comment.valine.visitor -}}
|
|
<span id="{{ .RelPermalink }}" class="leancloud_visitors comment-visitors" data-flag-title="{{ $title }}">
|
|
{{- $visitorIcon }}<span class="leancloud-visitors-count">-</span> {{ T "single.views" }}
|
|
</span>
|
|
{{- else if $comment.enable | and $comment.waline.enable | and $comment.waline.pageview -}}
|
|
<span class="comment-visitors" data-flag-title="{{ $title }}">
|
|
{{- $visitorIcon }}<span data-path="{{ .RelPermalink }}" class="waline-pageview-count">-</span> {{ T "single.views" }}
|
|
</span>
|
|
{{- else if $comment.enable | and $comment.twikoo.enable | and $comment.twikoo.visitor -}}
|
|
<span id="{{ .RelPermalink }}" class="comment-visitors" data-flag-title="{{ $title }}">
|
|
{{- $visitorIcon }}<span id="twikoo_visitors">-</span> {{ T "single.views" }}
|
|
</span>
|
|
{{- else if .Site.Params.busuanzi.enable | and .Site.Params.busuanzi.page_views | and hugo.IsProduction -}}
|
|
<span id="busuanzi_container_page_pv" class="busuanzi_visitors comment-visitors" data-flag-title="{{ $title }}">
|
|
{{- $visitorIcon }}<span id="busuanzi_value_page_pv">-</span> {{ T "single.views" }}
|
|
</span>
|
|
{{- end -}}
|
|
{{- /* Comment Count */ -}}
|
|
{{- if $comment.enable -}}
|
|
{{- if $comment.artalk.enable -}}
|
|
<span class="comment-count" data-flag-title="{{ $title }}">
|
|
{{ $commentIcon }}<span class="artalk-comment-count" data-page-key="{{ .RelPermalink }}">-</span> {{ T "single.comments" }}
|
|
</span>
|
|
{{- else if $comment.valine.enable | and $comment.valine.commentCount -}}
|
|
<span class="comment-count" data-flag-title="{{ $title }}">
|
|
{{ $commentIcon }}<span data-xid="{{ .RelPermalink }}" class="valine-comment-count">-</span> {{ T "single.comments" }}
|
|
</span>
|
|
{{- else if $comment.waline.enable | and $comment.waline.comment -}}
|
|
<span class="comment-count" data-flag-title="{{ $title }}">
|
|
{{ $commentIcon }}<span data-path="{{ .RelPermalink }}" class="waline-comment-count">-</span> {{ T "single.comments" }}
|
|
</span>
|
|
{{- else if $comment.twikoo.enable | and $comment.twikoo.commentCount -}}
|
|
<span id="{{ .RelPermalink }}" class="comment-count" data-flag-title="{{ $title }}">
|
|
{{ $commentIcon }}<span id="twikoo-comment-count">-</span> {{ T "single.comments" }}
|
|
</span>
|
|
{{- end -}}
|
|
{{- end -}}
|
|
</div>
|
|
</div>
|
|
|
|
{{- /* Featured image */ -}}
|
|
{{- $cover := dict "Page" . | partial "function/get-cover.html" -}}
|
|
{{- if $cover.Source | or (gt (len $cover.Matches) 0) -}}
|
|
<div class="featured-image">
|
|
{{- $optim := slice
|
|
(dict "Process" "resize 800x webp" "descriptor" "800w")
|
|
(dict "Process" "resize 1200x webp" "descriptor" "1200w")
|
|
(dict "Process" "resize 1600x webp" "descriptor" "1600w")
|
|
-}}
|
|
{{- dict "Src" $cover.Source "Title" $.Description "Resources" $.Resources "Matches" $cover.Matches "Loading" "eager" "Sizes" "(max-width: 679.9px) 100vw, (max-width: 959.9px) 80vw, (max-width: 1439.9px) 56vw, 800px" "OptimConfig" $optim | partial "plugin/image.html" -}}
|
|
</div>
|
|
{{- end -}}
|
|
|
|
{{- /* Static TOC */ -}}
|
|
{{- if $showToc -}}
|
|
<div class="details toc{{ with .Params.password }} encrypted-hidden{{ end }}" id="toc-static" data-kept="{{ if $toc.keep_static }}true{{ else }}false{{ end }}">
|
|
<div class="details-summary toc-title">
|
|
<span>{{ T "single.contents" }}</span>
|
|
<span>{{ dict "Class" "details-icon fa-solid fa-angle-right" | partial "plugin/icon.html" }}</span>
|
|
</div>
|
|
<div class="details-content toc-content" id="toc-content-static">
|
|
{{- $tableOfContents -}}
|
|
</div>
|
|
</div>
|
|
{{- end -}}
|
|
|
|
{{- /* AI Summary */ -}}
|
|
{{- $summaryConfig := dict "Page" . "Key" "post_summary" | partial "function/param.html" -}}
|
|
{{- if $summaryConfig.enable -}}
|
|
<div class="ai-summary"></div>
|
|
{{- end -}}
|
|
|
|
{{- /* Custom block before post content */ -}}
|
|
{{- block "custom-post__content:before" . }}{{ end -}}
|
|
|
|
{{- /* Expiration Reminder */ -}}
|
|
{{- partial "single/expiration-reminder.html" . -}}
|
|
|
|
{{- /* Content */ -}}
|
|
{{- $content := dict "Content" .Content "Ruby" (.Param "ruby") "Fraction" (.Param "fraction") "Fontawesome" (.Param "fontawesome") | partial "function/content.html" | safeHTML -}}
|
|
<div class="content" id="content"{{ if $pagefindEnabled }} data-pagefind-body{{ end }}{{ with .Param "end_flag" }} data-end-flag="{{ . }}"{{ end }}>
|
|
{{- if not .Params.password -}}
|
|
{{- $content -}}
|
|
{{- end -}}
|
|
</div>
|
|
|
|
{{- /* Custom block after post content */ -}}
|
|
{{- block "custom-post__content:after" . }}{{ end -}}
|
|
|
|
{{- /* Related Content */ -}}
|
|
{{- partial "single/related.html" . -}}
|
|
|
|
{{- /* Reward before Footer */ -}}
|
|
{{- $reward := dict "Page" . "Key" "reward" | partial "function/param.html" -}}
|
|
{{- if eq $reward.position "before" -}}
|
|
{{- partial "single/reward.html" . -}}
|
|
{{- end -}}
|
|
|
|
{{- /* Content Encryption */ -}}
|
|
{{- dict "Content" $content "Password" .Params.password "Message" .Params.message "Page" . | partial "plugin/fixit-encryptor.html" -}}
|
|
|
|
{{- /* Collection Navigation */ -}}
|
|
{{- partial "single/collection-nav.html" . -}}
|
|
|
|
{{- /* Custom block before post footer */ -}}
|
|
{{- block "custom-post__footer:before" . }}{{ end -}}
|
|
|
|
{{- /* Footer */ -}}
|
|
{{- partial "single/footer.html" . -}}
|
|
|
|
{{- /* Reward after post footer */ -}}
|
|
{{- if eq $reward.position "after" -}}
|
|
{{- partial "single/reward.html" . -}}
|
|
{{- end -}}
|
|
|
|
{{- /* Custom block after post footer */ -}}
|
|
{{- block "custom-post__footer:after" . }}{{ end -}}
|
|
</article>
|
|
|
|
<aside class="toc" id="toc-auto" aria-label="{{ T "single.contents" }}">
|
|
{{- /* Custom block before post toc */ -}}
|
|
{{- block "custom-post__toc:before" . }}{{ end -}}
|
|
|
|
{{- /* Auto TOC */ -}}
|
|
{{- if $showToc -}}
|
|
<h2 class="toc-title{{ with .Params.password }} encrypted-hidden{{ end }}">
|
|
{{- T "single.contents" -}}
|
|
{{- dict "Class" "toc-icon fa-solid fa-angle-down" | partial "plugin/icon.html" -}}
|
|
</h2>
|
|
<div class="toc-content{{ if eq $toc.auto false }} always-active{{ end }}{{ with .Params.password }} encrypted-hidden{{ end }}" id="toc-content-auto"></div>
|
|
{{- end -}}
|
|
|
|
{{- /* Custom block after post toc */ -}}
|
|
{{- block "custom-post__toc:after" . }}{{ end -}}
|
|
</aside>
|
|
|
|
{{- /* TOC Dialog */ -}}
|
|
{{- if $showToc -}}
|
|
<dialog id="toc-dialog" aria-labelledby="toc-dialog-title" closedby="any">
|
|
<button type="button" class="toc-close-btn" aria-label="Close Table of Contents">
|
|
{{- dict "Class" "fa-solid fa-xmark fa-lg" | partial "plugin/icon.html" -}}
|
|
</button>
|
|
<div class="toc">
|
|
<h2 class="toc-title" id="toc-dialog-title">{{ T "single.contents" }}</h2>
|
|
<div class="toc-content" id="toc-content-drawer">
|
|
{{- replace $tableOfContents `id="TableOfContents"` "" | safeHTML -}}
|
|
</div>
|
|
</div>
|
|
</dialog>
|
|
{{- end -}}
|
|
{{- end -}}
|
|
|
|
{{- define "comments" -}}
|
|
{{- partial "base/comment.html" . -}}
|
|
{{- end -}}
|