3.1.4

[3.1.4] - 2025-5-31

Chore

• 新增一篇数学公式示例文章

Fix

• 修复了数学公式的渲染问题（先前缺少了必要的 CSS 文件）

---

EN

[3.1.4] - 2025-5-31

Chore

• Added a new sample article for mathematical formulas.

Fix

• Fixed the rendering issue for mathematical formulas (previously missing a necessary CSS file).

---

Full Changelog: v3.1.3...v3.1.4

3.1.3

[3.1.3] - 2025-5-24

Chore

• 更新依赖
• 在 Friends 页面添加了新的贡献者
• 移除了不必要的 css 文件（之前的残留）

Fix

• 修复了分类页面中展开动画的样式
• 修复了分类页面中 post 缺失的过渡效果

---

EN

[3.1.3] - 2025-05-24

Chore

• Updated dependencies
• Added new contributors to the Friends page
• Removed unnecessary CSS files (leftover from before)

Fix

• Fixed the animation style for expanding items on the category page
• Fixed the missing transition effect for post items on the category page

---

What's Changed

• fix: 小型 bug 修复 by @youngestar in #81

New Contributors

• @youngestar made their first contribution in #81

Full Changelog: v3.1.2...v3.1.3

3.1.2

[3.1.2] - 2025-4-19

Features

• 新增了一篇如何配置评论系统的教程

Refactored

• 在侧边栏移除了不必要的 title 属性

Fix

• 修复了未适配 Chrome 的自动深色主题 #78

---

EN

[3.1.2] - 2025-04-19

Features

• Added a new tutorial on how to configure the comment system

Refactored

• Removed unnecessary title attributes from the sidebar

Fix

• Fixed the auto dark mode issue that was not compatible with Chrome (#78)

---

Full Changelog: v3.1.1...v3.1.2

3.1.1

[3.1.1] - 2025-3-30

Features

• 在 frosti.config.yaml 中添加单个页面文章数量的配置
• 添加了对于日期与月份的 i18n 配置
• 添加了大量语言配置

Refactored

• 将可重用代码集中到了 /utils 中
• 将 hints 降至 0

Fix

• 修复了在 RSS 中仍然显示草稿文章的问题

---

EN

[3.1.1] - 2025-3-30

Features

• Added configuration for the number of articles per page in frosti.config.yaml
• Added i18n configuration for dates and months
• Added a large number of language configurations

Refactored

• Centralized reusable code into /utils
• Reduced hints to 0

Fix

• Fixed the issue where draft articles were still displayed in RSS

---

What's Changed

• fix: Correct style issues in TOC components and update changelog by @EveSunMaple in #73
• feat: Filter drafts in rss by @linglilongyi in #74

New Contributors

• @linglilongyi made their first contribution in #74

Full Changelog: v3.1.0...v3.1.1

3.1.0

[3.1.0] - 2025-3-29

Features

• 添加了属于手机端的专属目录 MobileTOC
• 添加了代码框的行号样式
• 添加了页面脚注的样式

Refactored

• 修改了 About 页面的时间线组件
• 修改了若干按钮的响应式尺寸
• 修改了搜索框的样式设计
• 在小屏幕隐藏默认目录

Fix

• 修复了网站标题在 Tab 栏显示错误的问题
• 修复了在文章缺失图片的样式错误

Chore

• 移除了不必要的引用

---

EN

[3.1.0] - 2025-3-29

Features

• Added a dedicated MobileTOC for mobile devices
• Added line number styling for code blocks
• Added styling for page footnotes

Refactored

• Updated the timeline component on the About page
• Adjusted responsive sizes for several buttons
• Redesigned the search box styling
• Hid the default table of contents on small screens

Fix

• Fixed the issue where the website title displayed incorrectly in the tab bar
• Fixed the styling error that occurred when an article lacked an image

Chore

• Removed unnecessary imports

---

What's Changed

• v3.1.0 by @EveSunMaple in #71

Full Changelog: v3.0.0...v3.1.0

3.0.0

[3.0.0] - 2025-3-23

恭喜！Frosti v3 正式发布！🎉

Features

1. 主要卡片修改

   • 卡片布局修改

     添加了新的组件 Card.astro 与 CardGroup.astro。后者包裹前者时，在手机端将会合并成一个卡片。示例代码：

     <CardGroup>
       <Card>
         <img src="https://picsum.photos/200/300" alt="">
         <div>
           <h3>Card 1</h3>
         </div>
       </Card>
       <Card>
         <!-- More photos -->
       </Card>
     </CardGroup>

     演示：

     version 3	version 2

   • 卡片样式修改

     若有图片，标题将会浮在图片上方。同时右下角有一个可自定义的按钮，展示 description 或者更多信息。

     演示：

     version 3	version 2

2. 侧边栏修改

   • Profile.astro

     演示：

     version 3	version 2

   • 添加了新的侧边栏组件

     • 搜索栏

     • 标签、分类、以及归档按钮

       演示：

       version 3	version 2

   • 修改了目录的样式与运动效果

     演示：

     version 3	version 2

3. 添加了新的页面

   • 归档页面

     

   • 标签页面

     

   • 分类页面

     

   • 搜索页面

     

4. 修改了原有的页面样式

   • 新增了类似于工具栏的内容

     演示：

     version 3	version 2
     	None

   • 以及其他等等：

     演示：

     version 3	version 2
     	None

5. 新增 MDX 组件

   • GitHubStats.astro

     <GitHubStats username="frosti-team" />
     <GitHubStats username="frosti-team" repositoryName="frosti" />

   • RepositoryCard.astro

     <RepositoryCard repo="frosti-team/frosti" />
     <RepositoryCard
       repo="frosti-team/frosti"
       image={import("../../assets/images/repo-cover.png")}
       isPinned={true}
     />

   • FeatureCard.astro

     <FeatureCard
       title="响应式设计"
       description="完美适配各种屏幕尺寸，从手机到桌面设备。"
       icon="lucide:layout"
       color="oklch(0.7 0.2 140)"
     />

   • FriendCard.astro

     <FriendCard
       name="SunMaple"
       avatar={import("../../assets/images/avatars/sunmaple.png")}
       description="前端开发工程师，Frosti 核心贡献者"
       url="https://www.saroprock.com"
       type="contributor"
     />

6. 添加了 404 页面
   

Refactored

• 修复了分页按钮的样式问题

• 修改了标签以及分类按钮的样式

• 修改了文章图片hover的效果

• 为了适配 Astro v5 重写的代码框：

  演示：

  version 3	version 2

Fix

• 修复了错误的昼夜切换逻辑（为什么一直没有人发现它？）
• 修复了在纯净式阅读器或者 RSS 阅读器中代码框样式出错的问题

Chore

• 移除了 Waline 评论系统
• 移除了点击图片放大的功能

---

EN

[3.0.0] - 2025-3-23

Congratulations! Frosti v3 is officially released! 🎉

Features

1. Major Card Update

   • Card Layout Update

     Added new components Card.astro and CardGroup.astro. When the latter wraps the former, they will merge into a single card on mobile devices. Example code:

     <CardGroup>
       <Card>
         <img src="https://picsum.photos/200/300" alt="">
         <div>
           <h3>Card 1</h3>
         </div>
       </Card>
       <Card>
         <!-- More photos -->
       </Card>
     </CardGroup>

     Demo:

     version 3	version 2

   • Card Style Update

     If an image is present, the title will float above it. Additionally, a customizable button will appear in the bottom-right corner, displaying a description or more information.

     Demo:

     version 3	version 2

2. Sidebar Update

   • Profile.astro

     Demo:

     version 3	version 2

   • Added New Sidebar Components

     • Search bar

     • Tags, categories, and archive buttons

       Demo:

       version 3	version 2

   • Updated Directory Styles and Animation Effects

     Demo:

     version 3	version 2

3. New Pages Added

   • Archive Page

     

   • Tag Page

     

   • Category Page

     

   • Search Page

     

4. Updated Existing Page Styles

   • Added toolbar-like content

     Demo:

     version 3	version 2
     	None

   • And many others:

     Demo:

     version 3	version 2
     	None

5. New MDX Components

   • GitHubStats.astro

     <GitHubStats username="frosti-team" />
     <GitHubStats username="frosti-team" repositoryName="frosti" />

   • RepositoryCard.astro

     <RepositoryCard repo="frosti-team/frosti" />
     <RepositoryCard
       repo="frosti-team/frosti"
       image={import("../../assets/images/repo-cover.png")}
       isPinned={true}
     />

   • FeatureCard.astro

     <FeatureCard
       title="Responsive Design"
       description="Perfectly adapts to various screen sizes, from mobile to desktop."
       icon="lucide:layout"
       color="oklch(0.7 0.2 140)"
     />

   • FriendCard.astro

     <FriendCard
       name="SunMaple"
       avatar={import("../../assets/images/avatars/sunmaple.png")}
       description="Frontend developer, core contributor to Frosti"
       url="https://www.saroprock.com"
       type="contributor"
     />

6. Added 404 Page
   

Refactored

• Fixed pagination button style issues

• Modified tag and category button styles

• Improved article image hover effect

• Code blocks refactored to align with Astro v5:

  Demo:

  version 3	version 2

Fix

• Fixed incorrect day-night toggle logic (Why did no one notice it earlier?)
• Fixed code block style issues in reader-only or RSS readers

Chore

• Removed Waline comment system
• Removed image zoom-in functionality

---

What's Changed

• Frosti v3 by @EveSunMaple in #64

Full Changelog: v2.9.1...v3.0.0

2.9.1

[2.9.1] - 2025-1-7

Features

• 将 astro-i18next 替换为其上游库 i18next，以修复在 Node.js v22.12.0 中的兼容性问题
  （解决了导致国际化功能（i18n）在最新 Node.js 版本中无法正常工作的关键问题。）

Fix

• 修复了原 tailwind.config.js 中的引包
• 修复了链接样式

Chore

• 更换为更严格的 ESLint 作为代码格式化和检查工具
• 对 i18n 配置进行了小幅优化
• 移除了不必要的 node_modules 依赖

---

EN

[2.9.1] - 2025-1-7

Features

• Replaced astro-i18next with its upstream library i18next to fix compatibility issues with Node.js v22.12.0.
  (Resolved a critical issue that caused the internationalization (i18n) functionality to fail in the latest Node.js version.)

Fix

• Fixed imports in the original tailwind.config.js.
• Resolved link styling issues.

Chore

• Switched to stricter ESLint as the code formatter and linter.
• Made minor optimizations to the i18n configuration.
• Removed unnecessary dependencies from node_modules.

---

What's Changed

• fix: Replaced linting tool with a stricter one and fixed i18n issue in Node v22.12.0 by @TNXG in #61

New Contributors

• @TNXG made their first contribution in #61

Full Changelog: v2.9.0...v2.9.1

2.9.0

Important

所有 MDX 组件已经移动至 components/mdx 目录之下，更新版本后请及时修改引用路径！

[2.9.0] - 2024-12-28

Features

• 新增 mdx/TocCopllapse.astro 组件用于在文章中添加折叠的目录(小屏幕侧边栏无法显示时才出现)
  • 新增 remark-heading-extractor.mjs 在服务端提取标题并存贮在 frontmatter 中

Note

原本想通过此组件实现在服务端生成所有目录, 但发现侧边栏并不在 Swup 的按需渲染范围之中, 所以只能保留在客户端生成目录的形式

• 新增 TocCard.astro (拆分 Tool.astro)

Refactored

• 取消了昼夜颜色的切换动画
• 修改侧边栏结构, 删除了多余的组件合并为 ProfileCard.astro 并优化了样式
  • 鼠标放在图标上新增小动画
  • 微调了菜单与子菜单的间距
• 完全重写 License.astro 组件的样式与构建逻辑
  • 文末添加 'Thanks for reading!' (平衡页面)
  • CC 图标移动至左上方
  • 在 License 中添加文章信息如: 作者\发布日期\字数\阅读时长\永久链接\分类\标签
  • 重写原本的分享组件
• 针对所有 MDX 组件进行了样式优化
  • 对所有 alert 使用统一格式
  • 修改 Kbd.astro 新增大小 size 选项
  • 重写 Collapse.astro 组件使用自定义格式而非由 DaisyUI 提供
  • 针对 Diff.astro 组件添加了 rightAlt 等选项
  • 修改 TimeLine.astro 组件的样式并添加了动效
  • 修改 LinkCard.astro 组件的结构与样式
  • 新增 TocCopllapse.astro 组件
• 文字排版:行间距修改
• 重写 badge 的样式而不是使用 DaisyUI 提供的默认样式
  • 在 TagCard.astro 与 CategoryCard.astro 中使用全新的 badge 样式
• 重写 EnvelopeCard.astro 组件的样式
  • 文章信息展示修改
    • 去除原本堆砌的 DaisyUI 样式
    • 文章发表日期与字数统计等内容收纳至上方
    • 文章分类与标签信息使用全新的 badge 样式
    • 取消原本指针覆盖在图片上出现的小箭头样式
  • 同理修改 BaseCard.astro 组件中文章信息的样式
• 修改 ProjectCard.astro 组件的样式与逻辑
  • 收纳逻辑至 utils/github.ts 等文件中
  • 添加针对获取数据的格式化处理
  • 代码语言改至左侧, 仓库信息放在右侧
  • 删除针对 Watch 的数据统计
• 修改 Navbar.astro 组件的样式与逻辑
  • 使用调换重做顶部菜单按钮
  • 添加顶部菜单滑入\滑出动画
• 将分页制作为全新的可重用组件 Pagination.astro
• 隐藏了 TocCard 的滑动条
• 修改了 code 的样式
• 布局文件微调

Fix

• 修复了原 CategoryCard.astro 组件中错误的变量命名
• 修复了图片放大导致的页面触摸失效问题

Chore

• 基本上的变量都有了 interface 的定义
• 基本上的图标都使用了 iconify 提供的图标

---

EN

Important

All MDX components have been moved to the components/mdx directory. Please update the import paths after upgrading to the new version!

[2.9.0] - 2024-12-28

Features

• Added mdx/TocCollapse.astro component to add a collapsible table of contents in articles (it only appears when the sidebar is not visible on small screens).
  • Added remark-heading-extractor.mjs to extract headings on the server side and store them in frontmatter.

Note

The initial intention was to generate the entire table of contents on the server side, but it was found that the sidebar is not part of the on-demand rendering range of Swup, so the table of contents can only be generated on the client side.

• Added TocCard.astro (split from Tool.astro).

Refactored

• Removed the day/night theme toggle animation.
• Modified the sidebar structure, removed redundant components, merged them into ProfileCard.astro, and optimized the styles.
  • Added a small animation when hovering over icons.
  • Adjusted the spacing between the menu and submenu.
• Completely rewrote the style and build logic of the License.astro component.
  • Added 'Thanks for reading!' at the end of the page (to balance the layout).
  • Moved the CC icon to the top-left corner.
  • Added article information in the License, such as: author, publish date, word count, reading time, permalink, category, and tags.
  • Rewritten the original share component.
• Optimized styles for all MDX components.
  • Unified format for all alert components.
  • Modified Kbd.astro and added a size option.
  • Rewritten Collapse.astro component to use custom formats instead of DaisyUI.
  • Added options like rightAlt for the Diff.astro component.
  • Modified the styles of TimeLine.astro and added animations.
  • Changed the structure and style of LinkCard.astro.
  • Added TocCollapse.astro component.
• Adjusted line spacing in typography.
• Rewritten the badge styles instead of using DaisyUI’s default.
  • Used the new badge style in TagCard.astro and CategoryCard.astro.
• Rewritten the styles of EnvelopeCard.astro.
  • Modified the article information display.
    • Removed the piled-up DaisyUI styles.
    • Moved the article publish date and word count to the top.
    • Used the new badge style for article category and tag information.
    • Removed the small arrow style that appeared over images when hovering.
  • Similarly, modified the article information styles in BaseCard.astro.
• Modified the style and logic of ProjectCard.astro.
  • Moved logic to utils/github.ts and other files.
  • Added formatting for data fetching.
  • Moved the code language to the left and repository info to the right.
  • Removed the data statistics for Watch.
• Modified the style and logic of Navbar.astro.
  • Reworked the top menu button.
  • Added sliding animations for the top menu.
• Made pagination a completely reusable component, Pagination.astro.
• Hid the scrollbar in TocCard.
• Modified the styles of code.
• Minor tweaks in layout files.

Fix

• Fixed incorrect variable naming in the original CategoryCard.astro.
• Fixed an issue where image zooming caused touch interaction failures on the page.

Chore

• Most variables now have interface definitions.
• Most icons have been replaced with those provided by iconify.

---

Full Changelog: v2.9.0-rc...v2.9.0

2.9.0-rc

Pre released, document still under editing

2.8.1

[2.8.1] - 2024-12-5

Features

• 新增 sitemap.xml 代替自动生成的 sitemap-0.xml
• 重写 rss.xml.ts 完善了格式并在 RSS 中添加了全文内容
• 新增可重用组件 GithubInfo 路径:src\widget\GithubInfo.astro
• 新增卡片布局 包括 Aside / Horizontal / Vertical
• 为博客文章内容添加了渐入效果
• 添加了手动开关评论系统的功能

Refactored

• 组件布局统一并修改
• 重写了博客底部 License 组件的样式
• 清理了全局的 ClassName 以简化代码
• 将 tag 路由更名为 tags

Fix

• 可访问性修复:为必要的组件添加了 aria-label 以及由 sr-only 包裹的文本
• 为代码框中的复制按钮添加了随机的专属的 id 与表单链接
• 修复了分页按钮在仅有一页时出现的样式错误
• 修复了在标签与分类页面下不显示字数与阅读时长的问题

Chore

• 使用 iconify 代替了本地存储 svg 的方式

---

EN

[2.8.1] - 2024-12-5

Features

• Added sitemap.xml to replace the automatically generated sitemap-0.xml.
• Rewritten rss.xml.ts to improve formatting and include full content in the RSS feed.
• Added reusable component GithubInfo located at src\widget\GithubInfo.astro.
• Introduced card layouts including Aside, Horizontal, and Vertical.
• Added fade-in effect to blog post content.
• Added functionality to manually toggle the comment system.

Refactored

• Unified and modified component layouts.
• Rewritten styles for the blog footer License component.
• Cleaned up global ClassNames to simplify the code.
• Renamed tag route to tags.

Fix

• Accessibility fixes: Added aria-label to necessary components and wrapped text with sr-only.
• Added random unique id and form linkage to the copy button in code blocks.
• Fixed style issues with pagination buttons when there is only one page.
• Fixed the issue where word count and reading time were not displayed on tag and category pages.

Chore

• Replaced local SVG storage with iconify.

---

What's Changed

• chore: update Vite CSS preprocessor options for SCSS compilation by @yaotutu in #53
• ✨ Add RSS Full Text by @EveSunMaple in #54
• 🛠️ chore: miscellaneous repairs by @EveSunMaple in #55

New Contributors

• @TNXG made their first contribution in #55

Full Changelog: v2.8.0...v2.8.1