[{"value":"init","id":"init","hLevel":2,"level":1},{"value":"list","id":"ogVRk","hLevel":2,"level":1},{"value":"serve","id":"X1eER","hLevel":2,"level":1},{"value":"pull","id":"cuOwl","hLevel":2,"level":1},{"value":"push","id":"Gnj3S","hLevel":2,"level":1},{"value":"package","id":"yH4zB","hLevel":2,"level":1}]

主题命令

本文列出了 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。此链接指向你的开发主题，可以热重载对本地文件的更改，或在文件更改时刷新整个页面，允许你使用店铺的数据实时预览更改。
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/collection.temp.json` 通配符：`config/_secret.json`，`.jpg`
--nodelete	-n	运行 pull 命令，不删除本地文件。
--path <PATH>		你的主题目录路径。
--environment <ENV_NAME>	-e <ENV_NAME>	你想使用的环境。

push

将你的本地主题文件上传到店铺。

如果指定主题，则覆盖远程主题。如果未指定主题，则会提示你从店铺的主题列表中选择要覆盖的主题。

sl theme push

此命令返回以下信息：

你可以与他人共享的预览链接。
SHOPLINE 商家后台的主题编辑器链接。

可选参数

参数	缩写	描述
--theme		店铺主题 ID（可以通过 list 命令找到）。
--development	-d	推送到开发主题。如果你没有开发主题，则会创建一个。
--only	-o	仅推送指定的文件，可在单个命令中使用多次 `--only` 指定多个文件，支持以下格式：简单的文件名：`templates/collection.temp.json` 通配符：`config/_secret.json`，`.jpg`
--ignore	-x	跳过指定的文件推送，可在单个命令中使用多次 `--ignore` 指定多个文件，支持以下格式：简单的文件名：`templates/collection.temp.json` 通配符：`config/_secret.json`，`.jpg`
--nodelete	-n	将你的本地文件推送到 SHOPLINE，而不删除远程文件。
--allow-live	-a	允许 SHOPLINE CLI 覆盖已发布的主题。
--live	-l	推送到已发布主题。此选项无需 `--theme` 或 `--allow-live`。
--unpublished	-u	将主题上传到主题库，作为一个新的未发布主题。系统会提示你为主题提供一个名称。
--path <PATH>		你的主题目录工作路径。
--environment <ENV_NAME>	-e <ENV_NAME>	你想使用的环境。