README

此控制台应用程序允许您验证phpBB语言包。

需求

此扩展需要PHP 5.5.9或更高版本。

安装

首先，下载最新的英国英语（en）语言包，这是默认源语言。然后克隆此仓库并下载依赖项

git clone https://github.com/phpbb/phpbb-translation-validator.git
composer.phar install

为了获得最简单的结果，在翻译验证器的根目录下创建一个名为 3.2 或 3.3 的目录。将 en 语言页面上传到这个目录，以及您要测试的语言。例如，这将导致

phpbb-translation-validator/3.2/en/
phpbb-translation-validator/3.2/fr/
phpbb-translation-validator/3.3/en/
phpbb-translation-validator/3.3/fr/
phpbb-translation-validator/translation.php

验证的最简单方法是运行此命令（最后一个参数是要测试的语言，并且已经上传到 3.2 目录中；例如，fr 表示法语）

 php translation.php validate fr

还可以提供更多参数。例如，假设您希望将 3.2 目录放在不同的位置，您希望显式指定phpBB版本3.2（默认验证针对3.3），您希望在安全模式下运行，并且希望显示所有通知 - 您将运行此命令

 php translation.php validate fr 
    --package-dir=/path/to/your/3.2 
    --phpbb-version=3.2 
    --safe-mode 
    --display-notices

--safe-mode标志表示您想要解析文件而不是直接包含它们。如果您想在Web服务器上运行验证，这很有用。

如果您缺少官方Viglink扩展的英文语言文件，可以使用此命令轻松下载

php translation.php download --files=phpbb-extensions/viglink --phpbb-version=3.3

测试

在您的项目中，您可以添加phpBB Translation Validator作为依赖项

	{
		"require-dev": {
			"phpbb/translation-validator": "1.5.*"
		}
	}

然后添加一个 php vendor/bin/translation.php 调用到您的工作流程中。

我们使用GitHub Actions作为持续集成服务器和phpunit进行单元测试。

要本地运行单元测试，请使用此命令

 php vendor/phpunit/phpunit/phpunit tests/

贡献

如果您发现此应用程序有任何问题，请在https://github.com/phpbb/phpbb-translation-validator/issues处提出问题。

要提交自己的代码贡献，请克隆项目并在https://github.com/phpbb/phpbb-translation-validator/pulls处提交拉取请求。

当发布新版本时，版本号将在 composer.json 和 translation.php 中更新。将创建一个新的标签，并且该包将在https://packagist.org.cn/packages/phpbb/translation-validator上可用。

许可

GPLv2