FlatPaper

Appearance

更新日志 (CHANGELOG) ​

Flatpaper - Releases

v0.6.0 ​

2026-11-12

设计

  • 统一手绘 / 纸张设计语言：抽出共用的胶带、纸片按钮、手绘箭头链接与荧光笔划过写法。
    • 链接取消波浪下划线，改为跟随主题色的荧光笔；正文链接、首页开屏快速链接与 stackalbumnav 标题常驻一道浅荧光笔，悬浮时加深。
    • 欢迎卡片行动按钮、「阅读全文」、列表分页、文章页上一篇 / 下一篇改用手绘箭头。
    • 顶部导航的一级菜单、二级菜单与左上角品牌菜单共用一条从左向右铺开、宽度贴合文字的胶带。
    • 主题色选择与目录当前项标记改用倾斜的手绘小方块。

新增

  • 赞赏名单标签：新增 {% rewardlist %} 与 {% rewardlistfrom <数据路径> %}，不再需要手写 HTML，详见赞赏名单。
  • 侧栏分类卡新增「查看全部」入口。
  • 热门标签最多显示 20 个。

修复

  • 首页开屏卡片在打字机换行时不再上下跳动。
  • 友链与朋友圈卡片在底边悬浮时不再跳动。
  • 堆叠相册刷新后不再从右下角滑入，底部也不再与后文重叠。
  • 赞赏名单的图片头像回到右上角。
  • 文字选中色与行内代码背景不再重合。
  • 留言板（Twikoo）只显示当前页面的留言：Twikoo 2.x SDK 的 getRecentComments 不再把 urls 过滤参数传给后端，导致留言墙显示全站最新评论（文章下方评论区不受影响）。

行为变更

  • home_hero.typed.enable 默认值改为 false。只开启了 home_hero、没有单独配置 typed 的站点，需要加上 typed.enable: true 才能保留打字机效果。

v0.5.2 ​

2026-11-12

调整

  • 首页开屏 CTA 贴纸重绘：9 组内置贴纸改为以卡片左上角为基准的画布绘制，贴纸可以越过卡片边角，并移到虚线缝线之上；去掉白色描边，和纸胶带改为折过卡片左缘的 SVG 纸条。暗色模式下内置贴纸会略微加深饱和度，自定义图片贴纸保持原样。在线预览
  • 评论 SDK 跟随大版本 2：Twikoo 与 Artalk 的默认 jsDelivr 地址改为 twikoo@2、artalk@2，自动获取 2.x 的小版本更新。对 Twikoo 而言这是一次大版本升级，后端仍停在 1.x 的站点请通过 twikoo.cdn 固定旧版 SDK，例如 https://cdn.jsdelivr.net/npm/[email protected]/dist/twikoo.all.min.js。

v0.5.1 ​

2026-10-27

新增与调整

  • 首页开屏 CTA 按钮重构为 CSS 纸片卡片与贴纸预设：
    • 将原先 9 张内置 WebP 背景图替换为纯 CSS 绘制的手账纸片卡片 + 内联 SVG 贴纸，完整跟随暗色模式与主题强调色，且按钮宽度随文字自适应不再截断。
    • cta_background：01–09 映射为 9 组「颜色 + 贴纸」内置预设，random 在首屏渲染前随机选取一组；填写自定义图片路径时仍保留 180×60 整图背景按钮模式。
    • 新增 cta_color：可单独覆盖预设颜色（支持 brown / pink / orange / green / yellow / blue / violet / accent 或 #hex 十六进制色值）。
    • 新增 cta_sticker：可单独覆盖预设贴纸（支持 none / flower / bear / tulip / sprout / star / sparkle / heart / tape 或自定义图片路径）。
    • 在线预览与配置生成工具：Flatpaper Tools - CTA

修复

  • AdSense 侧栏轨广告兼容：限制宽屏（≥1200px）下 <body> 直属自动广告宽度，并将默认纸纹背景改为 body::after 渲染，避免遮挡或挤走 AdSense 侧> 栏轨广告。

v0.5.0 ​

2026-10-11

新增

  • 堆叠相册（Stack Album）标签支持：
    • {% stackalbum %}：将一组照片渲染为扑克牌式的堆叠相册（澎湃 OS 相册风格），点击最上层或使用键盘 Enter / → 即可抽起并滑入牌底，支持可选尺寸参数与横竖方向标记。
    • {% stackalbumnav <数据路径> %}：渲染小号牌堆与标题列表（读取 source/_data/ 下的列表数据），悬停或聚焦标题即可将对应封面翻到最上层，适合番剧、书单、影单等清单展示。
  • 手账便签风格赞赏名单（Reward List）：
    • 支持在关于页等独立页面正文中通过 .reward-list 结构化 HTML 渲染带胶带、轻微歪斜的赞赏便签卡片与右上角圆形头像。
    • 自动解析金额文本并匹配人民币纸币色档位徽章（≥100 红 / ≥50 绿 / ≥20 棕黄 / ≥10 蓝 / ≥5 紫 / ≥1 橄榄绿）。
  • 打字机效果（Typed.js）：
    • 支持在页脚版权行右侧（footer.typed）与首页开屏简介位置（home_hero.typed）启用打字机效果。
    • 支持接入一言（hitokoto）、一句网（yijuzhan）、今日诗词（jinrishici）接口及自定义 sub 句子列表循环；CDN 超时或不可达时自动退回纯文本展示。
  • 首页开屏渐进式加载与独立窄屏图源：
    • home_hero.image_progressive 与 home_hero.image_placeholder：支持 Medium 风格模糊小图渐进加载、入场缩放淡入，以及滚动时背景层放大渐隐离场。
    • home_hero.mobile_image：除 true / false 外，支持填入独立图片路径作为窄屏（≤760px）专用背景图。
  • 首页模块滚动渐入动效（Reveal on Scroll）：
    • 首页置顶轮播、章节标题、文章卡片与侧栏卡片进入视口时逐个上浮渐显，文章卡片按索引交错出场，无 JS 或开启减少动态效果时自动降级直显。
  • 页脚纯图标链接与署名位置配置：
    • footer.links 条目支持配置 icons / icon / iconSize、title 与 aria-label，支持渲染 CC 协议等纯图标链接。
    • footer.powered.row 支持配置主题署名所在行（first 并入首行末尾 / last 并入末行末尾 / own 独占一行）。

v0.4.0 ​

2026-07-05

新增

  • 留言板（Guestbook）页面支持： 将页面评论渲染为一面彩色便签风格的「留言墙」。
    • 纸片与胶带颜色、歪斜角度由留言 ID 确定性生成。
    • 支持从 Twikoo (HTML) 或 Artalk (Markdown/HTML) 自动提取文本与图片/表情。
    • 支持默认随机排序与最新优先排序（最新优先模式下采用网格布局）。
    • 支持通过 page_size 限制每页加载数量并可展开加载更多。
    • 仅展示主楼留言（最多 100 条），支持渲染 Markdown 开场白于墙面之上。 (注意：需在主题配置中启用 Twikoo 或 Artalk 评论系统)

v0.3.6 ​

2026-07-03

新增

  • 增加 package.json 文件以支持规范化的 npm 包管理。

优化

  • 性能优化与代码重构：
    • 优化代码块事件监听逻辑，通过事件委托机制优化大量行的点击/双击复制/高亮处理性能，降低内存开销。
    • 优化随机文章推荐卡片的数据加载，实现接口请求和解析的缓存（randomPostsCache），避免重复请求与渲染。
  • 细节调整：
    • 暗色模式切换时，自动同步修改 theme-color meta 标签的 content 属性。
    • 优化表格换行逻辑，并增加列的最低宽度。
    • 优化 TOC 目录，防止悬浮时出现溢出滚动条。

修复

  • 修复 Markdown 表格对齐失效的问题。
  • 修复图标命名，将 wechat 图标重命名为 weixin。

v0.3.5 ​

2026-07-02

新增

  • Hero Image 的 CTA Button 样式调整，支持使用自定义背景图片
  • 社交链接 Hover 时显示 Tooltip
  • Hero Image 支持配置窄屏布局下是否显示背景图片 默认开启，禁用可以设置
    yaml
    home_hero:
  mobile_image: false

修复

  • 修复 Hero CTA 中英文字母 p、j、g、q、y 显示被截断的问题
  • 修复 Hero 开启 Image、但关闭窄屏模式 Image 时，hero_links 可见性异常的问题

v0.3.4 ​

2026-06-27

新增：

  • 主题内置全部 Lucide-icon 与 Font Awesome 6 Free
  • 构建时按需选取

Lucide 系列直接填写图标名称， fa-<type>:<name> 使用 Font Awesome 6

v0.3.3 ​

2026-06-26

新增：

设置页面顶部的 frontmatter 即可，不写即关闭

yaml
top_img:   # path or url

修复 修复了文章顶部图片在手机浏览器的样式问题

v0.3.2 ​

2026-06-26 新增

  • 可以设置一些简单的背景特效
  • 增加了文章页面顶图的设置

调整

  • 重构了 Tabs Block 的样式
  • 重构了 Footer 部分的链接设置，可以更简单的设置 Footer 链接

BreakChange

: 放弃解析 footer.right 的内容，改为 footer.powered 与 footer.links 字段

如果没在 Footer 添加过链接没有影响

v0.3.1 ​

2026-06-24

新增朋友圈

朋友圈功能基于 Friend-Circle-Lite 实现

  • 支持生成 Friend-Circle-Lite 所需的 friend.json，从其生成的 all.json 解析朋友圈页面

使用 Hexo 创建页面，比如 source/fcircle/index.md

yaml
---
title: 朋友圈
type: friends-feed
comments: false
fcl_all_json: https://raw.githubusercontent.com/<Name>/<Repo>/refs/heads/page/all.json
page_size: 20
source_label:
---
  • title: 页面的标题，随意填写
  • type: 页面类型，固定 friends-feed
  • comments: 是否开启评论，true 开启， 默认 false 关闭
  • fcl_all_json: FCL 的 all.json 的链接， https://raw.githubusercontent.com/<Name>/<Repo>/refs/heads/page/all.json
  • page_size: 第一页显示的文章数量
  • source_label: 来源连接的显示文字，不填则不显示来源

优化

  • 优化首页 Hero Image 的样式，去除了重复的阴影遮罩
  • 调整了友链页面的样式

v0.3.0 ​

2026.06.24

新增 Google Fonts 支持

新增了 Google Fonts 支持，可分别配置正文字体与 Mono 代码字体，支持文本切片(text=)与 CDN 加载。

v0.2.3 ​

2026.06.23

调整开屏大图样式

  • 重构社交链接样式
  • 可以设置导航链接
  • 调整快速访问跳转按钮样式，并且访问后关闭对话框
  • 调整无图片的背景：移除渐变与 radial-gradient 装饰

v0.2.1 ​

2026.06.22

新增功能 GA4

  • 支持 Google Analytics GA4

默认关闭，在主题配置中增加配置开启

yaml
google_analytics:
  enable: true
  measurement_id:  G-XXXXXXXXXX

v0.2.0 ​

2026.06.22

视觉系统大幅调整

主线从虚线边框更换为纸张/胶带风格，包括卡片纸面阴影、胶带位置、友链 hover、标签 tape、tabs、表格、图片圆角、暗色模式对比度等。

  • 新增首页开屏 Hero
  • 新增自定义 404 页面支持
  • 替换 Fallback 封面图
  • 新增文章正文加粗主题色开关
  • 新增紫色主题色
  • 新增友链样式配置
  • 新增社交图标按钮样式配置
  • 文档补全：补了 hero、404、配置兼容原则、语言切换示例、layout/development 中的 home-hero.ejs 与 home_hero i18n 说明。

v0.1.0 ​

2026.06.22

第一次打包 GitHub Release ，主体功能都已完工，正常使用了一个月。

功能

  • 支持 Artalk、Twikoo 评论系统
  • 支持快速设置 Google AdSence 自动广告
  • 支持 Umami 统计系统
  • 支持友链页面

初始使用虚线边框的样式版本保留在 style/dashed 分支。

v0.0.0 ​

2026.05.16

Hexo Theme Flatpaper init commit.