Localization

The Localization for WalkScape is open source, which means that you, yes YOU, can contribute. Please note that this article will contain light spoilers for many parts of the game.

Getting started

WalkScape uses a tool called Tolgee to manage the translations. Follow these steps to get started:

1. Visit the WalkScape translations page
2. Click the "Sign up" button
3. Enter your details (or alternatively, use Github or Google sign in methods)
   1. Enter your WalkScape or Discord username as your first name
   2. Enter your email
   3. Enter "WalkScape" as the organization
   4. Enter a secure password
   5. Click the "Submit" button
4. Let Schamppu or Bwuh on Discord know you've signed up and they will add you to the project
5. Read the translation guidelines
6. Read the Tolgee instructions

Translation Guidelines

Keep the goal in mind

We want WalkScape to be enjoyed by as many players as possible. The following guidelines should help to achieve this. They can all be summarized to the SCARF core values we find important, which are:

Simplicity	Don't overcomplicate things
Clarity	Keep it understandable for all ages
Accessibility	Some people might have vision problems!
Relatability	Players feel more immersed when they can relate to things
Fun	Last but definitely not least, keep it fun for the player, but also for yourself! Feel free to add a healthy dose of humor!

As long as you keep asking yourself "Is this SCARF?", not much can go wrong!\

Mind the variables

Some entries might have a reference to variables. You can reorder the placements of these code blocks in your translated text as it makes sense in the target language, however do not alter anything within them. They might look like:

$pointCount achievement points

Do not translate anything from the "$" until the next space.

Have <numberProgress current="${current}" max="${max}" style="achievement_text" maxStyle="achievement_text" /> different gems in your inventory.

Do not translate anything from the opening "<" to the closing "/>" angle brackets. Anything between HTML opening and closing tags should still be translated. For example:

Welcome to the <c>Kallaheim's Frosty Finds</c>!

In this case, the shop name should always remain within those tags when translating it to the target language.

Do not touch text within code blocks or variables.

Pluralization

Different languages use different rules for pluralization. These rules per language can be found here. If a translation key has the "plurals" tag, these rules should be followed. If a pluralization entry is not applicable to your language, you can enter a "-". This way everyone knows it's been looked at but not applicable, and it will not be used in the game.

Machine translation

Tolgee offers translation suggestions using machine learning. These are not always reliable as they lack context and consistency. We recommend first thinking of a translation yourself without looking at the suggestion, and then using it to potentially correct and/or improve your translation.

Cultural references

It is okay to replace specific cultural references to something that makes more sense in the target language. Be careful that if it relates to a specific item, it should still match the image of that item.

References to other media

Some text might reference other media such as books, movies, games, music, or memes.

• If the referenced text has an official translation, use that. Subtitles for movies can be found here.
• If there is no official translation but the English text is well known in the target language, it is okay to keep it English.
• If not, it can be translated.

Names of characters and locations

• Common English first names of characters may be changed to names that are common in the target language. This helps keep the player immersed.
• Last names and names of locations should only be translated if they are of English origin. These names should already provide the player with some background information of the subject. Some examples:
  • Peter Banksworth
  • Galeforge
  • Painful Islands
• If the names cannot be directly translated, they can be slightly altered to match common naming styles of the target language or to switch out uncommon/unused characters for more common ones. Some examples for Dutch:
  • Jarvonia becomes Jarvonië
  • Wallisia becomes Wallisië
  • Wrentmark becomes Frentmark
• If a real person or a person from other media is referenced, do not change their names. Some examples:
  • Flora Floursifter
• Non-English names should not be translated. They can however be changed into the target language's characters instead of the Latin alphabet. Some examples:
  • Runa Norrberga
  • Rid Raddak
  • Ewerethien

Text style

• Stick to the same capitalization style as the original text if this makes sense in the target language. Following the target language's rules should always take priority.
• Try to keep the translation to a similar length as the original text, or shorter. This makes sure all text is displayed correctly.
• Try to stick to simple and conventional language and avoid difficult or long words. We favor using more words instead of such words, if possible (see previous point). Nobody should be looking up words to see what they mean.
• Avoid using multiple different translations for the same word to prevent confusion.

Accessibility

We want players that are visually impaired to be able to enjoy the game just as much as anyone else. They might be using screen readers to have their device read out loud what's on the screen and/or they might have trouble seeing images. To increase immersion, not just for them but for everyone, try to use descriptive language where applicable. This is especially important when translating anything that directly relates to an image, such as:

• Item descriptions
• Location descriptions
• NPC descriptions
• Character customization

The translation community

While looking through translations, remember that you can comment on the original text or already made translations you think could be improved! If you have any questions, or just want to have a second opinion when you're not sure about something, feel free to reach out to the community on Discord in the #localization channel. If it is language specific, you can ask in the specific thread of the target language.

Tolgee Instructions

Navigation

Navigation through Tolgee is done by using the main menu to the left of the page. Translations can be made on the aptly named "Translations" page, which is the third option from the top. In the dropdown selection at the top right, make sure both English and the target language are selected. You can optionally enable any other language you are interested in and could take inspiration from.

Translating

To start translating, it is advised to only display entries that still need work done. This can be done by clicking the filter dropdown and enabling one of the filter options:

Missing translation	These entries are not translated yet
Outdated translation	These entries were translated, but the original text has been edited causing the translation to be currently incorrect
Target language > Translated	These entries are translated, but require reviewing

To add, edit, or review a translation, click on the area that has the target language, below the original text. You can see this area highlighted in the following image.

Clicking this area will open a new pane. In the left half of this pane, you can see the current translation if there is one. In the right half, there are three tabs you can switch between.

Edit tab

The edit tab is opened by default. This is where the translation can be entered or edited. It has a cancel button and a save button. Both will close the edit pane, but only pressing the save button will save your edit. Clicking the icon next to those buttons marks the translation as reviewed. This should always be done by someone else to signify that the translation is correct, the person who made the edit should never do this themselves.

On this tab there will also be two tools that can aid you in your translation efforts.

Translation memory

This shows translations of entries that are similar to the entry you are currently editing. The percentage shown will indicate how similar it is to this entry. If it is 100%, it means that the original text of both entries are completely the same. However, this does not mean that the translation should also be the same. You can check the key name of the entry to get an understanding of the context the text is used in. More information about the structure of this key can be found here.

Machine translation

There will also be a suggested translation, provided by either Amazon Translate, DeepL, or Google Translate. Take some caution when using this, though. These suggestions are not always reliable as they lack context and consistency. We recommend first thinking of a translation yourself without looking at the suggestion, and then using it to potentially correct and/or improve your translation.

The edit tab

Comments tab

On this tab, users can read and place comments for this specific entry. It can be used to further elaborate on choices made for this translation or to add some feedback. Comments can be resolved by hovering over one and clicking the check icon that appears. This should only be done by the person who has placed the comment, to signify that the feedback has been addressed correctly or is no longer applicable.

This can also be accessed for the original text by hovering over it and clicking the speech bubble button to the right.

History tab

This tab displays all changes that have been made to this translation for this specific language. You can see who changed what at what time.

This can also be accessed for the original text by hovering over it, clicking the speech bubble button to the right and opening the history tab.

Entry keys

Entries are identified by a unique key. These keys follow the structure <namespace>.<type>.<identifier>. The namespace can be one of three:

singular	This is the default
plurals	These should follow the pluralization rules
maps	These use mapping and are often grouped with similar entries

The type can be seen as the category, such as items, locations, skills, etc. And finally there's the identifier. This can consist of multiple keys separated by a period. They can be used to get a better understanding of the context in which the text is used.

Some entries, specifically item names, will also have a camera icon next to it. Click this will show what the item looks like in game. This is a useful tool when translating item descriptions.