HelpUsTranslate: Difference between revisions

(8 intermediate revisions by 4 users not shown)

Line 6:

=== Discord ===

For help please visit the '''#mods''' channel on [https://www.introversion.co.uk/last-starship/discord Discord].

== Overflowing Text and Missing Translations ==

If you spot any overflowing text or places where the game is still using hard-coded English strings, please file a bug report (if one doesn't exist already) on the

* [https://bugs.introversion.co.uk bug tracker].

A screenshot with some kind of callout or highlight of the particular area would be a very useful.

== Mistakes in existing Translations ==

If you notice a translation error, please let us know about it on the [https://github.com/Introversion-Software/LastStarshipIssues/issues/new?template=localisation-feedback.yml bug tracker] (bugs.introversion.co.uk).

If you notice a translation error, please let us know about it on the

* [https://github.com/Introversion-Software/LastStarshipIssues/issues/new?template=localisation-feedback.yml bug tracker (localisation bug entry form)] (bugs.introversion.co.uk).

Remember to include:

* which language,

* the incorrect phrase and the

* correct translation.

* a screenshot, if possible.

~~Remember to let us know which language~~, the ~~incorrect phrase and the correct translation~~. ~~A screenshot~~ would be ~~really helpful~~.

If the translation is good, but the rendering on screen is bad, a [https://bugs.introversion.co.uk general bug report] would be very welcome.

If ~~the~~ translation is ~~good,~~ but ~~the rendering on screen~~ is ~~bad, a general~~ bug ~~report would be very welcome~~.

== Inconsistency in Translation ==

If you notice an inconsistency in translation please let us know. For example, if an object type is translated in one way but then referred to in a different way.

Or if a ship name is translated in different ways.

Or other inconsistency.

* [https://github.com/Introversion-Software/LastStarshipIssues/issues/new?template=localisation-feedback.yml bug tracker (localisation bug entry form)] (bugs.introversion.co.uk).

== Translation Tools (Available from Alpha 14) ==

Line 18:

Line 41:

=== Translator Assist ===

In preferences.txt ~~( On Windows, <code>%APPLOCALDATA%\Introversion\LastStarship\preferences.txt</code> and <code>~/Library/Application Support/LastStarship/preferences.txt</code> on Mac OS X )~~ there is a preference called <code>TranslatorAssist</code> .

In preferences.txt there is a preference called <code>TranslatorAssist</code>. {{Data directories|preferences.txt}}

[[File:Translation Editor.png|thumb|In-game Translation Editor]]

[[File:Image.png|thumb]]

[[File:LanguageKeys.png|thumb]]

Line 25:

Line 49:

* Pressing <code>Alt</code> will display the English text instead of the currently loaded language. Actually this is implemented by temporarily loading the English language strings and then, when <code>Alt</code> is released, reloading the language.

* Pressing <code>Ctrl</code> will display the name of the key instead of the actual translated phrase (or English fallback).

* Pessing <code>F8</code> will bring up the in-game translation editor. See below.

=== Translation Editor In Game ===

If you enable '''Translator Assist''' you will be able to press <code>F8</code> to bring up the in game editor. You can search for the key you would like to change and make the change directly, which should be visible in game immediately.

Once you have finished making your changes press the <code>Browse</code> button to bring up the File Explorer on the language folder, where you can find <code>language.csv</code>. This is the file that contains your changes and that you should share with Introversion (e.g. talk to @Totengeist or @jknotten on the Discord)

=== ~~Contributing Translations~~ ===

See this video tutorial:

=== Editing Language.CSV directly ===

In the same directory as preferences.txt, you will find a folder called <code>language</code>

Line 47:

Line 81:

You can copy just the lines that you want to change from <code>original.csv</code> into <code>language.csv</code>, or you can copy all the whole contents of <code>original.csv</code>.

=== Characters don't appear properly ===

[[File:SpreadsheetTextImportScreen.png|thumb]]

If you are opening '''language.csv''' with a spreadsheet application like LibreOffice Calc or Microsoft Excel, you may see a ''Text Import'' screen. Please ensure that the ''Character set'' is set to Unicode (UTF-8), or you may see some characters not display properly.

=== Format of language.csv ===

Line 65:

Line 103:

'''translation''': the translation itself.

=== Double Quotes "" ===

Note that because language.csv is a comma-separated value text file, if there are any commas present in the English or the Translation, then the value should be surrounded by double quotes "".

For example, if the English was:

Hello, John.

Then in the language.csv file, it should have "" around it:

"Hello, John."

This is so that the game can tell which commas separate fields of the translation table and which are part of the text itself. Note that the enclosing double quotes ("") will be ignored by the game and won't render on the screen.

=== Markers in the text ===

@@ Line 6: / Line 6: @@
 === Discord ===
 For help please visit the '''#mods''' channel on [https://www.introversion.co.uk/last-starship/discord Discord].
+== Overflowing Text and Missing Translations ==
+If you spot any overflowing text or places where the game is still using hard-coded English strings, please file a bug report (if one doesn't exist already) on the
+* [https://bugs.introversion.co.uk bug tracker].
+A screenshot with some kind of callout or highlight of the particular area would be a very useful.
 == Mistakes in existing Translations ==
-If you notice a translation error, please let us know about it on the [https://github.com/Introversion-Software/LastStarshipIssues/issues/new?template=localisation-feedback.yml bug tracker] (bugs.introversion.co.uk).
+If you notice a translation error, please let us know about it on the
+* [https://github.com/Introversion-Software/LastStarshipIssues/issues/new?template=localisation-feedback.yml bug tracker (localisation bug entry form)] (bugs.introversion.co.uk).
+Remember to include:
+* which language,
+* the incorrect phrase and the
+* correct translation.
+* a screenshot, if possible.
-Remember to let us know which language, the incorrect phrase and the correct translation. A screenshot would be really helpful.
+If the translation is good, but the rendering on screen is bad, a [https://bugs.introversion.co.uk general bug report] would be very welcome.
-If the translation is good, but the rendering on screen is bad, a general bug report would be very welcome.
+== Inconsistency in Translation ==
+If you notice an inconsistency in translation please let us know. For example, if an object type is translated in one way but then referred to in a different way.
+Or if a ship name is translated in different ways.
+Or other inconsistency.
+* [https://github.com/Introversion-Software/LastStarshipIssues/issues/new?template=localisation-feedback.yml bug tracker (localisation bug entry form)] (bugs.introversion.co.uk).
 == Translation Tools (Available from Alpha 14) ==
@@ Line 18: / Line 41: @@
 === Translator Assist ===
-In preferences.txt ( On Windows, <code>%APPLOCALDATA%\Introversion\LastStarship\preferences.txt</code> and <code>~/Library/Application Support/LastStarship/preferences.txt</code> on Mac OS X ) there is a preference called <code>TranslatorAssist</code> .
+In preferences.txt there is a preference called <code>TranslatorAssist</code>. {{Data directories|preferences.txt}}
+[[File:Translation Editor.png|thumb|In-game Translation Editor]]
 [[File:Image.png|thumb]]
 [[File:LanguageKeys.png|thumb]]
@@ Line 25: / Line 49: @@
 * Pressing <code>Alt</code> will display the English text instead of the currently loaded language. Actually this is implemented by temporarily loading the English language strings and then, when <code>Alt</code> is released, reloading the language.
 * Pressing <code>Ctrl</code> will display the name of the key instead of the actual translated phrase (or English fallback).
+* Pessing <code>F8</code> will bring up the in-game translation editor. See below.
+=== Translation Editor In Game ===
+If you enable '''Translator Assist''' you will be able to press <code>F8</code>  to bring up the in game editor. You can search for the key you would like to change and make the change directly, which should be visible in game immediately.
+Once you have finished making your changes press the <code>Browse</code> button to bring up the File Explorer on the language folder, where you can find <code>language.csv</code>. This is the file that contains your changes and that you should share with Introversion (e.g. talk to @Totengeist or @jknotten on the Discord)
-=== Contributing Translations ===
+See this video tutorial:
+{{#ev:youtube|https://www.youtube.com/watch?v=BzXZjIeZjDc}}
+=== Editing Language.CSV directly ===
 In the same directory as preferences.txt, you will find a folder called <code>language</code>
@@ Line 47: / Line 81: @@
 You can copy just the lines that you want to change from <code>original.csv</code> into <code>language.csv</code>, or you can copy all the whole contents of <code>original.csv</code>.
+=== Characters don't appear properly ===
+[[File:SpreadsheetTextImportScreen.png|thumb]]
+If you are opening '''language.csv''' with a spreadsheet application like LibreOffice Calc or Microsoft Excel, you may see a ''Text Import'' screen. Please ensure that the ''Character set'' is set to Unicode (UTF-8), or you may see some characters not display properly.
 === Format of language.csv ===
@@ Line 65: / Line 103: @@
 '''translation''': the translation itself.
+=== Double Quotes "" ===
+Note that because language.csv is a comma-separated value text file, if there are any commas present in the English or the Translation, then the value should be surrounded by double quotes "".
+For example, if the English was:
+Hello, John.
+Then in the language.csv file, it should have "" around it:
+"Hello, John."
+This is so that the game can tell which commas separate fields of the translation table and which are part of the text itself. Note that the enclosing double quotes ("") will be ignored by the game and won't render on the screen.
 === Markers in the text ===