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
94 lines
3.1 KiB
Markdown
94 lines
3.1 KiB
Markdown
---
|
|
title: Link Rendering Test
|
|
date: 2026-04-10T11:40:06+08:00
|
|
collections:
|
|
- Tests
|
|
categories:
|
|
- Markdown
|
|
tags:
|
|
- Link
|
|
link:
|
|
guard:
|
|
enable: true
|
|
# mode: redirect
|
|
allow_domains:
|
|
- demo.fixit.lruihao.cn
|
|
---
|
|
|
|
This post validates link rendering paths in FixIt, including Markdown render hook and link shortcode modes.
|
|
|
|
<!--more-->
|
|
|
|
## Markdown Render Hook (Regular Link)
|
|
|
|
These links are rendered by `layouts/_markup/render-link.html` and should always produce regular links.
|
|
|
|
- Internal relative link: [Task list test](/test/units/task-list-test/)
|
|
- Internal anchor link: [Jump to Card Link section](#card-link-shortcode)
|
|
- Absolute same-site link: [Test site home](http://demo.fixit.lruihao.cn/test/)
|
|
- External HTTP link: [FixIt Repository](https://github.com/hugo-fixit/FixIt)
|
|
- Mail link: [Email test](mailto:test@gmail.com)
|
|
- JavaScript link: [JavaScript test](javascript:void(0))
|
|
- Tel link: [Phone test](tel:+1234567890)
|
|
- File link: [File test](file:///path/to/file.txt)
|
|
- Data link: [Data URI test](data:text/plain;base64,SGVsbG8sIFdvcmxkIQ==)
|
|
|
|
### Title Attribute (Markdown)
|
|
|
|
[External link with title](https://google.com "Example Title")
|
|
|
|
## Link Shortcode (Regular)
|
|
|
|
### Named parameters
|
|
|
|
{{< link href="https://github.com/hugo-fixit/FixIt" content="GitHub via shortcode" title="GitHub title" >}}
|
|
|
|
{{< link href="/test/units/codeblock-test/" content="Internal shortcode link" class="shortcode-link-test" >}}
|
|
|
|
{{< link href="https://google.com" content="Custom rel + no noreferrer" rel="ugc" noreferrer=false >}}
|
|
|
|
{{< link href="/images/fixit.svg" content="Download local file" download="fixit.svg" >}}
|
|
|
|
### Positional parameters
|
|
|
|
{{< link "https://mozilla.org" "Positional regular link" "Positional title" >}}
|
|
|
|
## Card Link Shortcode
|
|
|
|
### Basic card
|
|
|
|
{{< link href="https://fixit.lruihao.cn" content="FixIt Documentation" card=true >}}
|
|
|
|
### Card with custom icon class
|
|
|
|
{{< link href="https://github.com/hugo-fixit/FixIt" content="FixIt on GitHub" card=true card-icon="fa-brands fa-github" >}}
|
|
|
|
### Card with custom image icon
|
|
|
|
{{< link href="https://gohugo.io" content="Hugo Official Site" card=true card-icon="/images/hugo.svg" >}}
|
|
|
|
### Card with download state
|
|
|
|
{{< link href="/images/fixit.svg" content="Download as card" card=true download="fixit.svg" >}}
|
|
|
|
### Positional card parameters
|
|
|
|
{{< link "https://google.com" "Positional card link" "" true "fa-solid fa-link" >}}
|
|
|
|
## Edge Cases
|
|
|
|
- URL with query string:
|
|
[Search query test](https://google.com/search?q=fixit&lang=en)
|
|
- URL with fragment:
|
|
[Fragment test](https://google.com/docs#installation)
|
|
- Long URL display (card meta should trim protocol automatically):
|
|
{{< link href="https://google.com/a/very/long/path/for/testing/card/url/display?foo=bar&baz=qux" content="Long URL card" card=true >}}
|
|
|
|
## Manual Verification Checklist
|
|
|
|
- Regular Markdown external links include external behavior and icon policy.
|
|
- Internal links are not treated as external.
|
|
- Shortcode card links render `.card-link` structure and card meta URL.
|
|
- `download` shows download icon/state in both regular and card modes.
|
|
- `noreferrer=false` removes `noopener noreferrer` from generated rel values.
|