离线资料下载

BioF3 支持下载已预生成的静态资料。这个功能适合课程讲义、内部分享、归档和无网络环境阅读。

下载的 HTML 是单文件离线版：教程图片会内嵌到 HTML 里，文中的脚本下载按钮也会保留，点击后仍可下载对应脚本。

当前支持的下载

文档底部的“离线资料下载”区域提供五类入口：

入口	用途
本篇 HTML	下载当前文章的离线 HTML
本篇 PDF	下载当前文章的 PDF
手册 HTML	下载一个专题的合并手册 HTML
手册 PDF	下载一个专题的合并手册 PDF
打印本文	调用浏览器打印，必要时保存当前网页为 PDF

目前已生成专题：

• 基础入门手册
• 单细胞实践手册

用户怎么下载

打开任意已支持的文档，滚动到页面底部，找到“离线资料下载”区域：

1. 如果只想保存当前文章，点击“本篇 HTML”。
2. 如果想保存一整个专题，点击“手册 HTML”或“手册 PDF”。
3. 如果需要当前网页的 PDF，点击“打印本文”，在浏览器里选择“保存为 PDF”。

维护者怎么生成导出文件

文章 HTML 和专题 HTML/PDF 都是静态文件，需要在发布前生成。在项目根目录运行：

npm run export:docs

这个命令会生成两份导出文件：

• exports/：本地归档目录
• static/exports/：网站可访问目录

如果要在构建网站前自动刷新导出文件，运行：

npm run build:with-exports

导出文件位置

常用导出文件：

exports/basics/index.html
exports/basics/manual.pdf
exports/single-cell/index.html
exports/single-cell/manual.pdf

网站访问路径：

/BioF3/exports/basics/index.html
/BioF3/exports/basics/manual.pdf
/BioF3/exports/single-cell/index.html
/BioF3/exports/single-cell/manual.pdf

注意事项

• 用户点击下载的是 static/exports/ 里的静态文件。
• 文章 HTML 和专题 HTML/PDF 不是浏览器现场重新生成的，而是发布前由维护者生成。
• HTML 会内嵌教程图片和小型脚本下载内容，方便单个 HTML 文件离线阅读和分发。
• exports/assets/ 和 static/exports/assets/ 仍会保留原始图片、脚本副本，后续可以用于制作 ZIP 离线包。
• 修改文档、图片或脚本后，需要重新运行 npm run export:docs。
• PDF 由 Playwright 生成；如果浏览器内核缺失，运行 npx playwright install chromium。
• 大型原始数据不会打包进导出手册，只保留下载链接和教程说明。

后续计划

后续内容稳定后，可以继续加入：

• bulk RNA-seq 手册
• 基因组学手册
• 表观组学手册
• 蛋白质组学手册
• 多组学整合手册