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

Update docs on i18n. Add new contrib

Browse source
This commit is contained in:
Griatch 2022-10-02 11:19:11 +02:00
parent 93324f75d6
commit c6d9273798
2 changed files with 38 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -58,21 +58,21 @@ the server to activate i18n.
```{important} ```{important}
Even for a 'fully translated' language you will still see English text Even for a 'fully translated' language you will still see English text
in many places when you start Evennia. This is because we expect you (the in many places when you start Evennia. This is because we expect you (the
developer) to know English (you are reading this manual after all). So we developer) to know English (you are reading this manual after all). So we
translate *hard-coded strings that the end player may see* - things you translate *hard-coded strings that the end player may see* - things you
can't easily change from your mygame/ folder. Outputs from Commands and can't easily change from your mygame/ folder. Outputs from Commands and
Typeclasses are generally *not* translated, nor are console/log outputs. Typeclasses are generally *not* translated, nor are console/log outputs.
``` ```
```{sidebar} Windows users ```{sidebar} Windows users
If you get errors concerning `gettext` or `xgettext` on Windows, If you get errors concerning `gettext` or `xgettext` on Windows,
see the `Django documentation <https://docs.djangoproject.com/en/3.2/topics/i18n/translation/#gettext-on-windows>`_ see the [Django documentation](https://docs.djangoproject.com/en/3.2/topics/i18n/translation/#gettext-on-windows).
A self-installing and up-to-date version of gettext for Windows (32/64-bit) is A self-installing and up-to-date version of gettext for Windows (32/64-bit) is
available on `Github <https://github.com/mlocati/gettext-iconv-windows>`_ available on Github as [gettext-iconv-windows](https://github.com/mlocati/gettext-iconv-windows).
``` ```
@ -150,10 +150,9 @@ sentence delimiter (if that makes sense in your language).
Finally, try to get a feel for who a string is for. If a special technical term Finally, try to get a feel for who a string is for. If a special technical term
is used it may be more confusing than helpful to translate it, even if it's is used it may be more confusing than helpful to translate it, even if it's
outside of a `{...}` tag. Even though the result is a mix of your language and outside of a `{...}` tag. A mix of English and your language may be clearer
English, clarity is more important. Many languages may also use the English term than you forcing some ad-hoc translation for a term everyone usually reads in
normally and reaching for a translation may make the result sound awkward English anyway.
instead.
Original: "\nError loading cmdset: No cmdset class '{classname}' in '{path}'. Original: "\nError loading cmdset: No cmdset class '{classname}' in '{path}'.
\n(Traceback was logged {timestamp})" \n(Traceback was logged {timestamp})"

25
docs/source/Contribs/Contribs-Overview.md
View file

@ -363,6 +363,7 @@ contribs related to rooms, exits and map building._
:maxdepth: 1 :maxdepth: 1
Contrib-Extended-Room.md Contrib-Extended-Room.md
Contrib-Ingame-Map-Display.md
Contrib-Mapbuilder.md Contrib-Mapbuilder.md
Contrib-Simpledoor.md Contrib-Simpledoor.md
Contrib-Slow-Exit.md Contrib-Slow-Exit.md
@ -384,6 +385,19 @@ supported by new `look` and `desc` commands.
### Contrib: `ingame_map_display`
_Contribution - helpme 2022_
This adds an ascii `map` to a given room which can be viewed with the `map` command.
You can easily alter it to add special characters, room colors etc. The map shown is
dynamically generated on use, and supports all compass directions and up/down. Other
directions are ignored.
[Read the documentation](./Contrib-Ingame-Map-Display.md) - [Browse the Code](evennia.contrib.grid.ingame_map_display)
### Contrib: `mapbuilder` ### Contrib: `mapbuilder`
_Contribution by Cloud_Keeper 2016_ _Contribution by Cloud_Keeper 2016_
@ -459,6 +473,7 @@ and rule implementation like character traits, dice rolling and emoting._
:maxdepth: 1 :maxdepth: 1
Contrib-Buffs.md Contrib-Buffs.md
Contrib-Character-Creator.md
Contrib-Dice.md Contrib-Dice.md
Contrib-Health-Bar.md Contrib-Health-Bar.md
Contrib-RPSystem.md Contrib-RPSystem.md
@ -477,6 +492,16 @@ It is a common design pattern in RPGs, particularly action games.
### Contrib: `character_creator`
_Commands for managing and initiating an in-game character-creation menu._
Contribution by InspectorCaracal, 2022
[Read the documentation](./Contrib-Character-Creator.md) - [Browse the Code](evennia.contrib.rpg.character_creator)
### Contrib: `dice` ### Contrib: `dice`
_Contribution by Griatch, 2012_ _Contribution by Griatch, 2012_