添加Clientlibs

添加ClientLibraryFolder(clientlibs)

创建名为clientlibs的ClientLibraryFolder，其中将包含用于呈现网站页面的JS和CSS。

给此客户端库的categories属性值是用于从内容页面直接包含此clientlib或将其嵌入到其他clientlib的标识符。

1. 使用​CRXDE Lite，展开/etc/designs

2. 右键单击an-scf-sandbox并选择Create Node

   • 名称 : clientlibs
   • 类型 : cq:ClientLibraryFolder

3. 单击​确定

在新clientlibs节点的​属性​选项卡中，输入​类别​属性：

• 名称：类别
• 类型：字符串
• 值：apps.anscf-sandbox
• 单击​Add
• 单击​Save All

注意：使用“apps”为类别值添加前缀。 是将“拥有的应用程序”标识为位于/apps文件夹中，而不是/libs中的约定。 重要信息：添加占位符js.txt和​css.txt​文件。 （没有cq:ClientLibraryFolder，它不是正式的。）

1. 右键单击​/etc/designs/an-scf-sandbox/clientlibs
2. 选择​创建文件……
3. 输入​名称： css.txt
4. 选择​创建文件……
5. 输入​名称： js.txt
6. 单击​Save All

css.txt和js.txt的第一行用于标识可从中找到以下文件列表的基本位置。

尝试将css.txt的内容设置为

#base=.
 style.css

然后，在名为style.css的clientlibs下创建文件，并将内容设置为

body {

background-color: #b0c4de;

}

嵌入SCF Clientlibs

在​Properties​选项卡的clientlibs节点中，输入多值String属性​embed。 这为SCF组件🔗嵌入了必需的客户端库(clientlibs)。 在本教程中，添加了社区组件所需的许多clientlib。

​​请注意，这可能是生产站点所需的方法，也可能不是，因为考虑到了方便性与为每个页面下载的clientlib的大小/速度。

如果在一个页面上仅使用一项功能，则可以直接在页面上包含该功能的完整clientlib，例如

% ui:includeClientLib categories=cq.social.hbs.forum" %

在本例中，包括所有这些SCF客户端，因此更基本的SCF客户端库是作者的客户端库：

• 名称 : embed

• 类型 : String

• 单击 Multi

• 值: cq.social.scf

  • 会弹出一个对话框，
    单击每个条目后的​+​以添加以下clientlib类别：

    • cq.ckeditor
    • cq.social.author.hbs.comments
    • cq.social.author.hbs.forum
    • cq.social.author.hbs.rating
    • cq.social.author.hbs.reviews
    • cq.social.author.hbs.voting
    • 单击​确定

• 单击​Save All

下面显示了/etc/designs/an-scf-sandbox/clientlibs在存储库中的显示方式：

在PlayPage模板中包含Clientlib

如果页面上没有apps.an-scf-sandbox ClientLibraryFolder类别，则SCF组件将无法正常工作，也无法按照必需的Javascript设置样式，并且样式将不可用。

例如，如果不包含clientlibs，则SCF注释组件将显示为未设置样式：

在包含apps.an-scf-sandbox clientlibs后，SCF评论组件会显示样式：

include语句属于html脚本的head部分。 默认的​foundation head.jsp​包含可覆盖的脚本：headlibs.jsp。

复制headlibs.jsp并包含clientlibs:

1. 使用​CRXDE Lite，选择​/libs/foundation/components/page/headlibs.jsp

2. 右键单击并选择​Copy（或从工具栏中选择Copy）

3. 选择 /apps/an-scf-sandbox/components/playpage

4. 右键单击并选择​粘贴（或从工具栏中选择粘贴）

5. 双击​headlibs.jsp​将其打开

6. 在文件末尾附加以下行
   <ui:includeClientLib categories="apps.an-scf-sandbox"/>

7. 单击​Save All

<%@ page session="false" %><%
%><%@include file="/libs/foundation/global.jsp" %><%
%><ui:includeClientLib categories="cq.foundation-main"/><%
%>
<cq:include script="/libs/cq/cloudserviceconfigs/components/servicelibs/servicelibs.jsp"/>
<% currentDesign.writeCssIncludes(pageContext); %>
<ui:includeClientLib categories="apps.an-scf-sandbox"/>

在浏览器中加载您的网站，并查看背景是否不是蓝色阴影。

https://localhost:4502/content/an-scf-sandbox/en/play.html

到目前为止正在保存您的工作

此时，存在一个极简主义的沙箱，可能值得将其另存为包，这样在播放时，如果您的存储库已损坏并且您希望重新开始，您就可以关闭服务器、重命名或删除文件夹crx-quickstart/、打开服务器、上载并安装此保存的包，并且不必重复这些最基本的步骤。

创建示例页面教程中存在此包，教程针对的是那些迫不及待地想要跳入并开始播放的用户……

要创建资源包，请执行以下操作：

• 在CRXDE Lite中，单击包图标

• 单击​创建包

  • 包名称：an-scf-sandbox-minimal-pkg
  • 版本：0.1
  • 组: leave as default
  • 单击​确定

• 单击​编辑

  • 选择​Filters​选项卡

    • 单击​Add filter
    • 根路径：浏览/apps/an-scf-sandbox
    • 单击​Done
    • 单击​Add filter
    • 根路径：浏览/etc/designs/an-scf-sandbox
    • 单击​Done
    • 单击​Add filter
    • 根路径：浏览/content/an-scf-sandbox**
    • 单击​Done

  • 单击​Save

• 单击​Build

现在，您可以选择​Download​将其保存到磁盘，然后选择其他位置的​Upload Package，还可以选择​More > Replicate，以将沙盒推送到本地主机发布实例以扩展沙盒的领域。