Modding:Translations - Revision history

imported>Quicksilver: /* How translations work */

2024-12-04T02:16:51Z

How translations work

← Older revision		Revision as of 02:16, 4 December 2024
Line 45:		Line 45:
	\| <samp>zh.json</samp>		\| <samp>zh.json</samp>
	\|-		\|-
	\| Custom ~~languages~~		\| ''Custom''
	\| ''file name matches the language's <samp>LanguageCode</samp> field''		\| file name matches the language's <samp>LanguageCode</samp> field
	\|}		\|}

imported>Quicksilver: /* How translations work */ alphabetically

2024-12-04T02:02:51Z

How translations work: alphabetically

← Older revision		Revision as of 02:02, 4 December 2024
Line 12:		Line 12:
	! File name		! File name
	\|-		\|-
	\| ~~Chinese~~		\| German
	\| <samp>zh.json</samp>		\| <samp>de.json</samp>
			\|-
			\| Spanish
			\| <samp>es.json</samp>
	\|-		\|-
	\| French		\| French
	\| <samp>fr.json</samp>		\| <samp>fr.json</samp>
	\|-
	~~\| German~~
	~~\| <samp>de.json</samp>~~
	\|-
	~~\| Hungarian~~
	~~\| <samp>hu.json</samp>~~
	\|-		\|-
	\| Italian		\| Italian
Line 32:		Line 29:
	\| Korean		\| Korean
	\| <samp>ko.json</samp>		\| <samp>ko.json</samp>
			\|-
			\| Hungarian
			\| <samp>hu.json</samp>
	\|-		\|-
	\| Portuguese		\| Portuguese
Line 38:		Line 38:
	\| Russian		\| Russian
	\| <samp>ru.json</samp>		\| <samp>ru.json</samp>
	\|-
	~~\| Spanish~~
	~~\| <samp>es.json</samp>~~
	\|-		\|-
	\| Turkish		\| Turkish
	\| <samp>tr.json</samp>		\| <samp>tr.json</samp>
	\|-		\|-
	\| ~~custom~~ languages		\| Chinese
			\| <samp>zh.json</samp>
			\|-
			\| Custom languages
	\| ''file name matches the language's <samp>LanguageCode</samp> field''		\| ''file name matches the language's <samp>LanguageCode</samp> field''
	\|}		\|}

imported>Quicksilver at 01:56, 4 December 2024

2024-12-04T01:56:39Z

← Older revision		Revision as of 01:56, 4 December 2024
Line 141:		Line 141:
	[[es:Modding:Traducciones]]		[[es:Modding:Traducciones]]
	[[pt:Modificações:Traduções]]		[[pt:Modificações:Traduções]]
	[[ru:Модификации:~~Руководство по переводу модификаций~~]]		[[ru:Модификации:Перевод]]
	[[tr:Modlama:Çeviriler]]		[[tr:Modlama:Çeviriler]]
	[[zh:模组:翻译模组]]		[[zh:模组:翻译模组]]

imported>Peaw at 12:13, 26 July 2024

2024-07-26T12:13:27Z

← Older revision		Revision as of 12:13, 26 July 2024
Line 142:		Line 142:
	[[pt:Modificações:Traduções]]		[[pt:Modificações:Traduções]]
	[[ru:Модификации:Руководство по переводу модификаций]]		[[ru:Модификации:Руководство по переводу модификаций]]
			[[tr:Modlama:Çeviriler]]
	[[zh:模组:翻译模组]]		[[zh:模组:翻译模组]]

imported>Lilly: /* How to translate a mod */ Added info about the 'Internationalization' mod translation tool mod.

2024-03-30T08:13:36Z

How to translate a mod: Added info about the 'Internationalization' mod translation tool mod.

← Older revision		Revision as of 08:13, 30 March 2024
Line 71:		Line 71:
	* If you see broken symbols in-game, try saving the translation file with UTF-8 encoding.		* If you see broken symbols in-game, try saving the translation file with UTF-8 encoding.
	* You can test translation changes in-game without restarting the game. Enter <code>reload_i18n</code> into the SMAPI console to reload translations. (If a mod internally cached a translation, it may not be updated.)		* You can test translation changes in-game without restarting the game. Enter <code>reload_i18n</code> into the SMAPI console to reload translations. (If a mod internally cached a translation, it may not be updated.)
			* There's an [https://www.nexusmods.com/stardewvalley/mods/21317 Internationalization] mod in development that aims to simplify the translation process. In particular updating existing translations. It replaces steps 2-4 above. If you install that and run the game, you can open a page in your web browser to update translations of your installed mods live. It takes care of the json & utf-8 encoding so you don't have to. It's very new, so it might still have bugs.

	===How to provide mod translations===		===How to provide mod translations===

imported>Pathoschild: /* For modders */ + translation summary

2022-01-27T05:28:11Z

For modders: + translation summary

← Older revision		Revision as of 05:28, 27 January 2022
Line 91:		Line 91:
	===Using translations===		===Using translations===
	For help using translations, see [[Modding:Modder Guide/APIs/Translation]].		For help using translations, see [[Modding:Modder Guide/APIs/Translation]].

			===Translation summary===
			If your mod is [[Modding:Open source\|open-source]], you can add a translation summary to your repository's <samp>README.md</samp> file ([https://github.com/Pathoschild/StardewMods/#translating-the-mods see an example]). This makes it much more likely that translators will contribute translations for your mod since it...
			* indicates that contributions are welcome;
			* explains how to provide translations;
			* and provides a summary of each mod's translation status and links.

			You can [https://gist.github.com/Pathoschild/040ff6c8dc863ed2a7a828aa04447033 auto-generate the translation summary using a script].

	===Request translations===		===Request translations===
	<ol>		<ol>
	<li>Before you start:		<li>Before you start:
	# Your mod '''must''' be open-source on a public site like [https://github.com/ GitHub].<br />''This is important for the modders curating the request list, since it lets them (a) check the current status of your mod translations to keep requests up-to-date, (b) answer questions from translators if needed, and (c) submit a pull request with any translations received when the ticket is closed if you stop responding.''		# Your mod '''must''' be [[Modding:Open source\|open-source]] on a public site like [https://github.com/ GitHub].<br />''This is important for the modders curating the request list, since it lets them (a) check the current status of your mod translations to keep requests up-to-date, (b) answer questions from translators if needed, and (c) submit a pull request with any translations received when the ticket is closed if you stop responding.''
	# If you have partial translations, copy any missing translations into all translation files and mark them with <code>// TODO</code>. (That way translators only need to look at their language's file, they don't need to compare it with <samp>default.json</samp>.)		# If you have partial translations, copy any missing translations into all translation files and mark them with <code>// TODO</code>. (That way translators only need to look at their language's file, they don't need to compare it with <samp>default.json</samp>.)
	# Make sure you watch the request and you have time to reply to questions! Your request will be closed if you don't respond to a question on the ticket within 72 hours.		# Make sure you watch the request and you have time to reply to questions! Your request will be closed if you don't respond to a question on the ticket within 72 hours.

imported>Pathoschild: update for custom languages

2021-12-06T01:12:22Z

update for custom languages

← Older revision		Revision as of 01:12, 6 December 2021
Line 46:		Line 46:
	\|-		\|-
	\| custom languages		\| custom languages
	~~\| {{SMAPI upcoming\|3.13.0~~\|''file name matches the language's <samp>LanguageCode</samp> field''}}		\| ''file name matches the language's <samp>LanguageCode</samp> field''
	\|}		\|}

Line 124:		Line 124:
	<li>Watch your notifications so you know when someone contributes translations or answers a question!</li>		<li>Watch your notifications so you know when someone contributes translations or answers a question!</li>
	</ol>		</ol>

			==See also==
			* [[Modding:Custom languages]]

	[[Category:Modding]]		[[Category:Modding]]

imported>Margotbean: Text replacement - "tt>" to "samp>"

2021-11-04T18:48:31Z

Text replacement - "tt>" to "samp>"

← Older revision		Revision as of 18:48, 4 November 2021
Line 5:		Line 5:
	==For translators==		==For translators==
	===How translations work===		===How translations work===
	Each mod has an <tt>i18n</tt> folder containing the translation files (if it supports translation), which you can open in a normal text editor like Notepad. The folder always has a <tt>default.json</tt> (which has the default English text), plus any of these files:		Each mod has an <samp>i18n</samp> folder containing the translation files (if it supports translation), which you can open in a normal text editor like Notepad. The folder always has a <samp>default.json</samp> (which has the default English text), plus any of these files:

	{\| class="wikitable"		{\| class="wikitable"
Line 13:		Line 13:
	\|-		\|-
	\| Chinese		\| Chinese
	\| <tt>zh.json</tt>		\| <samp>zh.json</samp>
	\|-		\|-
	\| French		\| French
	\| <tt>fr.json</tt>		\| <samp>fr.json</samp>
	\|-		\|-
	\| German		\| German
	\| <tt>de.json</tt>		\| <samp>de.json</samp>
	\|-		\|-
	\| Hungarian		\| Hungarian
	\| <tt>hu.json</tt>		\| <samp>hu.json</samp>
	\|-		\|-
	\| Italian		\| Italian
	\| <tt>it.json</tt>		\| <samp>it.json</samp>
	\|-		\|-
	\| Japanese		\| Japanese
	\| <tt>ja.json</tt>		\| <samp>ja.json</samp>
	\|-		\|-
	\| Korean		\| Korean
	\| <tt>ko.json</tt>		\| <samp>ko.json</samp>
	\|-		\|-
	\| Portuguese		\| Portuguese
	\| <tt>pt.json</tt>		\| <samp>pt.json</samp>
	\|-		\|-
	\| Russian		\| Russian
	\| <tt>ru.json</tt>		\| <samp>ru.json</samp>
	\|-		\|-
	\| Spanish		\| Spanish
	\| <tt>es.json</tt>		\| <samp>es.json</samp>
	\|-		\|-
	\| Turkish		\| Turkish
	\| <tt>tr.json</tt>		\| <samp>tr.json</samp>
	\|-		\|-
	\| custom languages		\| custom languages
	\| {{SMAPI upcoming\|3.13.0\|''file name matches the language's <tt>LanguageCode</tt> field''}}		\| {{SMAPI upcoming\|3.13.0\|''file name matches the language's <samp>LanguageCode</samp> field''}}
	\|}		\|}

Line 63:		Line 63:
	===How to translate a mod===		===How to translate a mod===
	# Install the mod normally.		# Install the mod normally.
	# Open the file you want to edit in its <tt>i18n</tt> folder. (If the file doesn't exist for your language yet, just copy <tt>default.json</tt> and rename it.)		# Open the file you want to edit in its <samp>i18n</samp> folder. (If the file doesn't exist for your language yet, just copy <samp>default.json</samp> and rename it.)
	# Edit the translations as needed (see ''[[#How translations work\|how translations work]]'' above).		# Edit the translations as needed (see ''[[#How translations work\|how translations work]]'' above).
	# Launch the game and choose your language. The mod should show the translation text you entered.		# Launch the game and choose your language. The mod should show the translation text you entered.
Line 96:		Line 96:
	<li>Before you start:		<li>Before you start:
	# Your mod '''must''' be open-source on a public site like [https://github.com/ GitHub].<br />''This is important for the modders curating the request list, since it lets them (a) check the current status of your mod translations to keep requests up-to-date, (b) answer questions from translators if needed, and (c) submit a pull request with any translations received when the ticket is closed if you stop responding.''		# Your mod '''must''' be open-source on a public site like [https://github.com/ GitHub].<br />''This is important for the modders curating the request list, since it lets them (a) check the current status of your mod translations to keep requests up-to-date, (b) answer questions from translators if needed, and (c) submit a pull request with any translations received when the ticket is closed if you stop responding.''
	# If you have partial translations, copy any missing translations into all translation files and mark them with <code>// TODO</code>. (That way translators only need to look at their language's file, they don't need to compare it with <tt>default.json</tt>.)		# If you have partial translations, copy any missing translations into all translation files and mark them with <code>// TODO</code>. (That way translators only need to look at their language's file, they don't need to compare it with <samp>default.json</samp>.)
	# Make sure you watch the request and you have time to reply to questions! Your request will be closed if you don't respond to a question on the ticket within 72 hours.		# Make sure you watch the request and you have time to reply to questions! Your request will be closed if you don't respond to a question on the ticket within 72 hours.
	# The <tt>default.json</tt> must be complete and in English. If your main language isn't English and you need help preparing it, we can help! Just create a request the same way below, but choose <code>needs: English copyediting</code> as the label instead.		# The <samp>default.json</samp> must be complete and in English. If your main language isn't English and you need help preparing it, we can help! Just create a request the same way below, but choose <code>needs: English copyediting</code> as the label instead.
	</li>		</li>

imported>Pathoschild: /* How translations work */ + custom languages in Stardew Valley 1.5.5

2021-09-15T14:20:33Z

How translations work: + custom languages in Stardew Valley 1.5.5

← Older revision		Revision as of 14:20, 15 September 2021
Line 44:		Line 44:
	\| Turkish		\| Turkish
	\| <tt>tr.json</tt>		\| <tt>tr.json</tt>
			\|-
			\| custom languages
			\| {{SMAPI upcoming\|3.13.0\|''file name matches the language's <tt>LanguageCode</tt> field''}}
	\|}		\|}

imported>Margotbean: +RU link

2021-08-17T17:10:20Z

+RU link

← Older revision		Revision as of 17:10, 17 August 2021
Line 126:		Line 126:
	[[es:Modding:Traducciones]]		[[es:Modding:Traducciones]]
	[[pt:Modificações:Traduções]]		[[pt:Modificações:Traduções]]
			[[ru:Модификации:Руководство по переводу модификаций]]
	[[zh:模组:翻译模组]]		[[zh:模组:翻译模组]]