Skip to content
MCSeekeriPublic

About

整合科学ADV系列所有衍生小说的站点——科学ADV图书馆

Topics

Resources

Stars

33 stars

Watchers

1 watching

Forks

Repository files navigation

科学 ADV 图书馆

科学 ADV 图书馆是收集科学 ADV 系列(《命运石之门》《混沌之子》《机器人笔记》等)小说、漫画、设定集与衍生资料的现代阅读站。作为科学 ADV 资源站的阅读端补充,本站专为长文本的网页排版与舒适阅读体验进行设计。

线上站点:https://lib.sci-adv.org 资源站:https://drive.sci-adv.org

Features / 功能

  • 文本检索引擎:集成 Pagefind 提供静态全文搜索,并接入 Cloudflare AI Search 提供智能辅助。
  • 现代阅读体验:支持深色模式、多语言文案切换、折叠区块、图片画廊以及文章内行号展示。
  • Markdown 拓展:集成 Expressive Code 渲染代码块,支持 KaTeX 渲染数学公式,并提供 GitHub 卡片及提示块组件。
  • 站点机制:内置阅读时间估算、文档大纲与目录、前后文翻页跳转,以及自动生成的 RSS 和 sitemap。
  • 读者交互:利用 Waline 提供轻量的文章评论功能。

Architecture / 架构

站点基于 Astro 的静态生成:内容以 Markdown 集合管理,构建时由 remark / rehype 插件管线处理数学公式、提示块、代码高亮与图片组件,再由 Tailwind CSS 完成排版;Pagefind 在构建结束后生成全文索引,Waline 负责评论。

配置集中在少数几个入口:站点与导航、评论、公告和 AI 搜索由统一配置管理;内容集合的字段约束由 schema 定义;组件、布局、路由、插件和本地化文案各自独立,便于按需替换。部署产物是纯静态文件,可以放在 GitHub Pages、Vercel 或任意静态托管上。

Installation / 安装

pnpm install

Usage / 使用

启动本地开发服务器,默认端口为 4321:

pnpm dev

构建后通过以下命令运行本地预览服务器:

pnpm preview

Testing / 验证

提交内容或代码前,建议运行项目预置的检查工具:

pnpm type-check   # TypeScript 严格检查声明
pnpm check        # Astro 内部状态检查
pnpm format       # Biome 统一写入格式
pnpm lint         # Biome 静态规则排查
pnpm build        # astro build 并生成 Pagefind 搜索索引

Deployment / 部署

站点提供两套互为备用的自动化部署流程:

  1. GitHub Pages(主力):推送 master 分支后,GitHub Actions 会拉取依赖、执行格式与类型检查,最后构建并发布静态产物。
  2. Vercel:仓库保留 Vercel 配置,可切换为 Vercel 托管,并对静态资源、搜索索引与内容资源分别设置长期不可变或短时重验证的缓存策略。

About

整合科学ADV系列所有衍生小说的站点——科学ADV图书馆

Topics

Resources

Stars

33 stars

Watchers

1 watching

Forks

Used by

Contributors

Languages