Annikka/evennia
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Some minor rephrasing to i18n doc; also removing recommendation to use %s style

Browse source
This commit is contained in:
Griatch 2025-04-26 12:30:56 +02:00
parent e96878f538
commit bf06a41d36
2 changed files with 6 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

6
CHANGELOG.md
View file

@ -14,6 +14,8 @@ This upgrade requires running `evennia migrate` on your existing database
- [Feat][pull3633]: Default object's default descs are now taken from a `default_description` - [Feat][pull3633]: Default object's default descs are now taken from a `default_description`
class variable instead of the `desc` Attribute always being set (count-infinity) class variable instead of the `desc` Attribute always being set (count-infinity)
- [Feat][pull3718]: Remove twistd.bat creation for Windows, should not be needed anymore (0xDEADFED5) - [Feat][pull3718]: Remove twistd.bat creation for Windows, should not be needed anymore (0xDEADFED5)
- [Feat][pull3756]: Updated German translation (JohnFi)
- [Feat][pull3757]: Add more i18n strings to `DefaultObject` for easier translation (JohnFi)
- [Fix][pull3677]: Make sure that `DefaultAccount.create` normalizes to empty - [Fix][pull3677]: Make sure that `DefaultAccount.create` normalizes to empty
strings instead of `None` if no name is provided, also enforce string type (InspectorCaracal) strings instead of `None` if no name is provided, also enforce string type (InspectorCaracal)
- [Fix][pull3682]: Allow in-game help searching for commands natively starting - [Fix][pull3682]: Allow in-game help searching for commands natively starting
@ -51,7 +53,7 @@ This upgrade requires running `evennia migrate` on your existing database
it caused an OnDemandHandler save error on reload. Will now clean up on save. (Griatch) it caused an OnDemandHandler save error on reload. Will now clean up on save. (Griatch)
used as the task's category (Griatch) used as the task's category (Griatch)
- Fix: Correct aws contrib's use of legacy django string utils (Griatch) - Fix: Correct aws contrib's use of legacy django string utils (Griatch)
- [Docs]: Fixes from InspectorCaracal, Griatch, ChrisLR - [Docs]: Fixes from InspectorCaracal, Griatch, ChrisLR, JohnFi
[pull3633]: https://github.com/evennia/evennia/pull/3633 [pull3633]: https://github.com/evennia/evennia/pull/3633
[pull3677]: https://github.com/evennia/evennia/pull/3677 [pull3677]: https://github.com/evennia/evennia/pull/3677
@ -77,6 +79,8 @@ This upgrade requires running `evennia migrate` on your existing database
[pull3765]: https://github.com/evennia/evennia/pull/3765 [pull3765]: https://github.com/evennia/evennia/pull/3765
[pull3753]: https://github.com/evennia/evennia/pull/3753 [pull3753]: https://github.com/evennia/evennia/pull/3753
[pull3751]: https://github.com/evennia/evennia/pull/3751 [pull3751]: https://github.com/evennia/evennia/pull/3751
[pull3756]: https://github.com/evennia/evennia/pull/3756
[pull3757]: https://github.com/evennia/evennia/pull/3757
[issue3688]: https://github.com/evennia/evennia/issues/3688 [issue3688]: https://github.com/evennia/evennia/issues/3688
[issue3687]: https://github.com/evennia/evennia/issues/3687 [issue3687]: https://github.com/evennia/evennia/issues/3687

8
docs/source/Concepts/Internationalization.md
View file

@ -173,7 +173,7 @@ string = _("Text to translate")
### Formatting Considerations ### Formatting Considerations
When using formatted strings, ensure that you pass the "raw" string to `gettext` for translation first and then format the output. Otherwise, placeholders will be replaced before translation occurs, preventing the correct string from being found in the `.po` file. When using formatted strings, ensure that you pass the "raw" string to `gettext` for translation first and then format the output. Otherwise, placeholders will be replaced before translation occurs, preventing the correct string from being found in the `.po` file. It's also recommended to use named placeholders (e.g., `{char}`) instead of positional ones (e.g., `{}`) for better readability and maintainability.
```python ```python
# incorrect: # incorrect:
@ -189,9 +189,3 @@ This is also why f-strings don't work with `gettext`:
# will not work # will not work
string = _(f"Hello {char}!") string = _(f"Hello {char}!")
``` ```
However, you can use %-formatting. It’s recommended to use named placeholders because the order of placeholders may vary in different translations.
```python
_("Today is %(month)s %(day)s.") % {"month": m, "day": d}
```