mirror of
https://github.com/hugo-fixit/FixIt.git
synced 2026-08-24 23:38:56 +00:00
Cell
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
90 lines
3.2 KiB
HTML
90 lines
3.2 KiB
HTML
{{- /*
|
|
Recursive function to render tree from structured data
|
|
@param {Array} items - Array of tree items
|
|
@param {Int} level - The expand level of the tree (expand all: -1, collapse all: 0)
|
|
@param {Int} [depth=0] - Current depth level
|
|
@param {Boolean} [folder_slash=false] - Whether to append a trailing "/" to folder names
|
|
@param {Array} [ignore_list] - List of file or folder names to ignore
|
|
@param {Array} [highlight_list] - List of file or folder names to highlight
|
|
|
|
File tree item structure:
|
|
name: string - The name of the file or folder
|
|
type: string - Type of item, either "dir" (directory) or "file"
|
|
children?: array - (Optional) Array of child items, only valid for directories
|
|
*/ -}}
|
|
{{- define "render-file-tree" -}}
|
|
{{- $items := .items -}}
|
|
{{- $level := .level -}}
|
|
{{- $depth := .depth | default 0 -}}
|
|
{{- $folderSlash := .folder_slash | default false -}}
|
|
{{- $ignoreList := .ignore_list | default slice -}}
|
|
{{- $highlightList := .highlight_list | default slice -}}
|
|
|
|
<ul class="file-tree" data-level="{{ $depth }}">
|
|
{{- /* Sort items: directories first, then files */ -}}
|
|
{{- $dirItems := slice -}}
|
|
{{- $fileItems := slice -}}
|
|
{{- range $items -}}
|
|
{{- if in $ignoreList .name -}}
|
|
{{- continue -}}
|
|
{{- end -}}
|
|
{{- if eq .type "dir" -}}
|
|
{{- $dirItems = $dirItems | append . -}}
|
|
{{- else -}}
|
|
{{- $fileItems = $fileItems | append . -}}
|
|
{{- end -}}
|
|
{{- end -}}
|
|
|
|
{{- range (append $fileItems $dirItems) -}}
|
|
{{- $isDir := eq .type "dir" -}}
|
|
{{- $isCollapsed := $isDir | and (ge $depth $level) | and (ge $level 0) -}}
|
|
{{- $isHighlighted := in $highlightList .name -}}
|
|
{{- $label := .name -}}
|
|
{{- if and $isDir $folderSlash -}}
|
|
{{- $label = printf "%s/" $label -}}
|
|
{{- end -}}
|
|
|
|
<li class="file-tree-item{{ if $isDir }} file-tree-folder{{ end }}{{ if $isCollapsed }} is-collapsed{{ end }}">
|
|
<span class="file-tree-label{{ if $isDir }} file-tree-toggle{{ end }}{{ if $isHighlighted }} is-highlighted{{ end }}">
|
|
{{- $icon := "file-tree-icon fa-regular " -}}
|
|
{{- if $isDir -}}
|
|
{{- $icon = add $icon "fa-folder-open" -}}
|
|
{{- else -}}
|
|
{{- $icon = add $icon "fa-file-lines" -}}
|
|
{{- end -}}
|
|
{{- dict "Class" $icon | partial "plugin/icon.html" -}}
|
|
<span class="file-tree-label__inner">{{ $label }}</span>
|
|
</span>
|
|
|
|
{{- if and $isDir .children -}}
|
|
{{- $options := dict
|
|
"items" .children
|
|
"depth" (add $depth 1)
|
|
"level" $level
|
|
"folder_slash" $folderSlash
|
|
"ignore_list" $ignoreList
|
|
"highlight_list" $highlightList
|
|
-}}
|
|
{{- template "render-file-tree" $options -}}
|
|
{{- end -}}
|
|
</li>
|
|
{{- end -}}
|
|
</ul>
|
|
{{- end -}}
|
|
|
|
{{- if .items -}}
|
|
{{- $ignoreList := .ignore_list | default slice -}}
|
|
{{- $notEmpty := false -}}
|
|
{{- range .items -}}
|
|
{{- if not (in $ignoreList .name) -}}
|
|
{{- $notEmpty = true -}}
|
|
{{- break -}}
|
|
{{- end -}}
|
|
{{- end -}}
|
|
{{- if $notEmpty -}}
|
|
<div class="file-tree-wrapper">
|
|
{{- template "render-file-tree" . -}}
|
|
</div>
|
|
{{- end -}}
|
|
{{- end -}}
|