Sitecore

在Sitecore 9.3中使用saxa CLI设置saxa 10主题

Javascript Laptop@1x.jpg

本文描述了如何使用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

主题设置:

站点核心——理解开发方法:站点核心展望
理解开发方法:站点核心展望

设计、构建和实现一流的体验不仅需要大量的计划、策略和时间,还需要正确的数字体验平台(DXP)和适合您业务需求的正确开发方法。

获取指南

saxa CLI是一个有用的命令行工具,可以自动执行saxa项目的任务。介绍如何通过saxa CLI添加主题。如果您希望对资产有更多的控制并使用版本控制系统,这将非常方便。

使用saxa CLI创建主题:

  1. 去-
    inetpub \ wwwroot \ < Your_Website > \ App_Config \ \ z.Feature.Overrides并启用z.SPE.Sync.Enabler.Gulp.config.disabled文件。
    要启用此文件,请右键单击该文件,然后重命名并删除".disabled”。

  2. 打开一个ADMIN角色的命令提示终端,安装注册表:
    npm配置设置@ xa:注册表=https://sitecore.myget.org/F/sc-npm-packages/npm/

  3. 在CMD下执行以下命令,全局安装saxa CLI npm包:
    npm i -g @ saxa /CLI

  4. 现在执行——saxa寄存器
    < url >,输入要为其创建主题的实例。
    在我的例子中,URL是-https://prftsc.dev.local

  5. 执行-saxa new

  6. Npm将提示一些问题,如登录名,密码,主题名称,主题路径。
    如果你回答是的对于这个问题您想要设置主题配置文件吗?时,配置文件会自动更新。
    输入主题路径:< Rootfoldername > / < Childfoldername >
    < Rootfoldername >而且< Childfoldername >一般为创建站点时以“租户名称”和“站点名称”创建的Media library中Themes文件夹下的文件夹。

创建主题

7.现在将目录更改为包含新主题的文件夹:

cd < ThemeName >

8.执行npm我

这个命令将安装package.json中提到的所有npm包。

9.您的新主题现在可用。确保将你的新主题分配给你的网站:

转到Sitecore/Content///Settings,然后在site Configuration Settings中,在Compatible Themes字段中将新主题添加到Selected字段。现在您的主题被选择为站点的当前主题。

注意:上述步骤可以在站点核心文档(https://doc.sitecore.com/developers/sxa/93/sitecore-experience-accelerator/en/add-a-theme-using-sxa-cli.html

活动主题:

如欲将主题应用于本网站,请按以下步骤操作:

  1. 转到/ >,单击“设置”节点:
    应用主题步骤1
  2. 在右侧,找到“站点配置”:
    应用主题步骤2
  3. 在兼容的主题部分,向下滚动一点在所有部分,直到你找到主题文件夹,在文件夹下找到你的主题文件夹,选择你已经创建的主题,双击它,这样它就应该被选中并添加到右侧。
    应用主题步骤3
  4. 现在新创建的主题可以在页面设计中选择:
    应用主题步骤4
  5. 现在新主题已经全部设置好了。进入我们在命令提示符中创建的Theme目录,并运行command - " gulp "命令。它将要求输入站点核心登录详细信息。
    应用主题步骤5
  6. 它会监视你的CSS或JS的变化,无论何时你做了任何改变,它都会被编译,你的CSS或JS文件的缩小版本将被上传到sitecore。
    应用主题步骤6

到目前为止,我们已经了解了如何使用saxa CLI创建自定义主题,以及如何将其应用到站点。它可以很容易地分离要上传的不必要的代码。

留下回复

这个网站使用Akismet来减少垃圾邮件。了解如何处理您的评论数据

Pankaj Joshi

Pankaj是一名助理技术顾问,目前在Sitecore平台上作为navigstar团队的前端开发人员工作。他喜欢学习和探索新的JS框架,并与团队分享知识。

更多来自作者

订阅每周博客文摘:

报名
类别
关注我们
推特 Linkedin 脸谱网 Youtube Instagram