本项目是一个基于 Astro 框架开发的个人博客网站,主要用于个人展示、技术文章发布和学习成果记录。项目旨在搭建一个简洁、易于维护、具有良好阅读体验的个人内容平台。
网站主要包含以下功能模块:
1. 首页展示:提供网站导航、个人介绍、最新文章展示等内容,方便访客快速了解网站。
2. 博客管理:通过 Markdown 文件维护文章内容,实现文章列表展示、文章详情访问和动态路由。
3. 响应式布局:针对电脑、平板和手机等不同屏幕尺寸进行页面适配,优化不同设备上的浏览体验。
4. 明暗主题:支持浅色与深色主题切换,统一管理页面颜色、背景及交互样式。
5. 代码高亮:使用 Shiki 实现文章代码块的语法高亮,并适配不同主题。
6. 公共组件:通过 Header、Footer、Layout 等组件组织页面结构,减少重复代码,提升维护效率。
项目主要面向个人博客和内容展示场景,可作为个人网站、技术博客等轻量级网站的开发实践案例。
本项目由我独立进行技术选型、页面开发、功能实现及调试优化,采用 Astro 作为核心开发框架,结合 HTML、CSS、JavaScript 和 Markdown 构建内容驱动型网站。
在整体架构方面,使用 Astro 组件化开发方式,将公共导航、页脚和页面布局分别封装为 Header、Footer 和 Layout 组件,并通过全局样式文件统一管理页面视觉规范。
在内容管理方面,使用 Astro Content Collections 配置博客内容集合,通过 Markdown 文件维护文章,并利用动态路由生成文章详情页面,实现文章列表与详情页面的关联。
在界面设计方面,使用 CSS 实现响应式布局、明暗主题切换、页面过渡效果和交互动画。通过 Shiki 配置不同主题下的代码高亮样式,改善技术文章的阅读体验。
开发过程中,曾遇到博客内容集合读取异常、Markdown 元数据格式错误及 Astro 版本 API 差异等问题。我通过检查项目配置、分析错误信息和调整代码逐步解决,最终使博客列表、文章详情及主题样式等核心功能正常运行。
通过该项目,我积累了从需求分析、技术选型、组件设计、页面开发到问题排查的完整实践经验,并持续优化网站的可维护性和用户体验。