Skip to content

Ficorcc/Astrogon

Repository files navigation

Ficor Logo

GitHub License Repo Size

Ficor 是一个基于 Astro JS 和 Tailwind CSS 构建的简单优雅的中文博客主题,支持响应式设计和深色模式。

核心功能

内容管理

  • 博客系统
    • 支持分类和标签
    • 自动生成摘要
    • 阅读时间计算
    • 分页支持
    • 文章归档

页面布局

  • 首页:展示最新文章
  • 文章列表页:支持分类和标签筛选
  • 文章详情页:包含完整内容和阅读体验优化
  • 关于页面:展示博主信息
  • 友链页面:展示友情链接
  • 归档页面:按时间归档所有文章
  • 404页面:友好的错误页面

主题特性

  • ✅ 响应式设计,适配各种屏幕尺寸
  • ✅ 支持浅色/深色模式切换
  • ✅ 中文支持
  • ✅ 代码高亮
  • ✅ 阅读时间计算
  • ✅ 文章摘要自动生成
  • ✅ 社交网络集成
  • ✅ 性能优化
  • ✅ 简单易用的配置系统

技术栈

开发指南

环境要求

  • Node.js 22+(推荐使用 NVM 管理)
  • Git

快速开始

  1. 克隆仓库

    git clone https://github.com/panjinye/Ficor-Astro.git
    cd astrogon
  2. 安装依赖

    npm install
  3. 启动开发服务器

    npm run dev
  4. 在浏览器中打开 http://localhost:4321 查看效果

构建生产版本

npm run build

构建产物将生成在 dist 目录中。

配置说明

所有配置集中在 src/config/site.ts 文件中,包括:

  • 网站基本信息
  • 社交媒体链接
  • 主题设置
  • 内容配置
  • 功能开关

内容管理

博客文章

博客文章位于 src/content/blog/ 目录,使用 MDX 格式编写。

每篇文章需要包含以下 frontmatter:

---
title: 文章标题
description: 文章描述
date: 2024-01-01
categories: [分类1, 分类2]
tags: [标签1, 标签2]
draft: false
complexity: 1
---

友链管理

友链配置位于 src/config/links.ts 文件,支持分组和随机排序。

自定义主题

颜色方案

可以在 tailwind.config.js 中自定义主题颜色。

布局组件

主要布局组件位于 src/components/base/ 目录,可以根据需要修改。

部署

Cloudflare Workers

推荐使用 Cloudflare Workers 部署,配置如下:

npm run build
npx wrangler deploy

其他平台

也可以部署到 Vercel、Netlify 等静态站点托管平台。

许可证

本项目采用 MIT License 许可证。

致谢

本主题基于 Astrogon 模板修改而来,感谢原作者的贡献。

贡献

欢迎提交 Issue 和 Pull Request!

联系方式

About

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

 
 
 

Contributors