Files
marqdo/plugins/web/internal/render/chrome_brand.go
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

248 lines
6.0 KiB
Go
Executable File

package render
import (
"regexp"
"strings"
"unicode"
"unicode/utf8"
)
// formatMetaDate shortens ISO timestamps to YYYY-MM-DD for card/article meta.
func formatMetaDate(s string) string {
s = strings.TrimSpace(s)
if len(s) >= 10 && s[4] == '-' && s[7] == '-' {
if len(s) == 10 || s[10] == 'T' || s[10] == ' ' {
return s[:10]
}
}
return s
}
func navBrandSpec(page map[string]any) map[string]any {
if page == nil {
return nil
}
if b, ok := page["nav_brand"].(map[string]any); ok {
return b
}
return nil
}
func themeKeyOf(page map[string]any) string {
if b := navBrandSpec(page); b != nil {
if k := text(b["theme_key"]); k != "" {
return k
}
if k := text(b["主题键"]); k != "" {
return k
}
}
return "mq-theme"
}
func renderNavBrandHTML(page map[string]any) string {
b := navBrandSpec(page)
if b == nil {
return ""
}
title := text(b["title"])
if title == "" {
title = text(b["标题"])
}
if title == "" {
title = text(page["title"])
}
href := text(b["href"])
if href == "" {
href = text(b["链接"])
}
if href == "" {
href = "/"
}
logo := text(b["logo"])
if logo == "" {
logo = text(b["标志"])
}
var s strings.Builder
s.WriteString(`<a id="nav-brand" class="nav-brand" href="`)
s.WriteString(esc(href))
s.WriteString(`" aria-label="`)
s.WriteString(esc(title))
s.WriteString(`">`)
if logo != "" {
s.WriteString(`<img class="nav-brand-logo" src="`)
s.WriteString(esc(logo))
s.WriteString(`" alt="`)
s.WriteString(esc(title))
s.WriteString(`" width="36" height="36" decoding="async"/>`)
}
if title != "" {
s.WriteString(`<span class="nav-brand-text">`)
s.WriteString(esc(title))
s.WriteString(`</span>`)
}
s.WriteString(`</a>`)
s.WriteString(`<button type="button" id="nav-menu-toggle" class="nav-menu-toggle" aria-controls="site-side-drawer" aria-expanded="false" aria-label="打开目录">`)
s.WriteString(`<span class="nav-menu-bars" aria-hidden="true"><i></i><i></i><i></i></span>`)
s.WriteString(`<span class="nav-menu-label">目录</span></button>`)
return s.String()
}
func renderThemeToggleHTML(page map[string]any) string {
if navBrandSpec(page) == nil {
return ""
}
return `<button type="button" id="theme-toggle" class="theme-toggle on-dark" title="切换主题" aria-label="切换到浅色模式">浅色</button>`
}
func renderNavInner(page map[string]any, linksHTML string) string {
brand := renderNavBrandHTML(page)
toggle := renderThemeToggleHTML(page)
return brand + linksHTML + toggle
}
func chromeExtrasHTML(page map[string]any) string {
if navBrandSpec(page) == nil && pageClient(page) == nil {
return ""
}
return `<div id="qd-progress" aria-hidden="true"></div>` +
`<button type="button" id="nav-drawer-veil" class="nav-drawer-veil" aria-label="关闭目录" hidden></button>`
}
func pageClient(page map[string]any) map[string]any {
if page == nil {
return nil
}
if c, ok := page["client"].(map[string]any); ok {
return c
}
return nil
}
func themeBootScript(page map[string]any) string {
if navBrandSpec(page) == nil && pageClient(page) == nil {
return ""
}
key := themeKeyOf(page)
return `<script>(function(){try{var t=localStorage.getItem("` + key + `");` +
`if(t==="light"||t==="dark")document.documentElement.setAttribute("data-theme",t);` +
`else document.documentElement.setAttribute("data-theme","dark");` +
`}catch(e){document.documentElement.setAttribute("data-theme","dark");}})();</script>`
}
func clientEmbedScript(page map[string]any) string {
c := pageClient(page)
if c == nil {
return ""
}
source := text(c["source"])
if source == "" {
source = text(c["源"])
}
if source == "" {
return ""
}
bridge := text(c["bridge"])
if bridge == "" {
bridge = text(c["桥"])
}
if bridge == "" {
bridge = "/static/marqdo-bridge.js"
}
wasm := text(c["wasm"])
if wasm == "" {
wasm = "/static/marqdo_wasm.wasm"
}
ver := ""
if v, ok := page["asset_version"].(string); ok {
ver = strings.TrimSpace(v)
} else if v, ok := page["资源版本"].(string); ok {
ver = strings.TrimSpace(v)
}
if ver != "" {
bridge = withAssetQuery(bridge, ver)
wasm = withAssetQuery(wasm, ver)
source = withAssetQuery(source, ver)
}
return `<script type="module" src="` + esc(bridge) + `" data-mq-wasm="` + esc(wasm) +
`" data-mq-source-url="` + esc(source) + `"></script>`
}
func withAssetQuery(url, ver string) string {
if ver == "" || url == "" {
return url
}
if strings.Contains(url, "v=") {
return url
}
sep := "?"
if strings.Contains(url, "?") {
sep = "&"
}
return url + sep + "v=" + ver
}
var firstPBlockRe = regexp.MustCompile(`(?is)^(\s*)(<p\b[^>]*>)(.*?)(</p>)`)
func shouldDropcap(plain string) bool {
plain = strings.Join(strings.Fields(plain), "")
if plain == "" {
return false
}
if strings.HasPrefix(plain, "$$") {
return false
}
r, _ := utf8.DecodeRuneInString(plain)
if r == '$' || r == '\\' || r == '[' || r == '(' || unicode.IsDigit(r) {
return false
}
if unicode.In(r, unicode.Han) {
return true
}
return (r >= 'A' && r <= 'Z') || (r >= 'a' && r <= 'z')
}
func stripTags(s string) string {
var b strings.Builder
in := false
for _, r := range s {
switch {
case r == '<':
in = true
case r == '>':
in = false
case !in:
b.WriteRune(r)
}
}
return b.String()
}
// tuneDropcapHTML adds has-dropcap to the first eligible paragraph in article markdown HTML.
func tuneDropcapHTML(inner string) string {
m := firstPBlockRe.FindStringSubmatch(inner)
if m == nil {
return inner
}
plain := stripTags(m[3])
if !shouldDropcap(plain) {
return inner
}
open := m[2]
if strings.Contains(open, "has-dropcap") {
return inner
}
if strings.Contains(open, `class="`) {
open = strings.Replace(open, `class="`, `class="has-dropcap `, 1)
} else if strings.Contains(open, `class='`) {
open = strings.Replace(open, `class='`, `class='has-dropcap `, 1)
} else {
open = strings.TrimSuffix(open, ">") + ` class="has-dropcap">`
}
loc := firstPBlockRe.FindStringIndex(inner)
if loc == nil {
return inner
}
return inner[:loc[0]] + m[1] + open + m[3] + m[4] + inner[loc[1]:]
}