4 套官方精调预设 · 与 dioxuspress init 同源同步

按场景选择开箱即用的 Starter 模板

每套模板均内置通过 Schema 校验的 site.json、精选双模主题、真实示例内容与 Docker Compose 编排。你可以从零数据库极简起步,未来随时无缝升级至全栈社区而无需重写任何 Markdown。

开源项目文档站

--template docs
零数据库 · basic

类 Docusaurus 左对齐顶栏 + 可关闭发布横幅 + 多卷三级折叠侧栏 + 嵌入式 Tantivy 毫秒级搜索,内置 GitHub Actions 死链与语法自动体检。

layout:"docs"theme:"emerald"适用:开源库文档、SDK / API 参考手册、团队内部技术 Wiki
  • ✓多卷(guide/ + api/)与三级嵌套侧栏示例
  • ✓附带 .github/workflows/check.yml 自动门禁
  • ✓单容器 ~30 MB 内存,无需任何数据库或密钥
dioxuspress init my-docs --template docs && cd my-docs && docker compose up -d
查看 templates/docs 目录源码 ↗

极简技术博客与数字花园

--template blog
零数据库 · basic

收起复杂导航噪音,采用暖羊皮纸 / 护眼深咖双模配色,原生支持服务端 LaTeX → MathML 公式推导、多语言代码对比标签组与标准 Atom 订阅源。

layout:"minimal"theme:"coffee"适用:独立开发者长文博客、算法/系统工程专栏、常青卡片笔记
  • ✓零客户端 JS 负担的服务端原生 MathML 数学公式
  • ✓突出展示 /feed.xml Atom 订阅源与 authors.yml 署名
  • ✓专栏长文(posts/)与常青笔记(docs/)双轨并存
dioxuspress init my-blog --template blog && cd my-blog && docker compose up -d
查看 templates/blog 目录源码 ↗

技术社区与共创讨论站

--template community
全栈社区 · PostgreSQL 16

一套部署编排串联 PostgreSQL 16 与社区应用:知识库、专栏文章、OAuth2 PKCE 安全登录、话题讨论区(/topics)与正文段落划线批注开箱即用。

layout:"classic"theme:"ocean"适用:开源社区官网、技术 SIG 讨论组、团队共创知识库
  • ✓GitHub / Google / Discord OAuth2 PKCE 登录指引
  • ✓文档与博客正文划词批注 + 底部关联讨论面板
  • ✓内置恶意链接域名黑名单与 /admin 审核管理后台
dioxuspress init my-community --template community && cd my-community && cp .env.example .env && docker compose up -d
查看 templates/community 目录源码 ↗

全栈知识与付费专栏门户

--template portal
商业闭环 · PostgreSQL 16

对齐 Rust in Everything 生产架构:完整启用结构化文档、免费试读/付费锁定实战课程、精选案例库、MDX 内嵌播客卡片、论坛与可选 LLM 风控。

layout:"classic"theme:"corporate"适用:商业化技术专栏、在线实战训练营、大型生态门户
  • ✓完整示范 course.yaml 定价、试读章节与服务端鉴权守卫
  • ✓预置 cases/ 精选案例库与 podcasts/ 音频卡片内嵌
  • ✓支持接入 Stripe / 微信支付及兼容 OpenAI 的自动审核
dioxuspress init my-portal --template portal && cd my-portal && cp .env.example .env && docker compose up -d
查看 templates/portal 目录源码 ↗

资源占用与数据依赖对比(零数据库 vs PostgreSQL)

四套预设共享完全一致的 Markdown 目录约定与 site.json 配置契约——从零数据库升级到全栈社区只需切换 Compose 镜像。

对比维度docsblogcommunityportal
官方容器镜像dioxuspress-basicdioxuspress-basicdioxuspress-appdioxuspress-app
外部数据库依赖无(纯文件只读挂载)无(纯文件只读挂载)PostgreSQL 16PostgreSQL 16
典型空闲内存占用~28–35 MB~25–32 MB~85 MB (incl. PG)~95 MB (incl. PG)
嵌入式全文搜索 (⌘K)✓ Tantivy✓ Tantivy✓ Tantivy✓ Tantivy
OAuth 登录 / 论坛 / 划线批注——✓✓
付费课程 / 案例库 / 播客电台———✓
尚未安装 dioxuspress CLI?仅需约 6 秒即可编译安装,或直接查阅 5 分钟快速开始指南。