本文描述了如何使用saxa CLI创建自定义主题并将其应用于站点。saxa CLI是一个命令行工具,用于创建新的自定义主题。在建立网站时,创建主题并不是强制性的。
为什么自定义主题:
与主题相关的资产,例如CSS, SCSS和JavaScript文件,存储在Sitecore中,在Sitecore sax9.3之前。
saxa CLI提供了决定需要上传哪些必要文件的控件。避免在Sitecore Media Library中维护不必要的文件。
所有的源文件和主题资产都可以使用像GIT这样的源代码控制与Sitecore分开保存。
Creative Exchange Live工装现在可以作为NPM包使用,它可以帮助创建自定义主题。
先决条件:
你需要在你的系统中安装最新的Node JS才能使用这个工具。如果您没有Node JS,请从-下载https://nodejs.org/en/download/
在我的例子中,Node JS版本:v12.14.1
主题设置:
saxa CLI是一个有用的命令行工具,可以自动执行saxa项目的任务。介绍如何通过saxa CLI添加主题。如果您希望对资产有更多的控制并使用版本控制系统,这将非常方便。
使用saxa CLI创建主题:
- 去-
inetpub \ wwwroot \ < Your_Website > \ App_Config \ \ z.Feature.Overrides并启用z.SPE.Sync.Enabler.Gulp.config.disabled文件。
要启用此文件,请右键单击该文件,然后重命名并删除".disabled”。 打开一个ADMIN角色的命令提示终端,安装注册表:
npm配置设置@ xa:注册表=https://sitecore.myget.org/F/sc-npm-packages/npm/在CMD下执行以下命令,全局安装saxa CLI npm包:
npm i -g @ saxa /CLI现在执行——saxa寄存器
为< url >,输入要为其创建主题的实例。
在我的例子中,URL是-https://prftsc.dev.local执行-saxa new
Npm将提示一些问题,如登录名,密码,主题名称,主题路径。
如果你回答是的对于这个问题您想要设置主题配置文件吗?时,配置文件会自动更新。
输入主题路径:< Rootfoldername > / < Childfoldername >.
< Rootfoldername >而且< Childfoldername >一般为创建站点时以“租户名称”和“站点名称”创建的Media library中Themes文件夹下的文件夹。
7.现在将目录更改为包含新主题的文件夹:
cd < ThemeName >
8.执行npm我
这个命令将安装package.json中提到的所有npm包。
9.您的新主题现在可用。确保将你的新主题分配给你的网站:
转到Sitecore/Content/
注意:上述步骤可以在站点核心文档(https://doc.sitecore.com/developers/sxa/93/sitecore-experience-accelerator/en/add-a-theme-using-sxa-cli.html)
活动主题:
如欲将主题应用于本网站,请按以下步骤操作:
- 转到
/ >,单击“设置”节点: - 在右侧,找到“站点配置”:
- 在兼容的主题部分,向下滚动一点在所有部分,直到你找到主题文件夹,在文件夹下找到你的主题文件夹,选择你已经创建的主题,双击它,这样它就应该被选中并添加到右侧。
- 现在新创建的主题可以在页面设计中选择:
- 现在新主题已经全部设置好了。进入我们在命令提示符中创建的Theme目录,并运行command - " gulp "命令。它将要求输入站点核心登录详细信息。
- 它会监视你的CSS或JS的变化,无论何时你做了任何改变,它都会被编译,你的CSS或JS文件的缩小版本将被上传到sitecore。
到目前为止,我们已经了解了如何使用saxa CLI创建自定义主题,以及如何将其应用到站点。它可以很容易地分离要上传的不必要的代码。