README

此遗留包是在 Bootstrap CSS 框架上构建的一个非常简单的身份验证脚手架。虽然它仍然与 Laravel 的最新版本兼容。

介绍

Laravel 没有规定您使用哪种 JavaScript 或 CSS 预处理器，但它提供了使用 Bootstrap 和/或 Vue 的基本起点，这将有助于许多应用。默认情况下，Laravel 使用 NPM 安装这两个前端包。

官方文档

支持的版本

只有 TechnoBureau UI 的最新主要版本会收到错误修复。下表列出了兼容的 Laravel 版本

安装

TechnoBureau 提供的 Bootstrap 和 Vue 脚手架位于 technobureau/ui Composer 包中，可以使用 Composer 安装

composer require technobureau/ui

在执行此 ui 命令之前，请先执行默认的 laravel/ui 命令以生成基本的身份验证脚手架。

php artisan ui bootstrap --auth

一旦安装了 technobureau/ui 包，您可以使用 ui Artisan 命令安装前端脚手架

// Generate basic scaffolding...
php artisan ui technobureau

// Generate login / registration scaffolding...
php artisan ui technobureau --auth

此包依赖于几个供应商包，因此请执行以下命令以发布与该包相关的配置文件。请确保在发布命令提示提供程序或标记时输入 0 作为输入

php artisan vendor:publish

CSS

Laravel Mix 提供了一个干净的、表达式的 API，用于编译 SASS 或 Less，它们是普通 CSS 的扩展，添加了变量、混入和其他强大的功能，使 CSS 的工作更加愉快。在本文档中，我们将简要讨论 CSS 编译的一般情况；然而，您应参考完整的 Laravel Mix 文档 以获取有关编译 SASS 或 Less 的更多信息。

JavaScript

Laravel 不要求您使用特定的 JavaScript 框架或库来构建您的应用程序。实际上，您甚至不需要使用 JavaScript。然而，Laravel 包括一些基本的脚手架，以使使用 Vue 库开始编写现代 JavaScript 更加容易。Vue 提供了一个用于使用组件构建强大 JavaScript 应用程序的表述式 API。与 CSS 类似，我们可以使用 Laravel Mix 容易地将 JavaScript 组件编译成一个单一的、浏览器就绪的 JavaScript 文件。

编写 CSS

安装 technobureau/ui Composer 包和 生成前端脚手架 后，Laravel 的 package.json 文件将包含 bootstrap 包，以帮助您开始使用 Bootstrap 拟型应用程序的前端。但是，请随意根据您自己的应用程序需求添加或从 package.json 文件中删除包。您不一定要使用 Bootstrap 框架来构建您的 Laravel 应用程序 - 它被提供给那些选择使用它的人作为良好的起点。

在编译您的 CSS 之前，请使用 Node 包管理器 (NPM) 安装您项目的前端依赖项

npm install

使用npm install安装依赖后，您可以使用Laravel Mix将您的SASS文件编译为纯CSS。执行npm run prod命令将处理您的webpack.mix.js文件中的指令。通常，编译后的CSS会放在public/css目录中。

npm run prod

与Laravel前端脚手架一起提供的webpack.mix.js文件将编译resources/sass/technobureau.scss SASS文件。此technobureau.scss文件导入SASS变量文件并加载Bootstrap，这为大多数应用提供了一个良好的起点。您可以随意定制technobureau.scss文件，甚至可以通过配置Laravel Mix来使用完全不同的预处理器。

编写JavaScript

您应用所需的JavaScript依赖项都可以在项目根目录下的package.json文件中找到。此文件类似于composer.json文件，但它指定JavaScript依赖项而不是PHP依赖项。您可以使用Node包管理器（NPM）安装这些依赖项。

npm install

默认情况下，Laravel的package.json文件包含一些包，如lodash和axios，以帮助您开始构建JavaScript应用。根据您的应用需求，您可以在package.json文件中添加或删除这些包。

安装包后，您可以使用npm run prod命令编译您的资源。Webpack是现代JavaScript应用的模块打包器。执行npm run prod命令时，Webpack将执行您的webpack.mix.js文件中的指令。

npm run prod

默认情况下，Laravel的webpack.mix.js文件将编译您的SASS和resources/js/technobureau.js文件。在technobureau.js文件中，您可以注册Vue组件或配置自己的JavaScript应用（如果您更倾向于使用不同的框架）。编译后的JavaScript通常会被放置在public/js目录中。

technobureau.js文件将加载resources/js/bootstrap.js文件，该文件启动并配置Vue、Axios、jQuery以及其他JavaScript依赖项，并加载resources/js/bootstrap-select.js以提供具有搜索选项的漂亮下拉选择框。如果您需要配置额外的JavaScript依赖项，也可以在这个文件中完成。

许可证

Laravel UI是开源软件，许可协议为MIT许可证。