README

此仓库处于预览状态。不建议在生产环境中使用。

官方SiteCrafting WordPress启动主题。

从旧版、闭源Groot迁移

对于基于Groot构建的客户端项目，有几种新的方法使用Lando环境捆绑的更一致、更可靠的工具来进行操作。注意在正常情况下运行 lando yarn 不是必需的：新的Lando环境会在 lando start 时为你安装所有内容。

LESS文件中的资源路径

Webpack以不同的方式处理图像路径。引用主题文件的最简单方法是从webroot使用绝对路径。

在构建时，Webpack将根据您主题的目录名更新base/variables.less中的@theme-path变量

@theme-path: '/wp-content/themes/<theme-dir-name>/';

这将使您能够像这样使用@theme-path变量

* { background-image: url(~'@{theme-path}img/icons/my-icon.svg'); }

开发

要开始对Groot启动主题本身进行修改，请运行

git clone git@github.com:sitecrafting/groot.git && cd groot
lando start

这将提示您输入网站信息管理员凭据以进行设置。然后它进行一些设置/清理。之后，您应该有一个运行Groot的完整功能的WordPress网站！

注意：目前，我们在启动本地Groot时没有导入SiteCrafting WP启动数据库。如果需要，可以手动导入。请注意，此数据库期望ACF Pro已安装，这在本地开发中也不会自动安装。如果您需要ACF Pro，则需要手动安装。

SITKA支持

• 要使用Sitka insights进行抓取，模板内容必须包裹在具有sitka-search-content-container类的元素中。
• 提供了反馈收集器部分和启动自定义样式。在反馈收集器应出现的位置包含此部分。
• 与项目经理/团队核对任何其他要求 - sitka insights插件、脚本等

从根目录运行命令

为了在Groot本身中编译LESS/JS资源，您应该能够在根目录中运行命令。例如

cd /path/to/groot
lando webpack --watch

构建新版本

首先更新style.less头部注释中的Groot版本号。这不是必需的，但可以更容易地进行故障排除。

/*!
 * Theme Name: Groot
 * ...
 * Copyright 2020 SiteCrafting, Inc.
 * Based on Groot release: vX.X.X     // <-- UPDATE THIS NUMBER
 */

在创建实际版本之前，请确保提交此更改。否则，您的版本下载将不包括此更新。

Groot包含一个用于构建自身和创建版本的脚本。要创建标签和名为vX.Y.Z的对应版本

scripts/build-release.sh vX.Y.Z

这将创建一个.tar.gz和一个.zip存档，您可以将它们上传到GitHub上的新版本。

如果您已安装hub，它还会提示您可选地直接创建版本！