README

Transcribe是Artisan控制台中的语言文件管理器，它可以帮助您轻松地搜索、更新、添加和删除翻译行。维护多语言界面不再头疼。

致谢

Laravel Transcribe是从themsaid/laravel-langman中分叉出来的，目的是为了维护和改进现有库。

安装

首先通过Composer安装包。在终端中运行以下命令

$ composer require nicolasbeauvais/laravel-transcribe

如果您使用的是Laravel 5.5或更高版本，包将自动注册。如果您使用的是Laravel 5.4或更低版本，请在config/app.php的提供者数组中添加以下行

NicolasBeauvais\Transcribe\TranscribeServiceProvider::class

此包有一个配置选项，指向resources/lang目录，如果您需要更改路径，则发布配置文件

php artisan vendor:publish --provider="NicolasBeauvais\Transcribe\TranscribeServiceProvider"

使用

显示翻译文件的行

php artisan transcribe:show users

您将得到

+---------+---------------+-------------+
| key     | en            | nl          |
+---------+---------------+-------------+
| name    | name          | naam        |
| job     | job           | baan        |
+---------+---------------+-------------+

php artisan transcribe:show users.name

仅获取所有语言中name键的翻译。

php artisan transcribe:show users.name.first

获取嵌套键的翻译。

php artisan transcribe:show package::users.name

获取供应商包语言文件的翻译。

php artisan transcribe:show users --lang=en,it

获取仅“en”和“it”语言的翻译。

php artisan transcribe:show users.nam -c

仅获取与给定键通过紧密匹配匹配的翻译行，因此搜索nam将带来类似于(name、username、branch_name_required等...）的键的值。

在此命令返回的表中，如果翻译缺失，它将以红色标记。

查找翻译行

php artisan transcribe:find 'log in first'

您将得到一个语言行的表格，其中任何值都通过紧密匹配与给定的短语匹配。

搜索视图中缺失的翻译

php artisan transcribe:sync

此命令将在resources/views和app中的所有文件中查找所有未在您的翻译文件中覆盖的翻译键，之后将这些键追加到值为空字符串的文件中。

搜索未使用的翻译键

php artisan langman:unused

此命令将在所有语言文件中查找所有在您的视图中未使用的键。

填充缺失的翻译

php artisan transcribe:missing

它将收集所有在任何语言中缺失或值为空字符串的键，提示您为每个键提供一个翻译，并最终将给定的值保存到文件中。

翻译一个键

php artisan transcribe:trans users.name
php artisan transcribe:trans users.name.first
php artisan transcribe:trans users.name --lang=en
php artisan transcribe:trans package::users.name

使用此命令，您可以设置给定组的语言键（普通或嵌套），您还可以指定要设置的语言，而其他语言保持不变。

如果键不存在，此命令将添加新键；如果键已存在，则更新该键。

删除键

php artisan transcribe:remove users.name
php artisan transcribe:remove package::users.name

将从所有语言文件中删除该键。

重命名键

php artisan transcribe:rename users.name full_name

这将把users.name重命名为users.full_name，控制台将输出曾经使用过该键的文件列表。

注意

transcribe:sync、transcribe:missing、transcribe:trans和transcribe:remove将通过完全写入它们来更新您的语言文件，这意味着任何注释或特殊样式都将被删除，因此我建议您备份您的文件。