Merge pull request #626 from deltragon/document-validate-po

Document validate_po.py script in readme and github PR template
This commit is contained in:
Archisman Panigrahi 2024-08-07 15:02:13 +00:00 committed by GitHub
commit 2b634e88fd
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 13 additions and 0 deletions

5
.github/pull_request_template.md vendored Normal file
View File

@ -0,0 +1,5 @@
## Description
Describe your changes here, and link to related issues if available.
Reminder to run `python validate_po.py --extract` if you have added new translatable strings.

View File

@ -186,6 +186,14 @@ For more details, please check the issue: [#329](https://github.com/slgobinath/S
Thirdparty plugins are available at another GitHub repository: [safeeyes-plugins](https://github.com/slgobinath/safeeyes-plugins). More details about how to write your own plugin and how to install third-party plugin are available there.
## Local development
When adding new translatable strings in the source code, make sure to run `python validate_po.py --extract` to add them to the translation template. You will need to install `python3-polib` for this.
Examples for translatable strings are `_("This is a string")` in Python code, or `<property name="label" translatable="yes">This is a label</property>` in Glade/xml files.
To ensure the new strings are well-formed, you can use `python validate_po.py --validate`.
## How to Release?
0. Run `update-po.sh` to generate new translation files (which will be eventually updated by translators). Commit and push the changes to the master branch.