README

Laravel Tayar - لارافل تيار

介绍 - المقدمة

Laravel Tayar 是基于 Fesikh 的 Laravel Jetstream。它是一个分支，添加了一些重要的增强功能，这些功能默认不支持，在设置项目时可能需要花费一些时间。这应该可以帮助您避免在每个新创建的项目中实现这些必需功能时浪费几个小时。

请注意，目前主要关注 Inertia (Vue.js) 堆栈，同时对 Livewire 的一侧也给予了部分关注，尽管对于某些功能来说，它也可以是 Livewire 项目的更好起点（例如，本地化文件仍然可以以最小努力使用）。

特性 - الخصائص

• 使用 laravel-vue-i18n 支持本地化，包括英文和阿拉伯文翻译。
• 支持指定语言的从右到左 (RTL) 布局。
• 在顶部导航栏中的语言切换器，持久保存在 cookie 和用户数据库中。
• 支持深色模式和顶部栏中的切换，持久保存在 cookie 和用户数据库中。
• 用户的布尔值管理，以及仪表板/控制面板仅对管理员可访问。
• 具有固定顶部导航栏和固定侧边的管理布局。统一的导航项目变量。
• 前端布局模板。

安装 - التثبيت

从创建一个新的 Laravel 项目开始

composer create-project laravel/laravel tayar-app

cd tayar-app

composer require helwy/tayar:5.x-dev

默认的 jetstream 安装有多种不同的配置，您可以在这里找到更多信息，但在此分支的开发过程中，我使用 Inertia (Vue 3) 和深色模式支持进行安装。

php artisan jetstream:install inertia --dark

完成安装

npm install
npm run build
php artisan migrate

然后运行您的应用程序

php artisan serve

使用 - الاستخدام

• 可用语言 - 可用语言在 config/jetstream.php 文件中定义，在 Tayar 配置部分使用 available_locales 键。您可以从那里添加或删除语言。当您添加不支持的语言（尚未有翻译文件）时，您必须在该目录中创建其翻译文件。默认语言是英文和阿拉伯文。
• RTL 布局支持 - 为了使用某些语言的 RTL 布局，请转到 config/jetstream.php 并查找 Tayar 配置部分中的 rtl_locales 键。在此数组中添加或删除您想要支持 RTL 的语言。默认值仅为阿拉伯文。

重要链接 - الروابط المهمة

• Laravel 文档
• Laravel Jetstream 文档
• Laravel GitHub 仓库
• Laravel Jetstream GitHub 仓库

常见问题 - الأسئلة الشائعة

1. 如果我不想有多个本地化怎么办？

• 通过在配置文件中的 available_locales 数组中保留单个语言，语言切换器将不会在 UI 中显示，您也不必太担心本地化，尽管我建议继续使用本地化文件来简化您应用程序中任何静态文本的本地化，以便在需要时更容易进行本地化。

1. 如果我不需要 RTL 语言怎么办？

• 将配置文件中的 rtl_locales 保留为空数组将不会为任何语言使用 RTL 布局。您还可以从 app.blade.php 主体元素类中删除 rtl 类检查，但这不是必需的。

联系方式 - التواصل

贡献 - المساهمة

许可 - الترخيص

Laravel Tayar 是开源软件，遵循 MIT 许可协议。