{"id":20900952,"url":"https://github.com/phpbb/phpbb-translation-validator","last_synced_at":"2025-05-13T02:30:31.765Z","repository":{"id":17191401,"uuid":"19958972","full_name":"phpbb/phpbb-translation-validator","owner":"phpbb","description":"A tool checking packages for compliance with the policies https://area51.phpbb.com/docs/dev/3.2.x/language/guidelines.html","archived":false,"fork":false,"pushed_at":"2024-08-17T09:05:16.000Z","size":943,"stargazers_count":8,"open_issues_count":3,"forks_count":9,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-05-07T23:41:37.254Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phpbb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"phpbb"}},"created_at":"2014-05-19T21:49:50.000Z","updated_at":"2023-09-24T22:23:32.000Z","dependencies_parsed_at":"2024-11-07T00:27:50.710Z","dependency_job_id":"25c693aa-80b1-4a45-bfbc-6f970b88cf82","html_url":"https://github.com/phpbb/phpbb-translation-validator","commit_stats":{"total_commits":210,"total_committers":5,"mean_commits":42.0,"dds":"0.29047619047619044","last_synced_commit":"4bfdfa03b10d09c7d803e9668bfd2aedb466bf5e"},"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phpbb%2Fphpbb-translation-validator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phpbb%2Fphpbb-translation-validator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phpbb%2Fphpbb-translation-validator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phpbb%2Fphpbb-translation-validator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phpbb","download_url":"https://codeload.github.com/phpbb/phpbb-translation-validator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253859346,"owners_count":21975086,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-18T11:24:53.974Z","updated_at":"2025-05-13T02:30:31.333Z","avatar_url":"https://github.com/phpbb.png","language":"PHP","funding_links":["https://github.com/sponsors/phpbb"],"categories":[],"sub_categories":[],"readme":"# phpBB Translation Validator\n\nThis console application allows you to validate [phpBB](https://www.phpbb.com) language packages.\n\n## Requirements\n\nThis extension requires PHP 5.5.9 or above.\n\n### Installation\n\nFirstly, download the latest British English (`en`) [language pack from phpBB.com](http://www.phpbb.com/customise/db/translation/british_english/) as this is the default source language. Then clone this repository and download the dependencies:\n\n    git clone https://github.com/phpbb/phpbb-translation-validator.git\n    composer.phar install\n\nFor the easiest results, create a directory called `3.2` or `3.3` in the root of the Translation Validator. Upload the `en` language page into this directory, along with the languages you wish to test. Which leads e.g. to:\n\n    phpbb-translation-validator/3.2/en/\n    phpbb-translation-validator/3.2/fr/\n    phpbb-translation-validator/3.3/en/\n    phpbb-translation-validator/3.3/fr/\n    phpbb-translation-validator/translation.php\n\nThe simplest way to validate is to then run this command (the final argument is the language you wish to test and that has already been uploaded to the `3.2` directory; eg. `fr` for French):\n\n     php translation.php validate fr\n\nThere are more arguments that can be supplied. For example, suppose you wanted to have your `3.2` directory in a different location, you wanted to explicitly specify phpBB version 3.2 (default validation is against 3.3), you wanted to run in safe mode and you wanted to see all notices displayed - you would run this command:\n\n     php translation.php validate fr \n        --package-dir=/path/to/your/3.2 \n        --phpbb-version=3.2 \n        --safe-mode \n        --display-notices\n\nThe `--safe-mode` flag indicates that you want to parse files instead of directly including them. This is useful if you want to run validations on a web server.\n\nIf you are missing the English language files for the official Viglink extension, they can be easily donwloaded using this command:\n\n    php translation.php download --files=phpbb-extensions/viglink --phpbb-version=3.3\n\n## Tests\n\n![GitHub Actions CI](https://github.com/phpbb/phpbb-translation-validator/actions/workflows/phpunit.yaml/badge.svg?branch=master)\n\nIn your project you can add phpBB Translation Validator as a dependency:\n\n\t\t{\n\t\t\t\"require-dev\": {\n\t\t\t\t\"phpbb/translation-validator\": \"1.5.*\"\n\t\t\t}\n\t\t}\n\nThen add a `php vendor/bin/translation.php` call to your workflow.\n\nWe use GitHub Actions as a continuous integration server and phpunit for our unit testing.\n\nTo run the unit tests locally, use this command:\n\n     php vendor/phpunit/phpunit/phpunit tests/\n\n## Contributing\n\nIf you notice any problems with this application, please raise an issue at https://github.com/phpbb/phpbb-translation-validator/issues.\n\nTo submit your own code contributions, please fork the project and submit a pull request at https://github.com/phpbb/phpbb-translation-validator/pulls.\n\nWhen a new version is released, the version number will be updated in `composer.json` and `translation.php`. A new tag will be created and the package will become available at https://packagist.org/packages/phpbb/translation-validator.\n\n## License\n\n[GPLv2](license.txt)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphpbb%2Fphpbb-translation-validator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphpbb%2Fphpbb-translation-validator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphpbb%2Fphpbb-translation-validator/lists"}