diff --git a/README.md b/README.md index ee9824f..744999b 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,10 @@ - 文章页结构化数据（Schema.org `BlogPosting` JSON-LD）与社交分享标签（canonical / Open Graph / Twitter Card），均可在主题设置中关闭 - 内置搜索按钮（依赖官方 `PluginSearchWidget` 插件，未安装则不显示） - 阅读进度条、代码块复制、相对时间、回到顶部、移动端菜单等交互 +- **二级导航**：菜单项的子项自动渲染为下拉菜单（桌面端 hover/focus 展开，移动端嵌套缩进展开） +- **页脚可关闭的主题署名**：默认「Theme by 暖心向阳335」，可在设置中修改名称或整体关闭 +- **页脚全站数据统计**：文章 / 分类 / 标签 / 评论 / 访问量 / 字数，可按项开关，整体可关闭 +- **文章卡片字数 + 阅读时长**：可在设置中关闭（需 `halo-plugin-extra-api` 提供数据） - 多语言：`i18n/default.properties`（回退）+ `i18n/zh_CN.properties` - 提供 `layout.html` 布局契约，供使用布局契约的插件页面复用主题导航 / 页脚 / 暗色样式 @@ -26,6 +30,7 @@ - **plugin-links**：`/links` 友链页；友链申请表单已**直接内嵌**在友链页底部（点击「申请友链」展开，调用插件公共 REST API，含图形验证码）；并额外提供 - `links-subscribe.html`：RSS 订阅动态聚合页（使用 `linkFeedFinder`） - **halo-weread-plugin**：`weread.html` 微信读书书架页（前端拉取插件 `/shelf-html` 并注入） +- **plugin-douban**：`douban.html` 豆瓣收藏页（按「读过 / 在读 / 看过 / 在追」分栏展示书影音，使用 `doubanFinder.getMovies(...)`；未安装插件时显示提示）。在控制台新建单页并选择「豆瓣页面」模板即可启用 - **留言板**：`page_guestbook.html` 以评论区作为留言板的单页模板 - **plugin-extra-api**：API 扩展包（无独立页面），主题已适配其 shiki 代码高亮与暗色样式；并在文章卡片 / 详情页展示**字数 + 阅读时长**、归档页展示**全站总字数**、瞬间页展示**单条字数**（通过 `extraApiStatsFinder`，插件未安装时自动隐藏） @@ -50,6 +55,7 @@ src/ 源码目录（在此编辑） ├── js/post.ts 文章页脚本（代码复制 / 阅读进度） ├── index.html post.html page.html page_about.html ├── archives.html category.html tag.html categories.html tags.html author.html +├── weread.html douban.html links-subscribe.html page_guestbook.html └── i18n/ 多语言消息 theme.yaml 主题元数据（必填） settings.yaml 控制台主题设置表单 @@ -81,12 +87,18 @@ pnpm check # 格式化 + Lint 修复 | ------- | ------------------ | -------------------------------------------- | | basic | color_scheme | 默认配色：跟随系统 / 浅色 / 深色 | | basic | footer_copyright | 页脚自定义版权（支持 HTML，留空不显示） | +| basic | show_theme_credit | 页脚是否显示「Theme by」署名（默认开） | +| basic | theme_credit_text | 署名名称（默认「暖心向阳335」） | +| basic | show_word_count | 文章卡片是否显示字数与阅读时长（需 extra-api）| | featured| enable | 首页是否展示置顶文章 | | about | avatar / bio / github_url / twitter_url / contact_email | 关于页（自定义模板 `page_about.html`）内容 | | seo | enable_metadata | 输出 canonical / Open Graph / Twitter Card | | seo | enable_structured_data | 输出文章页 BlogPosting JSON-LD | | footer | icp_number / icp_url | ICP 备案号与查询链接（默认工信部备案管理系统） | | footer | police_number / police_url | 公网安备号与查询链接（默认全国互联网安全管理服务平台） | +| stats | enable | 页脚是否显示全站数据统计（默认关） | +| stats | show_posts / show_categories / show_tags / show_comments / show_visits | 各项统计的显隐开关 | +| stats | show_words | 全站总字数（需 extra-api 插件，默认开） | ## 约定与说明 diff --git a/i18n/default.properties b/i18n/default.properties index 792e37f..b34a90d 100644 --- a/i18n/default.properties +++ b/i18n/default.properties @@ -40,3 +40,10 @@ links.apply=Apply for link links.apply_sent=Application submitted, awaiting review. links.apply_failed=Submission failed, please check and retry. links.apply_captcha_failed=Captcha failed to load, please refresh. +stats.posts={0} posts +stats.categories={0} categories +stats.tags={0} tags +stats.comments={0} comments +stats.visits={0} visits +stats.words={0} words +douban.plugin_required=Douban plugin (plugin-douban) not detected. Please install and enable it, then set your Douban ID in the plugin settings. diff --git a/i18n/zh_CN.properties b/i18n/zh_CN.properties index f00e270..bd501c1 100644 --- a/i18n/zh_CN.properties +++ b/i18n/zh_CN.properties @@ -40,3 +40,10 @@ links.apply=申请友链 links.apply_sent=申请已提交，等待管理员审核。 links.apply_failed=提交失败，请检查信息后重试。 links.apply_captcha_failed=验证码加载失败，请刷新页面重试。 +stats.posts={0} 篇文章 +stats.categories={0} 个分类 +stats.tags={0} 个标签 +stats.comments={0} 条评论 +stats.visits={0} 次访问 +stats.words={0} 字 +douban.plugin_required=未检测到豆瓣插件（plugin-douban），请安装并启用后在插件设置中填写豆瓣 ID。 diff --git a/settings.yaml b/settings.yaml index 95ba5c7..f6a8be4 100644 --- a/settings.yaml +++ b/settings.yaml @@ -25,6 +25,22 @@ spec: value: "" placeholder: 支持编写 HTML，留空则不显示 help: 显示在页脚的自定义版权信息 + - $formkit: checkbox + name: show_theme_credit + label: 显示主题署名 + value: true + help: 在页脚显示「Theme by」署名；关闭则不显示 + - $formkit: text + name: theme_credit_text + label: 署名名称 + value: "暖心向阳335" + placeholder: 显示在「Theme by」之后的名称 + help: 页脚主题署名的展示名称 + - $formkit: checkbox + name: show_word_count + label: 文章卡片显示字数 + value: true + help: 在文章卡片与置顶文章上展示字数及阅读时长（需 extra-api 插件提供数据） - group: featured label: 置顶文章 formSchema: @@ -99,3 +115,35 @@ spec: label: 公网安备查询链接 value: "https://beian.mps.gov.cn" help: 点击公网安备号跳转的地址，默认全国互联网安全管理服务平台 + - group: stats + label: 全站数据 + formSchema: + - $formkit: checkbox + name: enable + label: 显示全站数据统计 + value: false + help: 在页脚展示站点文章、分类、评论、访问量与字数等统计 + - $formkit: checkbox + name: show_posts + label: 文章数 + value: true + - $formkit: checkbox + name: show_categories + label: 分类数 + value: true + - $formkit: checkbox + name: show_tags + label: 标签数 + value: false + - $formkit: checkbox + name: show_comments + label: 评论数 + value: true + - $formkit: checkbox + name: show_visits + label: 访问量 + value: true + - $formkit: checkbox + name: show_words + label: 全站总字数（需 extra-api 插件） + value: true diff --git a/src/css/main.css b/src/css/main.css index 253ebc1..6c27ef7 100644 --- a/src/css/main.css +++ b/src/css/main.css @@ -210,7 +210,7 @@ textarea { flex: 1; justify-content: center; flex-wrap: nowrap; - overflow-x: auto; + overflow: visible; -ms-overflow-style: none; scrollbar-width: none; } @@ -240,6 +240,62 @@ textarea { font-weight: 500; } +/* 二级导航：带子菜单的项 */ +.nav-item { + position: relative; + display: flex; + align-items: center; +} + +.nav-has-children > .nav-link::after { + content: ""; + display: inline-block; + width: 0; + height: 0; + margin-left: 0.3rem; + vertical-align: middle; + border-left: 4px solid transparent; + border-right: 4px solid transparent; + border-top: 5px solid currentColor; + opacity: 0.6; +} + +.nav-dropdown { + position: absolute; + top: calc(100% + 0.5rem); + left: 50%; + transform: translateX(-50%); + min-width: 11rem; + display: none; + flex-direction: column; + padding: 0.5rem; + background: var(--color-bg); + border: 1px solid var(--color-border); + border-radius: var(--radius-md); + box-shadow: var(--shadow, 0 12px 32px rgba(0, 0, 0, 0.12)); + z-index: 50; +} + +.nav-has-children:hover > .nav-dropdown, +.nav-has-children:focus-within > .nav-dropdown { + display: flex; +} + +.nav-dropdown-link { + padding: 0.5rem 0.75rem; + border-radius: var(--radius-sm); + color: var(--color-text); + white-space: nowrap; + transition: + background-color var(--transition-fast), + color var(--transition-fast); +} + +.nav-dropdown-link:hover { + background: var(--color-bg-secondary); + color: var(--color-primary); +} + .header-actions { display: flex; align-items: center; @@ -326,6 +382,12 @@ textarea { background-color: var(--color-bg-secondary); } +.mobile-nav-sub { + padding-left: calc(var(--spacing-md) + 1rem); + font-size: 0.9rem; + opacity: 0.85; +} + /* ======================================== 主要内容区域 ======================================== */ @@ -449,6 +511,9 @@ textarea { .post-category { color: var(--color-text-secondary); + display: inline-flex; + flex-wrap: wrap; + gap: 0.4rem; } .post-category a { @@ -571,6 +636,12 @@ textarea { color: var(--color-border); } +.article-category { + display: inline-flex; + flex-wrap: wrap; + gap: 0.4rem; +} + .article-category a { color: var(--color-text-muted); } @@ -1136,6 +1207,20 @@ a.pagination-item:hover { height: 0.95rem; } +.footer-stats { + display: flex; + flex-wrap: wrap; + justify-content: center; + gap: 0.35rem 1rem; + margin-top: var(--spacing-md); + font-size: 0.8rem; + color: var(--color-text-muted); +} + +.footer-stat { + white-space: nowrap; +} + .post-words, .post-reading { color: var(--color-text-muted); diff --git a/src/douban.html b/src/douban.html new file mode 100644 index 0000000..31f9a62 --- /dev/null +++ b/src/douban.html @@ -0,0 +1,141 @@ + + + +
+
+

+ 豆瓣 +

+

+ + + + + +
+

+ 读过 +

+
+ + +

名称

+

+ 年份 + 评分 +

+ +
+
+ + + + + +

+ 未检测到豆瓣插件 +

+
+
+ diff --git a/src/links-subscribe.html b/src/links-subscribe.html index 288f470..32e04a5 100644 --- a/src/links-subscribe.html +++ b/src/links-subscribe.html @@ -41,8 +41,8 @@

链接订阅

1 views - + - · - 字数 - · - 阅读时长 + + · + 字数 + · + 阅读时长 + diff --git a/src/partials/layout.html b/src/partials/layout.html index 41823d3..6970849 100644 --- a/src/partials/layout.html +++ b/src/partials/layout.html @@ -58,13 +58,37 @@ >Home - + + +
+ +
+ +
+
+ + + + + @@ -153,13 +177,21 @@ >Home - + + + +
@@ -176,10 +208,11 @@ th:if="${not #strings.isEmpty(theme.config?.basic?.footer_copyright)}" th:utext="${theme.config.basic.footer_copyright}" > -

- Theme by - kehua -

+

Theme by kehua

公网安备
+
+ 文章 + 分类 + 标签 + 评论 + 访问 + 字数 +
diff --git a/src/weread.html b/src/weread.html index 9eaaf62..3d784f5 100644 --- a/src/weread.html +++ b/src/weread.html @@ -29,8 +29,8 @@

微信读书

diff --git a/theme.yaml b/theme.yaml index 7b12294..9fee27e 100644 --- a/theme.yaml +++ b/theme.yaml @@ -37,3 +37,7 @@ spec: description: 适配 plugin-links 的 RSS 订阅动态聚合页 screenshot: file: links-subscribe.html + - name: 豆瓣页面 + description: 适配 plugin-douban（豆瓣/追番）的主题页面，按收藏状态展示条目 + screenshot: + file: douban.html