开始使用

欢迎来到 FlowPage FAQ

这里整理了最常见的问题和详细解答,帮助你快速上手。

常见问题

FlowPage 是什么?

FlowPage 是一个移动优先的内容发布平台,采用独特的垂直滚动 Block 设计,让阅读变得更加流畅自然。每个 Block 占据一屏,通过手势滑动切换内容。

为什么选择 FlowPage?

FlowPage 提供了极致的移动阅读体验,不同于传统的长文滚动,它让每个内容段落都有独立的视觉焦点。同时支持丰富的 Block 类型(FAQ、图片、轮播、时间线等),让内容更生动。

如何快速开始?

只需三步:1) 克隆仓库 2) 运行 npm install 3) 执行 npm run dev。然后在 content/pages/ 目录下创建你的第一篇 MDX 文章即可。

支持哪些 Block 类型?

目前支持 Hero、Standard、Quote、Timeline、Gallery、Cards、Stats、Video、FAQ 等多种类型,每种类型都有独特的视觉风格和交互效果。

如何使用 FAQ Block?

在 Markdown 中添加 {/* block: faq */} 注释,然后用 h3 标题作为问题,紧跟的段落作为答案。系统会自动生成可折叠的 FAQ 列表,并包含 SEO 友好的 JSON-LD 结构化数据。

移动端体验如何?

FlowPage 专为移动端设计,支持上下滑动翻页、左右滑动导航、双击点赞等手势操作。每个 Block 都经过精心优化,确保在小屏幕上也有出色的阅读体验。

是否支持 SEO 优化?

完全支持!FAQ Block 自动生成 Schema.org 结构化数据,可以在 Google 搜索结果中显示 Rich Snippets。此外,所有内容都是服务端渲染(SSR),对搜索引擎极其友好。

可以自定义样式吗?

当然可以!每个 Block 都提供了丰富的自定义选项,比如 Hero Block 支持 5 种渐变色、Quote Block 支持自定义颜色等。你也可以直接修改组件的样式文件。

技术相关

使用了哪些技术栈?

FlowPage 基于 Astro 构建,使用 TypeScript 开发,支持 MDX 内容格式。所有样式都是纯 CSS,无需额外的 UI 框架,确保最小的包体积和最快的加载速度。

如何部署到生产环境?

运行 npm run build 生成静态文件,然后可以部署到 Vercel、Netlify、Cloudflare Pages 等任何支持静态站点的平台。推荐使用 Vercel,可以实现自动部署和预览。

支持评论功能吗?

目前支持点赞和分享功能,评论功能可以集成 Giscus(基于 GitHub Discussions)或 Disqus 等第三方服务。

数据存储在哪里?

所有文章内容都以 MDX 文件形式存储在 content/pages/ 目录,图片资源放在 public/ 目录。点赞数据存储在浏览器本地 localStorage,阅读历史存储在 sessionStorage。

获取帮助

如果你还有其他问题,可以:

祝你使用愉快! 🎉