yannickyayo/laravel-preset-ttall

Ttall stack的前端Laravel预设

3.2.0 2020-04-02 11:55 UTC

README

一个针对TTALL堆栈(Taiwlindcss | Turbolinks | Alpinejs | Laravel | Livewire)的具有意见的Laravel前端脚手架预设。

如果您正在使用此包的早期版本(当前版本为3.x),请查看下表以找到正确的README.md文件。

它包含有用的包及其配置文件。

  • Laravel调试栏
  • Laravel IDE Helper
  • Php CS Fixer
  • Larastan
  • Eslint (Airbnb规则)
  • Prettier

1. 使用方法

  1. 安装Laravel >= 6.0并cd到您的应用目录。
  2. 通过composer require yannickyayo/laravel-preset-ttall --dev安装此预设。Laravel将自动发现此包。无需注册服务提供者。

a. 对于无认证的预设

  1. 使用php artisan ui ttall进行基本预设
  2. composer update && npm install && npm run dev
  3. 运行php artisan serve(或等效命令)以运行服务器并测试预设。

b. 对于带有认证的预设

  1. 使用php artisan ui ttall --auth进行基本预设,同时生成认证路由条目和视图。(注意:如果您多次运行此命令,请确保在routes/web.php中清理重复的Auth条目)
  2. composer update && npm install && npm run dev
  3. 运行php artisan serve(或等效命令)以运行服务器并测试预设。

配置

此包包含的默认tailwind.config.js配置文件包括Inter字体家族。您可以通过删除文件并运行node_modules/.bin/tailwind init来更改设置,这将为您生成一个新的配置文件,您可以自由更改以适应您的需求。
Inter字体家族包含在您的resources/layouts/app.blade.php文件中。

resources/lang/XX/pagination.php文件中为您的应用使用的每种语言添加一个新的i18n字符串

'previous' => '« Previous',
'next' => 'Next »',
'goto_page' => 'Goto page #:page', // Add this line

这应该有助于提高可访问性

<li>
  <a href="URL?page=2" class="..." aria-label="Goto page #2">
    2
  </a>
</li>

脚本

自动添加了一个composer脚本,告诉Laravel IDE Helper在每次composer update后重新扫描您的FacadesModels文件。

"scripts":{
    "post-update-cmd": [
        "Illuminate\\Foundation\\ComposerScripts::postUpdate",
        "@php artisan ide-helper:generate",
        "@php artisan ide-helper:meta"
    ]
}

脚本也添加到了您的package.jsoncomposer.json中,以运行特定的操作

  • composer format:将使用php-cs-fixer格式化您的PHP文件
  • composer test:将使用php artisan test命令运行您的PHPUnit测试
  • composer analyse:将使用larastan分析您的代码
  • npm run format:将格式化resources/js文件夹中的JS文件
  • npm run lint:将根据Airbnb的规则查找您的JS文件中的问题,并尝试修复它们

屏幕截图

即将推出...