From c6d9273798abdd606b6176aa90ba211c2d584aea Mon Sep 17 00:00:00 2001 From: Griatch Date: Sun, 2 Oct 2022 11:19:11 +0200 Subject: [PATCH] Update docs on i18n. Add new contrib --- docs/source/Concepts/Internationalization.md | 27 ++++++++++---------- docs/source/Contribs/Contribs-Overview.md | 25 ++++++++++++++++++ 2 files changed, 38 insertions(+), 14 deletions(-) diff --git a/docs/source/Concepts/Internationalization.md b/docs/source/Concepts/Internationalization.md index 733d28dd86..0084c0ff1d 100644 --- a/docs/source/Concepts/Internationalization.md +++ b/docs/source/Concepts/Internationalization.md @@ -58,21 +58,21 @@ the server to activate i18n. ```{important} - 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 - 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 - can't easily change from your mygame/ folder. Outputs from Commands and - Typeclasses are generally *not* translated, nor are console/log outputs. +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 +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 +can't easily change from your mygame/ folder. Outputs from Commands and +Typeclasses are generally *not* translated, nor are console/log outputs. ``` ```{sidebar} Windows users - If you get errors concerning `gettext` or `xgettext` on Windows, - see the `Django documentation `_ - A self-installing and up-to-date version of gettext for Windows (32/64-bit) is - available on `Github `_ +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). +A self-installing and up-to-date version of gettext for Windows (32/64-bit) is +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 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 -English, clarity is more important. Many languages may also use the English term -normally and reaching for a translation may make the result sound awkward -instead. +outside of a `{...}` tag. A mix of English and your language may be clearer +than you forcing some ad-hoc translation for a term everyone usually reads in +English anyway. Original: "\nError loading cmdset: No cmdset class '{classname}' in '{path}'. \n(Traceback was logged {timestamp})" diff --git a/docs/source/Contribs/Contribs-Overview.md b/docs/source/Contribs/Contribs-Overview.md index 6ff630393b..76ae1c0b4e 100644 --- a/docs/source/Contribs/Contribs-Overview.md +++ b/docs/source/Contribs/Contribs-Overview.md @@ -363,6 +363,7 @@ contribs related to rooms, exits and map building._ :maxdepth: 1 Contrib-Extended-Room.md +Contrib-Ingame-Map-Display.md Contrib-Mapbuilder.md Contrib-Simpledoor.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` _Contribution by Cloud_Keeper 2016_ @@ -459,6 +473,7 @@ and rule implementation like character traits, dice rolling and emoting._ :maxdepth: 1 Contrib-Buffs.md +Contrib-Character-Creator.md Contrib-Dice.md Contrib-Health-Bar.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` _Contribution by Griatch, 2012_