跳到正文
Sline

Shopify Dawn 与 SHOPLINE Bottle 主题架构对照

对照两套官方参考主题的定位、目录、模板语言、模块复用、主题编辑器与开发工作流,不使用主观评分决定胜负。

学习路径 4 / 6适合初级主题开发者最后核验:2026-07-28
本页目录

比较的正确前提

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 可以应对主题编辑器中的模块重渲染。
  • 所有平台对象和命令均来自目标平台当前官方文档。
  • 不使用星级、雷达分数或未经同环境测试的性能倍数做结论。
下一阶段SHOPLINE OS 2.1 到 OS 3.0 迁移指南

把架构差异转化为一份可执行的项目升级计划。

从语法认识到主题交付

完整路线

  1. 01认识 Sline

    理解对象、标签、过滤器与作用域。

  2. 02语法对照

    比较 Sline、Handlebars 与 Liquid。

  3. 03迁移实战

    将常见模板写法迁移到 Sline。

  4. 04主题架构

    对照 Dawn 与 Bottle 的组织方式。

  5. 05升级 OS 3.0

    规划主题、应用和内容迁移。

  6. 06CLI 工作流

    完成本地开发、检查与交付。