比较的正确前提
Dawn 和 Bottle 都是各自平台的官方参考主题,但服务于不同运行环境:
- Dawn 是 Shopify 的 source-available 参考主题,面向 Shopify Online Store,并由 Liquid 在 Shopify 服务器端渲染。
- Bottle 是 SHOPLINE Online Store 3.0 的基础主题,使用 Sline;SHOPLINE 表示其 OS 3.0 主题以 Bottle 为基础发展。
因此,这不是“把一个主题上传到另一个平台”的选择题。更有价值的问题是:两套主题如何划分文件责任,如何把商家配置转成页面,以及开发者应迁移哪些工程习惯。
官方定位与设计原则
| 维度 | Shopify Dawn | SHOPLINE Bottle |
|---|---|---|
| 官方角色 | Shopify 的参考主题与主题开发起点 | SHOPLINE OS 3.0 的基础主题 |
| 模板语言 | Shopify Liquid | Sline |
| 公开原则 | HTML first、按需使用 JavaScript、渐进增强、服务器渲染 | 轻量设计、图片加载优化、模块化目录、多级 block |
| 商家定制 | JSON template、section、block 与主题编辑器 | template、section、block、schema 与主题编辑器 |
| 源码 | Shopify/Dawn 官方仓库 | shoplineos/Bottle 官方仓库或 SHOPLINE Theme shop |
表中的“原则”是两边官方材料的自我描述,不是统一测试环境下的性能结论。
目录结构对照
Dawn 常见目录
.
├── assets
├── blocks
├── config
├── layout
├── locales
├── sections
├── snippets
└── templates
Bottle / OS 3.0 标准目录
.
├── blocks
├── components
├── i18n
├── layout
├── public
├── sections
├── templates
├── theme.config.json
└── theme.schema.json
主要对应关系:
| 责任 | Dawn / Shopify | Bottle / SHOPLINE |
|---|---|---|
| 静态资源 | assets |
public |
| 多语言 | locales |
i18n |
| 纯代码复用 | snippets |
components |
| 页面骨架 | layout |
layout |
| 页面类型 | templates |
templates |
| 可配置模块 | sections、blocks |
sections、blocks |
| 全局主题配置 | config 下的设置文件 |
theme.config.json 与 theme.schema.json |
目录相似不代表文件可以直接搬运。Liquid/Sline 语法、schema 结构、对象模型和平台事件仍需逐一重写。
Template、section 与 block
两套系统都让商家在主题编辑器中组合页面,但边界定义不同。
Dawn / Shopify
Shopify section 是可配置的 Liquid 模块,可以进入 JSON template 或 section group。block 可以是:
- 放在
/blocks中、可跨 section 使用的 theme block。 - 直接定义在某个 section 中的 section block。
- 由应用提供的 app block。
snippet 用来复用标记和模板逻辑,但不会像 block 一样直接成为商家可配置实例。
Bottle / SHOPLINE
SHOPLINE OS 3.0 把页面分为 layout、page template、section group、section、private block 与 public block。component 用于可重复的公共代码片段;section 和 block 承担主题编辑器中的配置与组合责任。
需要细看 SHOPLINE 的 section 文件、schema、分组和固定模块时,可继续阅读 OS 3.0 Sections 概述。
配置文件和商家数据
Bottle 的两个根级配置文件职责分开:
theme.schema.json定义主题信息和全局可配置项。theme.config.json保存默认样式、商家全局配置、固定 section 配置和多套预设。
Dawn 的主题设置位于 config 目录,页面 section 顺序与设置主要存储在 JSON template 或 section group 中。迁移时要把“定义控件”和“保存配置值”分别映射,不能只比较文件扩展名。
JavaScript 与编辑器交互
Dawn 官方强调 JavaScript only as needed。Shopify section 在主题编辑器中可能被动态添加、移除或重新渲染,因此页面初始化脚本不能只假设运行一次。
Bottle 提供主题事件以及 section/block 模块。自定义 JavaScript 同样应该跟随模块生命周期,避免把整站行为写进一个无法感知编辑器变化的全局脚本。
共同的工程原则是:
- HTML 与模板数据先完成核心功能。
- JavaScript 用于增强,而不是补救缺失结构。
- 模块拥有自己的样式和行为边界。
- 编辑器重新渲染后,交互仍能正确初始化和清理。
开发工具对照
| 任务 | Dawn / Shopify | Bottle / SHOPLINE |
|---|---|---|
| 本地主题工具 | Shopify CLI | SHOPLINE CLI |
| 主题参考源码 | Shopify/dawn |
shoplineos/Bottle |
| 模板检查 | Dawn 官方工作流使用 Theme Check | 以当前 SHOPLINE CLI 官方命令参考为准 |
| 持续集成 | Dawn 仓库使用 GitHub Actions | 可按项目需要为 Bottle 派生主题配置 CI |
不要因为旧教程提到某个命令,就假设当前 CLI 仍支持。实际工作前先运行 CLI 帮助并对照最新官方命令页。
如何选择参考方式
如果项目运行在 Shopify,Dawn 是更直接的参考;如果项目运行在 SHOPLINE OS 3.0,Bottle 才是正确起点。跨平台迁移时,可以借鉴共同的模块化思想,但必须重建:
- 模板语言与对象访问。
- schema 与配置存储。
- section/block/component 边界。
- 应用扩展与平台事件。
- CLI、预览和发布流程。
架构复核清单
- 每个文件只承担一种主要职责。
- 商家可配置内容进入 section/block/schema,而不是写死在 component。
- 纯标记复用进入 snippet 或 component,不冒充编辑器模块。
- 页面结构由 template 组织,站点骨架由 layout 负责。
- JavaScript 可以应对主题编辑器中的模块重渲染。
- 所有平台对象和命令均来自目标平台当前官方文档。
- 不使用星级、雷达分数或未经同环境测试的性能倍数做结论。
把架构差异转化为一份可执行的项目升级计划。