README

对于所有Region Halland WordPress网站，都使用Region Halland的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模板，并按照Bedrock的安装说明进行操作。

配置GIT

1. 导航到/web/app/themes/。这里是我们模板的最新版本。也就是说，这是这个包。
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