README

WebDevStudios的起始主题。 https://wdunderscores.com

目录

• 简介
• 入门
  • 先决条件
  • 快速开始
  • 高级
• 设置
  • 开发
• 贡献和支持

简介

大家好！我是一个多才多艺的起始主题，被称为 wd_s 或 wdunderscores。我的基础主要是基于PHP模板，但通过站点编辑器，我可以灵活地添加自定义模板。值得注意的是，我旨在进行定制，因此最好不要将我用作父主题。相反，发挥我的潜力，把我变成你想象中最棒的WordPress主题——这正是我存在的意义！

我配备了丰富的网络技术，包括 Tailwind、npm、webpack、Sass 和 PostCSS。为了确保您的代码符合 WordPress标准 并保持整洁，我利用 @wordpress/scripts 对CSS和JavaScript进行代码检查。更重要的是，我非常重视可访问性，并自豪地从一开始就符合WCAG 2.1AA和第508节标准。

我还启用了站点编辑器，为您在创建WordPress主题时提供更多的灵活性和便利。无论您是在自定义模板还是使用站点编辑器，我都会支持您的创作之旅。请记住，我需要至少PHP 8.0才能激活以发挥我的全部潜力。

入门

先决条件

由于我通过NPM脚本来编译和捆绑资源，因此需要具备基本命令行知识以及以下依赖项

• Node (v18+)
• NPM (v9+)
• Composer

快速开始

如果您想保持简单，请访问https://wdunderscores.com 并从那里生成您的基于 wd_s 的主题。您只需输入您想要创建的主题名称，点击“生成”按钮，即可获得一个准备好使用的起始主题。或者，您还可以下载预构建的ZIP

高级

如果您想手动设置

1. 下载 并将zip文件解压缩到您的 wp-content/themes 目录中，并将 wd_s 重命名为您需要的名称。

2. 查找和替换

您需要将名称 wd_s 的所有实例进行更改。

• 搜索 @package wd_s 并替换为 @package project_name 以捕获包名称
• 在 phpcs.xml.dist 中将 "WebDevStudios\wd_s,wd_s" 更新为 "CompanyName\project_name,project_name"（使用双引号）
• 搜索 WebDevStudios\wd_s 并将其替换为 CompanyName\project_name 以捕获命名空间
• 将 composer.json 中的 "webdevstudios/wd_s" 更新为 "companyname/project_name"（包含双引号）
• 搜索：, 'wd_s' 并替换为：, 'project_name'（在反引号内）以捕获文本域
• 将 style.css 中的 Text Domain: wd_s 更新为：Text Domain: project_name
• 将 "wd_s" 更新为："project_name"（包含双引号）在 phpcs.xml.dist 和 package.json 中
• 将 'wd_s' 更新为：'project_name'（包含单引号）在 inc/setup/setup.php 中
• 搜索：wd_s_ 并替换为：project_name_ 以捕获所有函数名
• 搜索：'wd_s- 并替换为：'project_name- 以捕获前缀处理程序
• 搜索 wd_s.pot 并替换为：project_name.pot 以捕获翻译文件
• 搜索 wdunderscores.test 并替换为：project_name.test 以匹配您的本地开发 URL
• 编辑 style.scss 头部的主题信息以满足您的需求

设置

从命令行，切换到您的新主题目录

cd /wp-content/themes/your-theme

安装主题依赖项并触发初始构建

注意：您需要首先安装 Composer 2 和 NPM 9。

npm i && composer i

开发

从命令行，键入以下任何命令以执行操作

使用 wpcli 构建 block

为了构建一个 block，运行以下 wpcli 脚本。

注意：如果您使用的是 Local，您可以在 Local 内打开壳来完成此操作。Sitename -> Open site shell。

wp wds create_portable_block myblock --title="This is myblock" --desc="This block is used for wds." --keyword="myblock" --icon="table-row-before" --namespace="wds"

这将在主题的 blocks 文件夹内创建一个 block。将 myblock 替换为您的 block 名称，并更新其他项 title、desc、keyword、icon、namespace 为相应的信息。

注意：如果您在执行上述步骤后未在编辑器的 block 列表中看到您的新 block，请尝试更改 block 的 block.json 中的命名空间格式为以下格式 your-namespace/blockname 并再次检查。

贡献和支持

欢迎您的贡献和支持票据。[请在我们提交 pull request 之前查看我们的贡献指南。

wd_s 是免费软件，根据 GNU 通用公共许可证第 2 版或任何后续版本发布。有关完整许可证，请参阅 LICENSE.md。