README

所有 Region Halland 的 WordPress 网站 都使用 Roots 栈的部分，主要是 Bedrock 和 Sage。这个栈的优势很多，但最大的优势之一是我们可以使用 Composer 来管理我们使用的包，例如，所有自开发的插件都是通过 Composer 获取的包。

这样开发 Region Halland 的新主题

前提条件 🚨

• 您已经设置了本地开发环境，例如 Homestead 或 MAMP
• 您已安装以下包
  • Composer
  • Yarn
  • Azure CLI（见下文）
  • Node.js 版本 8.x。我们的版本不支持 Node 的新版本。使用 NVM 来管理多个本地的 Node.js 版本

安装 Bedrock

1. 首先通过运行 composer create-project regionhalland/region-halland-site-boilerplate <你希望在文件夹中创建的项目名称> 来获取我们的 Bedrock boilerplate，然后遵循 Bedrock 安装说明。

配置 GIT

1. 导航到 /web/app/themes/。这里放置着我们的最新 boilerplate。即此包。
2. 将 region-halland-theme-boilerplate 文件夹重命名为您的主题名称。我们所有的主题都使用 region-halland-theme-<主题名称> 命名。
3. 通过进入您的主题文件夹并运行以下命令来开启主题的版本控制

    git init .
   

4. 通过运行以下命令进行您的第一次提交

    git add --all
    git commit -m "first commit of my code"
   

5. 好了！现在您已经开启了本地的版本控制，现在我们将添加 Azure 上的远程，以便与同事共享代码。第一步是 安装 Azure CLI 并使用 AZ 登录
6. 通过运行以下命令在 Azure 中添加一个仓库

    az repos create --project public.RhWpSites --name RhTheme<NAMNET_PÅ_DITT_TEMA>
   

7. 执行上述命令后，终端将返回一个包含信息的数组，找到 "remoteUrl" 并复制该地址。
8. 然后运行

    git remote add origin <DIN_REMOTE_URL>
   

9. 最后一步是推送您的代码！🎉

    git push origin master
   

配置主题

1. 由于我们正在创建一个新的主题，所以需要更新主题的 package.json 和 composer.json。
   1. 打开 package.json 并更改 "name"、"version"、"author"。
   2. 打开 composer.json 并更改 "name"、"description"。
2. 更新了 JSON 文件中的信息后，可以通过运行以下两个命令来安装主题

    composer install
    yarn
   

3. 假设您已经设置了一个本地开发服务器，例如 MAMP 或 Homestead，则可以现在通过运行 yarn start 来启动主题并获得一个带有 Browsersync 等的本地 URL。在 package.json 中查看其他命令。

主题开发技巧

• 🔌 请注意，我们已经有超过 100 个插件为我们的主题提供功能。很可能会已经构建了您所需的功能，请通过 webbplatser@regionhalland.se 联系我们，我们可以帮助您。我们的大部分插件都作为独立的包在 packagist.org 上提供。
• 🖼 所有我们的界面 都应该使用我们的数字风格指南。默认情况下，该指南通过 NPM 包含在我们的主题中，并使用 webpack 构建（见 resources/assets/build/webpack.config.*）。在 stilguide.regionhalland.se 上查看风格指南。

版本历史

请见https://regionhalland.visualstudio.com/public.RhWpSites/_git/RhThemeBoilerplate/tags