nawrasbukhari/translation-scanner

搜索翻译键 - 插入JSON翻译文件。

v1.0.4 2024-08-02 23:59 UTC

This package is auto-updated.

Last update: 2024-10-03 00:23:17 UTC


README

JSON翻译助手会扫描您的项目中的 __()lang() 翻译助手方法和 @lang 指令,然后在您的JSON翻译文件中创建键。

是的,它避免了重复 - 助手只创建不存在的键。准备好翻译。

安装

首先,使用Composer require命令安装JSON翻译助手

composer require nawrasbukhari/translation-scanner --dev

这就完成了。包会自动注册服务提供者。

使用方法

翻译文件

首先,您需要为要将应用程序翻译成的语言创建翻译文件。

例如,如果您想使应用程序具有西班牙语翻译,则应创建一个 lang/es.json 文件。

当然,您可以拥有多个翻译文件

lang/
    es.json
    fr.json
    en.json
    ...

确保您的翻译文件是有效的JSON,否则我们的包将无法工作

{
    "I love programming.": "Me encanta programar."
}

如果您目前没有翻译,只需 确保您的文件不为空,但实际上是一个空的JSON对象

{}

扫描应用程序

最后,要扫描应用程序中缺少的翻译键,只需运行

php artisan translation:scan

配置

发布配置

首先,发布配置文件

php artisan vendor:publish --provider="NawrasBukhariTranslationScanner\TranslationScannerServiceProvider"

它将带您到 config/translation-scanner.php 配置文件。

阅读以下部分,了解您可以配置的内容。

目录

要指定您要扫描翻译字符串的位置,只需修改 scan_directories 数组

/**
 * Directories to scan for missing translation keys.
 */
'scan_directories' => [
    app_path(),
    resource_path('views')
],

文件扩展名

我们的包默认只扫描 .php 文件。

您可以在 config/translation-helper.php 配置文件中的 file_extensions 数组中添加更多文件扩展名以进行扫描,例如,扫描 .vue.js 文件

/**
 * File extensions to scan from.
 */
'file_extensions' => [
    'php',
    'js',
    'vue',
],

翻译助手方法

默认情况下,我们的包查找 lang()__() 翻译助手方法和指令。

但您可以通过修改配置文件中的 translation_methods 数组来扩展、修改或删除它们

/**
 * Translation helper methods to scan
 * for in your application's code.
 */
'translation_methods' => [
    'lang',
    '__',
],