Node.js >= 20 pnpm >= 9 DeepWiki FOSSA Status

A static blog template built with Astro.

🖥️ Live Demo (Vercel)

Preview Image

🌏 README in 中文 / 日本語 / 한국어 / Español / ไทย / Tiếng Việt (Provided by the community and may not always be up-to-date)

• Built with Astro and Tailwind CSS
• Smooth animations and page transitions
• Light / dark mode
• Customizable theme colors & banner
• Responsive design
• Search functionality with Pagefind
• Markdown extended features
• Table of contents
• RSS feed

1. Create your blog repository:

   • Generate a new repository from this template or fork this repository.
   • Or run one of the following commands:

   Fuwari — 可定制的 Astro 静态博客模板

   一个基于 Astro + Tailwind 的轻量、可配置的个人博客模板,集成了搜索、暗/亮主题、目录与扩展的 Markdown 支持,适合用来搭建技术或个人博客。

   演示站点:https://fuwari.vercel.app

   特性

   • 基于 Astro(静态站点生成)与 Tailwind CSS
   • 响应式设计、暗/亮模式切换
   • 页面过渡与流畅的交互动画
   • 本地全文搜索(Pagefind)支持
   • 扩展的 Markdown 功能(提示框、GitHub 仓库卡片、增强代码块)
   • 自动生成目录、RSS 输出

   快速开始

   1. 克隆仓库到本地:

   git clone https://github.com/saicaca/fuwari.git
   cd fuwari

   2. 安装依赖(推荐使用 pnpm):

   npm install -g pnpm
   pnpm install

   3. 本地开发:

   pnpm dev
   # 在浏览器打开 http://localhost:4321

   4. 构建与预览:

   pnpm build
   pnpm preview

   配置

   主要配置文件位于 src/config.ts. 修改该文件可设置站点标题、语言、社交链接、主题色等。

   文章内容存放在 src/content/posts/。使用 pnpm new-post <文件名> 可以快速创建文章模板。

   文章 Frontmatter 示例:

   ---
   title: 我的第一篇文章
   published: 2024年01月01日
   description: 文章摘要
   image: ./cover.jpg
   tags: [示例]
   category: 技术
   draft: false
   lang: zh
   ---

   部署

   适配 Vercel、Netlify、Cloudflare Pages 等静态站点平台。部署前请根据目标平台调整 astro.config.mjs 与构建设置。

   项目结构(简要)

   • src/:站点源码(页面、组件、内容、样式)
   • public/:静态资源
   • package.json:脚本与依赖

   具体实现细节和插件位于 src/plugins/、src/components/ 等目录。

   贡献与问题反馈

   欢迎提交 Issue 或 Pull Request。贡献指南见 CONTRIBUTING.md。

   许可证

   本项目采用 MIT 许可证。详见 LICENSE 文件。

   ---

   如果你希望我把 README 翻译为其它语言、补充更多部署示例或增加快速配置步骤,我可以继续完善。