README

为现代网络开发者设计的 WordPress 主题模板。

特点

入门

我们已经让 Mountain Breeze 非常快速地启动，让您能够在几秒钟内开始开发您的主题。

要求

Composer
NPM

从您的 WordPress 开发环境的 wp-content/themes 目录中运行

composer create-project lukeraymonddowning/mountain-breeze

如果您想手动操作，克隆、分支或下载仓库到 WordPress 的 'wp-content/themes' 目录。

然后，从主题目录中，在终端或命令提示符中运行 $ composer install。主题将自动为您运行 $ npm install，甚至为您构建所需的样式表。

我们的动机

WordPress 推动了互联网的 1/3 以上，这当你想到的时候真的很疯狂。虽然它是一个功能强大的平台，入门门槛低，但我们认为它也可以是一个混乱的平台，并且它的某些部分开始显得有些过时。

特别是与 Laravel 这样的框架相比，WordPress 可以成为一个负担，但不必如此。事实上，只需稍作调整，你就可以拥有两者之最佳。

这是我们 有见地 的 WordPress 主题设置。这些观点来自多年的 WordPress 和 Laravel 开发经验，使用 jQuery 和 Alpine，使用 Bootstrap 和 Tailwind，以及看到什么让我们的开发生活更轻松。

我们包括我们认为真正有价值的库，删除我们认为没有价值的库，并给您提供灵活性，以进行任何您想要的调整。

我们对 Laravel、Tailwind CSS、Alpine JS 以及它们所有组件背后的众多创作者和贡献者的感谢。没有他们，这一切都不可能实现。

编码愉快！

构建资产

Mountain Breeze 使用 Laravel Mix 构建您的 style.css 和 js 文件。这允许您使用最新的 JavaScript 功能和高级 CSS。

要为开发构建您的资产，请在终端中从主题目录运行 $ npm run dev。

当您准备好进行生产时，请在终端中从主题目录运行 $ npm run prod。这将压缩并准备好您的文件以便上线。

使用 Blade

Mountain Breeze 内置了 Blade 支持。Blade 是 Laravel 框架提供的一个功能强大的模板引擎，开发者喜欢它提供的强大功能，同时仍然易于使用和享受。

所有 blade 文件都存储在主题的 'templates' 目录中。Mountain Breeze 可以自动检测应使用哪个 WordPress 模板文件，如果存在匹配的 blade 文件，则会使用该文件。您甚至不需要在根目录中包含相应的模板文件（例如：page.php）。

我们已经为您处理了index.php文件，您可以在“templates/index.blade.php”中找到它。

但还有更棒的。WordPress循环是WordPress开发中最常见的模式之一。为了帮助您，Mountain Breeze包含一个自定义的blade指令：@loop。这允许您快速在任何模板文件中实现WordPress循环。以下是一个示例

<div>
    @loop
        <h3>{{ the_title(); }}</h3>
        <p>{{ the_excerpt(); }}</p>
    @endloop
</div>

是不是很棒？

有关使用blade的更多详细信息，请查看文档：https://laravel.net.cn/docs/6.x/blade

使用Tailwind

Mountain Breeze已经内置了Tailwind，您可以直接开始使用。实际上，您可以在“templates/index.blade.php”中的示例索引文件中查看其使用情况。

如果您想自定义Tailwind，可以编辑包含的tailwind.config.js文件。可用的选项可以在https://tailwind.org.cn/docs/configuration中找到

默认情况下，我们清理了模板目录中所有的.blade.php文件。如果您有包含Tailwind类的其他文件，您需要在tailwind配置文件中的清理数组中添加它们。

使用Alpine

Alpine已经内置到Mountain Breeze中，您可以直接开始使用。实际上，您可以在“templates/index.blade.php”中的示例索引文件中查看其使用情况。

使用集合

Laravel集合提供对数组的优秀包装，并提供许多有用的工具，使开发更加容易。您可以通过调用collect(array $array)辅助函数来创建集合。

有关使用集合的更多详细信息，请查看文档：https://laravel.net.cn/docs/6.x/collections

使用Mix

Laravel Mix是一个简化webpack复杂性的webpack包装器。特别是对于新开发者来说，webpack可能是开发过程中的最大障碍之一，但它提供的功能不容小觑。

Mix去除了webpack的所有痛苦，留下了您需要的强大功能。我们的默认mix配置应该适用于大多数项目，但如果您想进一步自定义，请查看文档：https://laravel-mix.com

没有jQuery？

jQuery曾经并且始终是我们心中的最爱。多年来，它一直是忍受网页上javascript开发的唯一真正方法。但网络终于迎头赶上，曾经困扰它的问题现在已经不复存在。特别是对于简单的WordPress网站，jQuery只不过是一个不必要的负担，占用资源并消耗用户带宽。

我们认为像Alpine JS这样的库提供了更简洁的语法，成本更低，所以我们选择在主题中默认移除jQuery。

如果您真的不能没有它，您可以在您的functions.php文件中粘贴以下代码来重新获取它

public function enablejQuery()
{
    return true;
}

lukeraymonddowning / mountain-breeze

维护者

详细信息