mpo/VVVVVV
1
0
Fork 0
mirror of https://github.com/TerryCavanagh/VVVVVV.git synced 2024-12-22 17:49:43 +01:00
Code Issues Releases Wiki Activity

Add section on editing existing strings to README-programmers.txt

Browse source 
In the past I was thinking we could use some kind of feature in VVVVVV
to track outdated strings across language files. But as it turns out, a
manual solution is actually *perfect* (in combination with automatic
syncing): duplicating strings and marking the old one as outdated. We
started doing it in recent PRs, so let's make it official by adding it
to the readme.
This commit is contained in:
Dav999 2023-04-15 00:10:46 +02:00 committed by Misa Elizabeth Kai
parent bfe068096f
commit d072998995
1 changed files with 35 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

35
desktop_version/lang/README-programmers.txt
View file

@ -16,6 +16,41 @@ The max value indicates how many characters of space there is for the text, and
=== E D I T I N G E X I S T I N G S T R I N G S ===
Sometimes you need to make a partial change to text that has already been translated.
For example: you need to change the string "Press ENTER to stop" to "Press {button} to stop" (because you made that hotkey configurable).
Please do *not* simply find-and-replace the text in the language files, nor remove the old string when you add the new one. (Whether you keep the translations or not.)
Instead, duplicate the string in the English language file, putting your version underneath the old version, and mark the old version with the explanation "***OUTDATED***".
For example:
<string english="Press ENTER to stop" translation="" explanation="stop super gravitron"/>
↓ ↓ ↓
<string english="Press ENTER to stop" translation="" explanation="***OUTDATED***"/>
<string english="Press {button} to stop" translation="" explanation="stop super gravitron"/>
The game won't be using the outdated string anymore - it's only still in the language files to carry the existing translations for reference. Once a translator updates the language files, they can reuse parts of the old translation for the new version of the string.
english | translation | explanation
=================================================================================
Press ENTER to stop | Appuyez sur ENTRÉE pour arrêter | ***OUTDATED***
---------------------------------------------------------------------------------
Press {button} to stop | ? ? ? | stop super gravitron
Eventually, once all languages are up-to-date, these outdated strings can be cleaned up.
Of course, when you remove strings without replacement, you can simply remove them from the (English) language file.
=== T E X T P R I N T I N G ===
These are the text printing functions: