主题命令
此章节列出了你可以与 SHOPLINE CLI 一起使用的的主题命令。主题命令使用的语法是 sl theme [command]。
要从命令行访问任何这些命令的帮助,请使用 sl [command] -h。
init
初始化主题,将从 Github 拉取到本地计算机sl theme init <THEME_NAME>
可选参数
| 参数 | 是否必填 | 描述 |
|---|---|---|
| THEME_NAME | 是 | 你要为主题指定名称。克隆文件存储在具有此名称的文件夹中。 主题名称可以为以下形式: + demo-theme:将会在当前文件夹中新建文件夹存储新主题文件,主题名作为文件夹名。+ 也可以是相对路径形式 ../shopline/demo-theme:将会根据输入的路径和当前运行路径,新建文件夹存储新主题文件,主题名为路径的 basename。 |
| --path <PATH> | 否 | 你的主题目录工作路径。 |
list
列出当前登录店铺的所有主题,包括 ID、名称、状态等。sl theme list
serve
将当前本地主题作为开发主题上传到你连接的店铺,并且进行实时预览开发。sl theme serve
此命令还返回以下信息:
- 本地预览链接:
http://127.0.0.1:8282此链接指向你的开发主题的链接。此 URL 可以热重新加载对本地文件的更改,或在文件更改时刷新整个页面,允许你使用店铺的数据实时预览更改。 - SHOPLINE 后台中主题编辑器的链接
- 你可以与其他开发人员共享的预览链接
如果你已经有当前环境的开发主题,那么此命令会将开发主题替换为你的本地主题。
提示:你无法使用 http://127.0.0.1:8282 预览结账页
注意:
- 当运行
sl logout命令时会删除开发中主题。 - 你只能在与 默认 SHOPLINE 主题目录结构 匹配的目录中运行此命令。
可选参数
| 参数 | 缩写 | 描述 |
|---|---|---|
| --port <PORT> | 指定主题预览的本地端口 默认值:8282 | |
| --live-reload <MODE> | 对主题进行更改时重新加载内容的级别。 接受以下值: - full-page- 修改文件时刷新整个页面(默认) - off- 停用实时刷新,任何文件的改动都将不刷新整个页面 | |
| --theme-editor-sync | 为主题 JSON 文件启用双向同步。启用此选项后,在 SHOPLINE 后台的模版编辑器中所做的更改将应用于模版的本地副本。 | |
| --only | -o | 仅拉取指定的文件,可在单个命令中使用多次 --only指定多个文件,支持以下格式: + 简单的文件名: templates/collection.temp.json+ 通配符: config/*_secret.json, *.jpg |
| --ignore | -x | 跳过指定的文件拉取,可在单个命令中使用多次 --ignore指定多个文件,支持以下格式: + 简单的文件名: templates/product.temp.json+ 通配符: config/*_secret.json, *.jpg |
| --path <PATH> | 你的主题目录工作路径。 | |
| --environment <ENV_NAME> | -e <ENV_NAME> | 你想使用的环境配置。 |
pull
从店铺获取主题文件 如果未指定主题,则会提示你选择要从店铺中的主题列表中选择主题。 若当前目录非空时,CLI 将提供两个选项给开发者选择:- 覆盖同名文件(默认)
- 清空当前目录后,拉取主题文件
sl theme pull
可选参数
| 参数 | 缩写 | 描述 |
|---|---|---|
| --theme | 店铺主题 id(可以通过 list 命令获取) | |
| --live | -l | 拉取已发布主题 |
| --development | -d | 下载远程开发主题代码到本地。 |
| --only | -o | 仅拉取指定的文件,可在单个命令中使用多次 --only指定多个文件,支持以下格式: + 简单的文件名: templates/collection.temp.json+ 通配符: config/*_secret.json,*.jpg |
| --ignore | -x | 跳过指定的文件拉取,可在单个命令中使用多次 --ignore指定多个文件,支持以下格式: + 简单的文件名: templates/product.temp.json+ 通配符: config/*_secret.json,*.jpg |
| --nodelete | -n | 运行 pull 命令,不删除本地文件。 |
| --path <PATH> | 你的主题目录路径。 | |
| --environment <ENV_NAME> | -e <ENV_NAME> | 你想使用的环境。 |
push
将你的本地主题文件上传到店铺。如果指定主题,则覆盖远程主题。如果未指定主题,则会提示你从店铺中的主题列表中选择要覆盖的主题。
sl theme push
此命令返回一下信息:
- 你可以与他人共享的预览链接。
- 店铺后台的主题编辑器链接。
可选参数
| 参数 | 缩写 | 描述 |
|---|---|---|
| --theme | 店铺主题 id(可以通过 list 命令找到) | |
| --development | -d | 推送到开发主题。如果你没有开发主题,则会创建一个。 |
| --only | -o | 仅推送指定的文件,可在单个命令中使用多次 --only指定多个文件,支持以下格式:+ 简单的文件名: templates/product.temp.json+ 通配符: config/*_secret.json,*.jpg |
| --ignore | -x | 跳过指定的文件推送,可在单个命令中使用多次 “--ignore”指定多个文件,支持以下格式: + 简单的文件名: templates/product.temp.json+ 通配符: config/*_secret.json,*.jpg |
| --nodelete | -n | 将你的本地文件推送到 SHOPLINE,而不删除远程文件。 |
| --allow-live | -a | 允许 SHOPLINE CLI 覆写已发布的主题。 |
| --live | -l | 推送到已发布主题。此选项无需--theme或--allow-live。 |
| --unpublished | -u | 将主题上传到主题库,作为一个新的未发布主题。 系统会提示你为主题提供一个名称。使用 --theme 参数将名称作为命令的一部分提供。 |
| --path <PATH> | 你的主题目录工作路径。 | |
| --environment <ENV_NAME> | -e <ENV_NAME> | 你想使用的环境。 |
package
将你的本地主题文件打包成可以上传到 SHOPLINE 店铺的 zip 文件。zip 文件中仅包含与默认 SHOPLINE 主题目录结构匹配的文件夹。
ZIP 文件名使用theme_name-theme_version.zip根据 theme.schema.json 文件中使用的参数生成。
sl theme package
可选参数
| 参数 | 描述 |
|---|---|
| --path <PATH> | 你的主题目录工作路径。 |
这篇文章对你有帮助吗?