README

介绍 | 路线图 | 安装 | 使用 | 升级 | 变更日志

介绍

Laravel Translations UI 包提供了一种用户友好的界面，用于管理 Laravel 应用程序中的翻译。它简化了添加、编辑、删除和导出翻译等任务。该包还包括一个便捷的搜索功能，以及邀请协作者以轻松管理翻译的能力。目前，该包已集成 Google Translate API，允许您将内容翻译成您选择的任何语言。

📺 观看 Povilas Korop 的 4 分钟视频，展示该包。

支持

感谢您考虑支持此包的开发！如果您想贡献，可以请我喝杯咖啡或赞助我，以保持我继续改进此包的动力。您还可以通过星标 ⭐ 仓库来支持项目。

要请我喝咖啡，请点击下面的按钮

要求

需要 PHP 8.2+ 和 Laravel 11.x

功能

• 通过直观的界面轻松查看、创建和删除翻译。
• 轻松管理翻译键，以实现有组织的语言管理。
• 方便通过翻译键或值筛选，以快速定位特定内容。
• 方便地从 Laravel 应用程序导入和导出翻译。
• 利用强大的搜索功能，快速找到您需要的翻译、键或值。
• 通过邀请协作者共同管理翻译，实现无缝协作。
• 利用 Google Translate API 集成进行准确和自动化的语言翻译。
• 探索增强您的翻译工作流程的更多功能。

路线图

• 添加测试。
• 改进 UI。
• 支持供应商翻译。
• 集成 Google Translate API。
• 邀请协作者管理翻译。
• 添加修订历史。
• 添加更多功能。

安装

🚨 重要通知：本版本有重大更改 🚨

我想通知您，本版本带来了重大的更改，因为包栈已从 Livewire 转换到 Inertia。此调整带来了多项改进和优化，提高了整体性能和用户体验。

为了无缝适应这些更改，请按照以下步骤操作

卸载上一个版本

我已经添加了一个新命令，帮助您卸载软件包并删除其所有资产和配置文件，并清理数据库，但在继续安装新版本之前，请务必检查是否已删除所有内容，因为此命令仍在测试阶段。要卸载软件包，请运行以下命令

php artisan translations:clean

或者，您可以按照以下步骤手动删除软件包

composer remove outhebox/laravel-translations

从头开始安装

卸载后，重新安装软件包。

composer require outhebox/laravel-translations --with-all-dependencies

在您能够访问翻译用户界面之前，您需要通过运行以下命令发布软件包的资产和迁移文件

php artisan translations:install

用法

要导入您的翻译，请运行以下命令

php artisan translations:import

要导入并覆盖所有之前的翻译，请使用以下命令

php artisan translations:import --fresh

要访问翻译用户界面，请访问浏览器中的 /translations。如果您使用的是生产环境，您需要首先创建所有者用户。要这样做，请运行以下命令

php artisan translations:contributor

此命令将提示您输入用户的姓名、电子邮件和密码。创建所有者用户后，您就可以登录到翻译用户界面仪表板并开始管理您的翻译。

导出翻译

您可以从翻译用户界面仪表板或通过运行以下命令导出您的翻译

php artisan translations:export

配置

您可以通过发布配置文件来配置软件包并设置您的基语言

php artisan vendor:publish --tag=translations-config

这将发布 translations.php 配置文件到您的 config 目录。

升级

在升级到 Laravel 翻译用户界面的新主要版本时，仔细审查升级指南非常重要。

此外，在升级到任何新的翻译用户界面版本时，您应该重新发布翻译用户界面资产

php artisan translations:publish

为了保持资产更新并避免未来更新中的问题，您可以在应用程序的 composer.json 文件中将 translations:publish 命令添加到 post-update-cmd 脚本中

{
    "scripts": {
        "post-update-cmd": [
            "@php artisan translations:publish --ansi"
        ]
    }
}

屏幕截图

变更日志

请参阅 变更日志 了解最近更改的更多信息。

贡献

请参阅 贡献指南 了解详细信息。

鸣谢

• 穆罕默德·阿什拉夫
• 所有贡献者

许可证

MIT 许可证（MIT）。请参阅 许可证文件 了解更多信息。