AstroReact作品集博客

mirsazzathossain.me — Astro 作品集模板

作者 mirsazzathossain

一个基于 Astro 的学术作品集与博客站点源码，使用 React 交互岛、Tailwind CSS 和 MDX 内容集合，包含出版物数据同步与 Vercel 部署配置。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

3 个预览视图
桌面端首页1 / 3
桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 3

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-09-29查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

01

Astro 静态输出配合 Vercel 适配器，交互部分以 React 岛实现

02

使用 Tailwind CSS 与 MDX 内容集合组织页面与文章

03

出版物数据分为生成文件与人工覆盖文件，避免直接修改生成字段

04

内置 giscus 评论、remark-math 与 rehype-katex 数学公式支持

05

包含每周同步 Google Scholar 出版物与引用数据的 GitHub Actions 工作流

模板详细介绍

这是作者 mirsazzathossain.me 个人学术作品集与研究网站的源码，采用 Astro 静态输出并配合 Vercel 适配器，交互部分以 React 岛实现，样式基于 Tailwind CSS，内容通过 Astro 内容集合与 MDX 管理。站点包含出版物、项目、资源、课程、CV 与个人资料等模块，数据以构建期 JSON 形式存放在 src/data 目录。

出版物数据被有意拆分：publications.json 为面向 Google Scholar 的生成数据，publications.override.json 用于人工修正、BibTeX、PDF、等级、会议引用、功能开关和手动条目，publication_stats.json 保存站点使用的统计摘要。README 明确提示不要直接编辑生成字段，应通过 override 文件补充。仓库还包含两个 GitHub Actions 工作流，分别用于推送与拉取请求的构建检查，以及每周同步 Google Scholar 的出版物与引用数据。

站点集成 giscus 评论、remark-math 与 rehype-katex 数学公式渲染，以及 Vercel Analytics 和 Speed Insights。部署目标为 Vercel，构建命令为 npm run build，输出目录为 dist。若克隆或 fork 该仓库，需要替换 src/data、src/content、public/images、public/files 中的个人内容，并修改布局与配置文件中的站点元数据。

AstroReact作品集博客

适合你的项目吗？

适用场景

  • 搭建个人学术作品集，展示出版物、项目、课程与 CV
  • 作为带 MDX 文章与数学公式的博客站点基础
  • 参考 Astro + React 岛 + Tailwind 的静态站点组织方式
  • 需要将 Google Scholar 出版物数据定期同步到站点的场景

适合人群

  • 有 Astro 或前端构建经验、希望自建学术主页的研究者
  • 需要 MDX 写作与数学公式渲染的个人博客作者
  • 计划部署到 Vercel 并接受手动替换个人内容的开发者

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

  1. 1

    运行 npm install 安装依赖，npm run dev 启动本地开发服务器（默认 http://localhost:4321）

  2. 2

    使用 npm run build 生成生产构建，npm run preview 本地预览构建结果

  3. 3

    部署到 Vercel 时构建命令为 npm run build，输出目录为 dist，安装命令为 npm install，项目根目录为仓库根目录

  4. 4

    克隆或 fork 后需替换 src/data、src/content、public/images、public/files 中的个人内容，并修改布局与配置文件中的站点元数据

  5. 5

    出版物修正应写入 src/data/publications.override.json，不要直接编辑 publications.json 中的生成字段

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中的免费 MIT 版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

  • 使用、修改或分发代码时，保留原作者版权声明和完整 MIT 许可证。
  • 允许免费使用、修改及商用，也允许分发代码；分发时仍需随附版权与许可声明。
  • 代码按现状提供，作者不承诺担保或承担使用责任。

额外费用与待核对事项

  • 评论功能依赖第三方服务 giscus，需在 giscus.app 配置并关联 GitHub 仓库，属于外部服务依赖。
  • 站点集成 Vercel Analytics 与 Speed Insights，使用这些分析功能需部署在 Vercel 并可能受其服务条款约束。
  • 每周同步 Google Scholar 出版物与引用数据的工作流依赖 Google Scholar 抓取，可能受其访问限制影响。
  • 克隆或 fork 后必须替换 src/data、src/content、public/images、public/files 中的个人内容及站点元数据，否则会发布作者的个人信息。
  • 出版物生成字段不应手动编辑，修正需写入 publications.override.json，否则可能被同步流程覆盖。
  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

Comments: [giscus](https://giscus.app/)

README 原文

Analytics: Vercel Analytics and Speed Insights

README 原文

Weekly Google Scholar publication and citation sync

README 原文

If you clone or fork this repository, replace the personal content before publishing

README 原文

Do not hand-edit generated publication fields in `publications.json`.

README 原文
https://github.com/mirsazzathossain/mirsazzathossain.me/blob/main/LICENSEhttps://github.com/mirsazzathossain/mirsazzathossain.me/blob/main/README.md

依据完整 MIT 许可证与仓库 README 核对 · 2026-09-29。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料较完整 · 96 / 100
技术栈
Astro · React
网站类型
作品集 · 博客
这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间
2026-09-29
截图检查日期
2026-09-29

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Astro。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: 6dbb9b71214de272c4409ae40097c06f87eeb441d62a164291c168d6b4c9a343

2026-09-29T01:11:55.002Z

来源文件 / 仓库
![Tech Stack](public/images/msh-nextjs.png)

## mirsazzathossain.me

![website status](https://img.shields.io/website?down_color=red&down_message=offline&up_color=green&up_message=online&url=https%3A%2F%2Fmirsazzathossain.me&style=flat-square) ![GitHub](https://img.shields.io/github/license/mirsazzathossain/mirsazzathossain.me?style=flat-square) ![GitHub last commit](https://img.shields.io/github/last-commit/mirsazzathossain/mirsazzathossain.me?style=flat-square) ![GitHub repo size](https://img.shields.io/github/repo-size/mirsazzathossain/mirsazzathossain.me?style=flat-square) ![GitHub top language](https://img.shields.io/github/languages/top/mirsazzathossain/mirsazzathossain.me?style=flat-square)

Source code for [mirsazzathossain.me](https://mirsazzathossain.me), my academic portfolio and research website. The site is built with [Astro](https://astro.build/), interactive [React](https://react.dev/) islands, [Tailwind CSS v4](https://tailwindcss.com/), and MDX content collections.

## Stack

- Framework: [Astro](https://astro.build/) with static output and the Vercel adapter
- UI islands: [React](https://react.dev/)
- Styling: [Tailwind CSS](https://tailwindcss.com/) v4
- Content: Astro content collections and MDX
- Math: `remark-math` and `rehype-katex`
- Comments: [giscus](https://giscus.app/)
- Deployment: [Vercel](https://vercel.com/)
- Analytics: Vercel Analytics and Speed Insights

## Project Structure

- `src/pages/*`: Astro routes.
- `src/components/*`: Astro and React components.
- `src/content/*`: MDX posts and snippets.
- `src/data/*`: Build-time JSON data for publications, projects, resources, courses, CV, and profile sections.
- `src/styles/*`: Tailwind entry point and global site layers.
- `src/utils/*`: Shared data, formatting, and content utilities.
- `public/*`: Static assets such as images, icons, PDFs, and the web manifest.
- `.github/workflows/ci.yml`: Build check for pushes and pull requests.
- `.github/workflows/update-publications.yml`: Weekly Google Scholar publication and citation sync.
- `vercel.json`: Vercel deployment settings for Astro.

## Publication Data

Publication data is split intentionally:

- `src/data/publications.json`: generated Scholar-facing publication data.
- `src/data/publications.override.json`: user-managed overrides and manual publication entries.
- `src/data/publication_stats.json`: publication summary stats used by the site.

Do not hand-edit generated publication fields in `publications.json`. Add corrections, BibTeX, PDFs, ranks, venue citations, feature flags, and manual papers in `publications.override.json`.

## Development

Install dependencies:

```bash
npm install
```

Start the local dev server:

```bash
npm run dev
```

Open [http://localhost:4321](http://localhost:4321).

Create a production build:

```bash
npm run build
```

Preview the production build locally:

```bash
npm run preview
```

## Deployment

The site is deployed on Vercel. The important settings are:

- Build command: `npm run build`
- Output directory: `dist`
- Install command: `npm install`
- Project root: repository root

## Forking

If you clone or fork this repository, replace the personal content before publishing:

- `src/data/*`
- `src/content/*`
- `public/images/*`
- `public/files/*`
- site metadata in the layout/config files
反馈内容错误

看看同类模板

对比同技术栈与用途的模板，找到更适合的视觉与内容结构。

astrowind

astrowind

⭕️ AstroWind: A free template using Astro v7 and Tailwind CSS v4. Astro starter theme.

Astro · 博客

astro-paper

astro-paper

A minimal, accessible and SEO-friendly Astro blog theme.

Astro · 博客

fuwari

fuwari

✨A static blog template built with Astro.

Astro · 博客

Firefly

Firefly

Firefly 是一款基于 Astro 的静态博客主题，由 CuteLeaf 在 saicaca 的 Fuwari 模板基础上二次开发，主打清新美观的视觉风格。

Astro · 博客

astro-theme-cactus

astro-theme-cactus

A simple Astro theme. Use it to create your blog or website.

Astro · 作品集

astrofy

astrofy

Astrofy is a free and open-source template for your Personal Portfolio Website built with Astro and TailwindCS…

Astro · 作品集