Next.jsReact文档工具站

podlite-web — Next.js 文档模板

作者 podlite

基于 Next.js 的静态站点生成器，把 Podlite 标记语言和 Markdown 文档编译成静态网站，支持预设、挂载外部仓库、主题与 React 组件。

打开源站下载源码 ZIP

看看你的网站会是什么样

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

2 个预览视图

文档首页1 / 2

查看源码在新标签页打开

作者提供的预览

查看文档首页的内容组织、布局与视觉细节。

全部页面与视图 2

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

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

值得关注的模板亮点

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

把 Podlite 与 Markdown 文档编译为静态站点，页面地址来自 :puburl 或发布日期

everything 与 pubdate 两种预设，后者按发布日期控制文档是否发布

支持在 podlite-web.config.js 中挂载外部 Git 仓库作为内容来源，并可发布同一文档的多个版本

页面模板与 React 组件可放在内容目录旁按路径导入，无需独立包

内置 portrait-avatar、product、docs、minimal 四种主题，通过 :theme<> 选择

生成 sitemap.xml、rss.xml、robots.txt 与搜索索引，支持导出 zip、tgz 或输出目录

模板详细介绍

podlite-web 是一个用 Next.js 构建的静态站点生成器，内容以 Podlite 标记语言（也支持 Markdown 块）编写。它把内容目录中的文档编译成静态网站，每个页面通过 :puburl 获得固定地址，或根据发布日期生成地址。项目提供 everything 和 pubdate 两种预设：前者发布全部文档，后者只发布带发布日期且日期已过的文档，适合博客场景。

构建时可以挂载外部 Git 仓库作为内容来源，在 podlite-web.config.js 中声明 mounts，构建前先克隆这些仓库；同一文档的多个挂载可以发布为不同版本，并自动处理 canonical、noindex 和 sitemap。站点可以声明自己的页面模板，并把 React 组件放在内容旁边按路径导入，无需单独打包。主题通过 :theme<> 属性选择，内置 portrait-avatar、product、docs、minimal 四种。

输出方面会生成 sitemap.xml、rss.xml、robots.txt 并构建搜索索引，支持导出 zip、tgz 或留在 /app/out。官方提供 Docker 镜像，可在内容目录中直接运行开发服务器或执行导出。

Next.jsReact文档工具站

适合你的项目吗？

适用场景

用 Podlite 标记语言编写并发布个人博客，借助 pubdate 预设控制文章上线时间
搭建项目文档站，把规范、技能等外部仓库挂载为内容来源并发布多版本文档
在页面中嵌入 Podlite 编辑器并显示实时预览，用于在线编写与查看文档
把一组 Podlite 或 Markdown 文档导出为可部署的静态站点压缩包

适合人群

使用 Podlite 标记语言写作并希望发布为静态网站的作者
需要从多个 Git 仓库聚合内容并管理文档版本的文档维护者
希望在内容旁直接编写 React 组件与页面模板的前端开发者
习惯用 Docker 运行构建与导出流程的团队

上手与定制指南

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

1
运行开发服务器或导出时都必须提供 --preset，缺少会以 --preset undefined not valide 停止
2
内容只在服务器启动时处理一次，修改文档后需要重启容器，开发服务器只监听代码而非内容
3
使用挂载功能时 git 必须在 PATH 中，检出目录为构建旁的 .mounts/，可用 --offline 或 --mounts-only 控制
4
本地开发运行 yarn dev 会修改 package.json 的 workspaces 与 next.config.js，结束后用 yarn detach_path 还原
5
用作版本的挂载不能再设置 prefix，同时设置会导致构建停止

查看仓库使用说明