README

嗨，我是一个名为 _svbk 的入门主题，它是流行的 _s 主题的超集。我是一个用于破解的主题，所以请不要将其用作父主题。相反，尝试将其打造成为下一个最酷的 WordPress 主题。这就是我存在的意义。

除了标准的 _s 以外，我还提供以下功能

• Gulp 用于实时 SASS 编译
• Composer 用于依赖管理
• 安装脚本
• 一些额外的自定义功能，使我不那么原始

我的极简 CSS 可能让我看起来像主题生肉，但这意味着当您设计您的主题时，会有更少的东西妨碍您。以下是一些您在这里会发现的其他更有趣的东西

• 适量的精简、注释清晰的现代 HTML5 模板。
• 有用的 404 模板。
• 在 inc/custom-header.php 中实现的自定义头文件，只需将 inc/custom-header.php 中的代码片段添加到您的 header.php 模板中即可。
• 在 inc/template-tags.php 中的自定义模板标签，使您的模板整洁且无重复代码。
• 用于添加和自定义 TinyMCE 编辑器按钮的 editor.php
• 在 inc/template-functions.php 中的一些小调整，可以改善您的主题体验。
• 在 js/navigation.js 中的脚本，使得在小屏幕（如手机）上菜单可以切换下拉，准备好进行 CSS 艺术设计。它在 functions.php 中排队。
• 在 layouts/ 中的两个示例 CSS 布局，用于您内容两侧的侧边栏。注意：.no-sidebar 样式将不会自动加载。
• 在 style.css 中的智能组织起始 CSS，将帮助您快速开始设计。
• 许可协议为 GPLv2 或更高版本。 :) 用它来制作一些酷的东西。

安装

安装依赖

npm install

如果您还没有安装 gulp，您应该通过以下方式安装

npm install -g gulp

设置

编辑 config.json 文件并自定义所有参数，主要是 theme_name 和 theme_handle 参数。

运行 gulp setup，这将构建所有的 dist 文件并将所有函数名称自定义为您主题的前缀。

开发

此主题有许多 gulp 任务来帮助开发，您可以在 gulpfile.js 中找到所有这些任务。

以下是一些最有用的任务

# Compile SASS, Images and JS in real time. 
gulp serve

# Replaces all function prefixes and text-domains with `theme_handle`, useful after git merges.
gulp replaceMarkers

# Compiles and overwrites all the assets in the `dist` folder for production.
gulp build

当您完成冲刺后，应该将 theme_version 配置条目在 composer.json 中更新，这将自动添加到所有资产 URL 中，以帮助缓存破坏。

块编辑器（Gutenberg）块

此主题附带了许多块，您可以在 blocks 文件夹中找到它们。

您可以使用以下方式编译主题块

# In real time while developing
npm run blocks

# To build the optimized production code
npm run blocks:build

wp-env

此主题与 wp-env 环境兼容。

您可以通过以下方式测试或为此主题开发

# To start the WP server
npm run wp-env start

# To refresh the wp-env after some options changes (WP_HOME, etc)
npm run wp-env start -- --update 

# To stop the WP server
npm run wp-env stop

网站默认在 http://localhost 上可用。

如果您需要运行 wp-cli 命令，您可以使用 npm run wp 脚本助手。

示例

# Outputs the current env user list
npm run wp user list

`.wp-env.json` 文件包含了环境的配置，但如果您需要针对当前项目进行自定义，最好创建一个 .wp-env.override.json 文件，该文件不要提交到仓库中。