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

2.8.0

[2.8.0] - 2024-11-9

Features

• 为 Navbar 添加了操作：下滑页面收起，上滑放下
• 重做了代码复制按钮，减少客户端代码，具体样式详见演示

Refactored

• 整体页面调整（之前一直觉得 “贴屏幕贴得太近了” 这种感觉，现在好很多）包括宽度与字号

Fix

• 修复了若干问题

---

EN

[2.8.0] - 2024-11-9

Features

• Added an action for the Navbar: collapse when scrolling down, expand when scrolling up
• Redesigned the code copy button, reducing client-side code, with specific styles shown in the demo

Refactored

• Overall page adjustments (previously, it always felt "too close to the screen," but now it feels much better), including width and font size

Fix

• Fixed several issues

Full Changelog: v2.8.0-rc...v2.8.0

2.8.0-rc

[2.8.0] - 2024-11-3

Features

• 学习了 Astro 中自定义元素的用法，现在两个交互按钮单独分为 widget 可以重用
• 在 consts.ts 新增了 SITE_LANG 作为网站的语言配置
• 在 consts.ts 新增了 DAIYSUI_THEME 作为 DaiysUI 的主题配置，详见 https://daisyui.com/docs/themes/ （此内容需要更多适配）
• 在 consts.ts 新增了 CODE_THEME 作为 shiki 的主题配置

preview

Refactored

• 侧边栏与导航栏修改
• 移除了不必要的工具
• 修改了 active 样式（选择性）

Fix

• 修复了控制台报错
• 补上了 ProjectCard 缺失的颜色过渡

---

[2.8.0] - 2024-11-3

Features

• Learned how to use custom elements in Astro; now the two interactive buttons are separated into reusable widgets.
• Added SITE_LANG in consts.ts as a configuration for the website's language.
• Added DAIYSUI_THEME in consts.ts as a configuration for DaiysUI's theme. For more details, see https://daisyui.com/docs/themes/ (this content requires more adaptation).
• Added CODE_THEME in consts.ts as a configuration for shiki's theme.

Refactored

• Modified the sidebar and navigation bar.
• Removed unnecessary tools.
• Changed the active styles (selectively).

Fix

• Fixed console errors.
• Added the missing color transition for ProjectCard.

More

There are still some known issues and areas for improvement in this version, which will be released as the RC version first

Full Changelog: v2.7.1...v2.8.0-rc

2.7.1

[2.7.1] - 2024-10-19

Refactored

• 有关事件监听的部分更改

Fix

• 修复了滚动问题
• 修复了在站内跳转时目录中 active 保留的问题

---

EN

[2.7.1] - 2024-10-19

Refactored

• Changes related to event listening

Fix

• Fixed scrolling issue
• Fixed the issue of retaining active in the table of contents during internal navigation

---

Full Changelog: v2.7.0...v2.7.1

2.7.0

[2.7.0] - 2024-10-12

Features

• 添加昼夜转换过渡

• 自定义了博客中的标题 ID ，当前命名格式为 heading-${headingCount} ，避免了出现同名标题无法跳转的问题

• 为博客目录功能添加了 "聚焦" 功能，现在目录会根据您当前阅读的部分自动滚动

• 为博客 main 中的卡片添加了逐次进入样式，使用 sass 制作：

  .fade-in-up {
    opacity: 0;
    transform: translateY(50px);
    animation: fadeInUp 0.5s ease forwards;
  
    @for $i from 1 through 10 {
      &:nth-child(#{$i}) {
        animation-delay: #{$i * 0.1}s;
      }
    }
  }
  
  @keyframes fadeInUp {
    to {
      opacity: 1;
      transform: translateY(0);
    }
  }

Refactored

• 修改了原网站图标
• 修改了原不规范的文件命名
• 修改了原不合理的布局
• 修改了侧边栏按钮的样式，使用 join 组合元素
• 微调 padding

Fix

• 修复了在重名 ID 下无法跳转的问题

---

EN

[2.7.0] - 2024-10-12

Features

• Added day-night transition effect.

• Customized the title ID in the blog; the current naming format is heading-${headingCount}, which avoids issues with navigation under identical titles.

• Added a "focus" feature to the blog directory, which now automatically scrolls according to the section you are currently reading.

• Added sequential entry styles to the cards in the blog main, created using sass:

  .fade-in-up {
    opacity: 0;
    transform: translateY(50px);
    animation: fadeInUp 0.5s ease forwards;
  
    @for $i from 1 through 10 {
      &:nth-child(#{$i}) {
        animation-delay: #{$i * 0.1}s;
      }
    }
  }
  
  @keyframes fadeInUp {
    to {
      opacity: 1;
      transform: translateY(0);
    }
  }

Refactored

• Updated the original website icon.
• Revised the original non-standard file naming.
• Adjusted the original unreasonable layout.
• Modified the sidebar button styles using join to combine elements.
• Fine-tuned padding.

Fix

• Fixed the issue of not being able to navigate under duplicate IDs.

---

Full Changelog: v2.6.1...v2.7.0

2.6.1

[2.6.1] - 2024-9-21

Features

• 在 consts.ts 中新增了 USER_SITE ，用来生成网站底部卡片的链接
• 添加了网站加载时的进度条

Refactored

• 修改了 swup 的配置项

Fix

• 修复了文章在标签、分类过多时按钮溢出的问题
• 修复了一堆拼写错误（存在于 2.6.0 的 release 中）
• 删除了在 LinkCard 中不恰当的图片放大功能
• 移除了 transition.scss ，改用 swup 默认主题代替（我不知道这对改善崩溃问题是否有用）

---

[2.6.1] - 2024-09-21

Features

• Added USER_SITE in consts.ts to generate links for the footer card of the website.
• Added a progress bar for the website loading.

Refactored

• Modified Swup configuration options.

Fix

• Fixed the issue of buttons overflowing when there are too many tags or categories in an article.
• Corrected a number of spelling errors (existing in the 2.6.0 release).
• Removed the inappropriate image zoom feature in LinkCard.
• Removed transition.scss and replaced it with Swup's default theme (not sure if this helps with crash issues).

---

What's Changed

• another typo，会导致 下一页 按钮无法显示 by @Loping151 in #36
• small typo... by @Loping151 in #35
• fix katex in content index by @Loping151 in #38
• Fix image zoom in linkcard by @Loping151 in #41
• add USER_SITE into config by @Loping151 in #43

New Contributors

• @Loping151 made their first contribution in #36

Full Changelog: v2.6.0...v2.6.1

2.6.0

[2.6.0] - 2024-9-15

Features

• 新增了导航栏的逻辑，现在点击按钮也可以收回（🚧 此内容可能存在问题，需要收集更多信息 🚧）

• 为每一个标题添加了按钮，您可以将指针放在标题上，点击按钮即可跳转

• 为卡片图片添加了一个跳转样式，鼠标放上后会有一个放大的动画与箭头

• 为链接添加了新的样式，现在它们更生动、更引人注目

• 添加了字数统计与阅读时间计算的功能，您可以在博客中看到它们的统计结果

• 新增分享功能，现在您可以通过文末按钮直接将文章分享到社交媒体上

• 新增 i18n ，移除了老旧的 infoTest ，现在所有的语言都在 public/locales 文件夹中

  这意味着您可以添加多种语言并随时切换，教程如下：

  1. 在 public/locales 文件夹中添加您的语言文件，先添加一个名为语言代码的文件夹，然后在里面添加一个 json 文件，文件名必须为 translation.json

  2. 复制已有的 translation.json 文件，然后修改其中的内容，比如：

     {
     "label": {
       "noTag": "No tags assigned",
       "tagCard": "Tags",
       "tagPage": "Tag - ",
       "noCategory": "No categories assigned",
       "categoryCard": "Categories",
       "categoryPage": "Category - ",
       "link": "Link: ",
       "prevPage": "Recent posts",
       "nextPage": "Older posts",
       "wordCount": "words",
       "readTime": "minutes"
       }
     }

  3. 在 astro-i18next.config.mjs 中添加您的语言代码，比如：

     export default {
     defaultLocale: "en",
     locales: ['en', 'zh', 'xx'] // 这里添加您的语言代码
     };

  4. 在 'BaseLoyout.astro' 中更改为您的语言代码，比如：

     ...
     import i18next, { t, changeLanguage } from "i18next";
     
     changeLanguage("xx");
     ...

Note

欢迎大家为主题添加语言支持！

Refactored

• 新增 docs 文件夹
• 修改了 blockquote 的内边距
• 修改标签页标题，坚持内容优先，把 ${SITE_TAB} - ${title} 改成了 ${title} - ${SITE_TAB}

Fix

• 修复了在标题与 alert 中错误的外链 svg 样式
• 修复了 toc 错误获取 # 的问题
• 修复了导航栏逻辑

---

[2.6.0] - 2024-9-15

Features

• Added logic to the navigation bar; you can now retract it by clicking the button as well (🚧 This content may have issues and requires further information 🚧)

• Added buttons to each title; you can hover over a title and click the button to jump to that section

• Added a hover style to card images, which includes a zoom animation and an arrow

• Added new styles for links, making them more dynamic and eye-catching

• Added word count and reading time calculation features; you can now see these statistics in the blog

• Added a share feature, so you can now directly share articles to social media using the button at the end of the post

• Added i18n support and removed the outdated infoTest; now all languages are located in the public/locales folder

  This means you can add multiple languages and switch between them anytime. Here’s how:

  1. Add your language files in the public/locales folder. First, create a folder named with the language code, then add a JSON file inside it named translation.json.

  2. Copy an existing translation.json file and modify its contents as needed. For example:

     {
     "label": {
       "noTag": "No tags assigned",
       "tagCard": "Tags",
       "tagPage": "Tag - ",
       "noCategory": "No categories assigned",
       "categoryCard": "Categories",
       "categoryPage": "Category - ",
       "link": "Link: ",
       "prevPage": "Recent posts",
       "nextPage": "Older posts",
       "wordCount": "words",
       "readTime": "minutes"
       }
     }

  3. Add your language codes in astro-i18next.config.mjs, for example:

     export default {
     defaultLocale: "en",
     locales: ['en', 'zh', 'xx'] // Add your language codes here
     };

  4. Change to your language code in 'BaseLayout.astro', for example:

     ...
     import i18next, { t, changeLanguage } from "i18next";
     
     changeLanguage("xx");
     ...

Note

We welcome everyone to add language support to the theme!

Refactored

• Adjusted the padding for blockquotes
• Updated tab titles to prioritize content, changing ${SITE_TAB} - ${title} to ${title} - ${SITE_TAB}

Fix

• Fixed incorrect external SVG styles in titles and alerts
• Fixed issue with incorrect retrieval of # in TOC
• Fixed navigation bar logic

---

What's Changed

• ✨ (Header.astro): replace dropdown div with details and summary eleme… by @yaotutu in #34

New Contributors

• @yaotutu made their first contribution in #34

Full Changelog: v2.5.7...v2.6.0