AtomicTorch Localization Utility - Revision history

Silberspeer at 06:25, 25 June 2015

2015-06-25T06:25:28Z

← Older revision		Revision as of 06:25, 25 June 2015
Line 200:		Line 200:

	'''Reloading the core mod''' If you need to discard all the changes you made after running the Localization tool, there is button for it. Press it, confirm and all the changes will be reset.		'''Reloading the core mod''' If you need to discard all the changes you made after running the Localization tool, there is button for it. Press it, confirm and all the changes will be reset.

			{{Modding}}

Silberspeer at 06:24, 25 June 2015

2015-06-25T06:24:35Z

← Older revision		Revision as of 06:24, 25 June 2015
Line 1:		Line 1:
	~~{{Draft}}~~		== Unpack the core file ==
			Before starting to work with the Localization Utility you need to unpack the core file which contains all the content (including languages) used in your current version of the game.

	~~== Unpack the core file ==~~		Usually you can find it in:
	~~Before starting work with the Localization Utility,~~ you ~~need to unpack the core file, which contains all the languages, used in your currennt version of the game. Usually~~ it is in C:\Program Files (x86)\Steam\steamapps\common\VoidExpanse\Core\core.cpk		* '''Steam''': ''C:\Program Files (x86)\Steam\steamapps\common\VoidExpanse\Core\core.cpk''
	This file actually is a .zip file, so you can unpack it with any archiver, which can unpack .zip files. You can even rename the file to core.zip before unpacking. Create a folder for contents of this archive and unpack it there.		* '''AtomicTorch Starter''': ''C:\Users\<USERNAME>\AppData\Local\AtomicTorchStudio\Launcher\Games\VoidExpanse\Core\core.cpk''

			This file actually is a simple .zip file, so you can unpack it with any archiver software which can unpack .zip files. You can even rename the file to core.zip before unpacking. Create a folder for contents of this archive and unpack it there.

	== Download Localization Utility ==		== Download Localization Utility ==
	You can download localization utility here: http://atomictorch.com/Files/LocalizationUtility.zip		You can download localization utility here: http://atomictorch.com/Files/LocalizationUtility.zip

	Unpack it somewhere, it doesn't need installation. Run AtomicTorch_ModsLocalizationUtility.exe application.		Unpack it somewhere, it doesn't need installation. Run AtomicTorch_ModsLocalizationUtility.exe application.

	~~[[File~~:~~VoidExpanse_Localization_Tool_00.png\|400px]]~~		== Selecting the core package source ==
			The program needs you to select a source package which is going to be a basis for your work. This is the package we unpacked earlier. When you run the program for the first time it will show you this message:

	~~== Selecting the core package sourse ==~~		[[File:VoidExpanse_Localization_Tool_01.png\|400px]]
	~~The program needs you to select a sourse language package which is going to be a basis of your work~~. ~~This is the package we unpacked earlier. At the first run the program will show you this message:~~

	~~[[File:VoidExpanse_Localization_Tool_01~~.~~png\|400px]]~~		Press "Ok" and follow to the file browser window, where you need to select the folder where you have unpacked the .cpk package. You can always change the core folder, using "Select core mod folder" button at the main program screen.

	Press 'Ok' and follow to the brouse window, where you need to select the folder where you have unpacked the .cpk package. You can always change the core folder, using 'Select core mod folder' button at the main program screen.		After selecting this folder and confirming it, the program will go to the main localisation interface.
	After selecting this folder and ~~confiming~~ it, the program will go to the main localisation interface.

	[[File:VoidExpanse_Localization_Tool_03.png\|400px]]		[[File:VoidExpanse_Localization_Tool_03.png\|400px]]
Line 32:		Line 35:
	[[File:VoidExpanse_Localization_Tool_021.png\|400px]]		[[File:VoidExpanse_Localization_Tool_021.png\|400px]]

	Each language has its own configuration file and you need to create a new one. The easiest way is to copy the existing file and rename it according to the language you are going to localize. After that you need to open this file with notepad and change the corresponding parts of it according to the language you chose.		Each language has its own configuration file and you need to create a new one. The easiest way is to copy the existing file and rename it according to the language you are going to localize. After that you need to open this file with notepad and change the corresponding parts of it according to the language you chose.

	The imporant moment is that the game recognizes distinct language codes. So renaming the .xms file and changing it needs to be done referring the language code table below:		The imporant moment is that the game recognizes distinct language codes. So renaming the .xms file and changing it needs to be done referring the language code table below:
	{\| class="wikitable"		{\| class="wikitable"
Line 166:		Line 170:
	\|}		\|}

	After you renamed and edited the new .xml file you must ~~rerun~~ the program. When it starts, you will see the new language column there. All the fields it it are blank, this is where your work starts. Just click on the field, put your translation in and press Enter. The cursor switches to the next line below and you can start editing it by double-pressing Enter of clicking Left Mouse Button on it.		After you renamed and edited the new .xml file you must restart the program. When it starts you will see the new language column there. All the fields in it are blank for now, this is where your work starts. Just click on the field, put your translation in and press Enter. The cursor switches to the next line below and you can start editing it by double-pressing Enter of clicking Left Mouse Button on it.

	== Filter and Search ==		== Filter and Search ==
	Filter and Search fields upon the main editing window can make your work fast and more comfortable. If you put a word or ~~sentense~~ into the Filter field, the program will leave on the screen only the lines consisting that ~~sentense~~. If you put a part of the text to the Search field, the program will highlight all the text matches with this ~~sentense~~.		Filter and Search fields upon the main editing window can make your work fast and more comfortable. If you put a word or sentence into the Filter field, the program will leave on the screen only the lines consisting that sentence. If you put a part of the text to the Search field, the program will highlight all the text matches with this sentence.

	== Import and export of the CSV files ==		== Import and export of the CSV files ==
	The Localization Tool is able to use and create some external ~~sourses~~ of content. You can use any Microsoft Excel compatible programs and files for localisation.		The Localization Tool is able to use and create some external sources of content. You can use any Microsoft Excel compatible programs and files for localisation.

			=== Exporting ===
	'''Exporting''' is easy: just press "Export language as CSV" button on the main screen and select the folder and the name of the file you want to export to. Just confirm it when you are done with selecting the folder and choosing the name of the file. When you try to open this file by double-clicking it, you may meet such a window:		'''Exporting''' is easy: just press "Export language as CSV" button on the main screen and select the folder and the name of the file you want to export to. Just confirm it when you are done with selecting the folder and choosing the name of the file. When you try to open this file by double-clicking it, you may meet such a window:

Line 179:		Line 185:
	You need to specify how you want to open this file because there are many ways of doing it. In our case you just need to press "Ok".		You need to specify how you want to open this file because there are many ways of doing it. In our case you just need to press "Ok".

			=== Importing ===
	If you want to '''Import''' the the content from CSV-file, first you need to press "Import language as CSV" button. The program will offer you to select the file to import the content from. When you are done and confirmed it, the program will ask which languages need to be imported from the selected files:		If you want to '''Import''' the the content from CSV-file, first you need to press "Import language as CSV" button. The program will offer you to select the file to import the content from. When you are done and confirmed it, the program will ask which languages need to be imported from the selected files:

Line 185:		Line 192:
	Just check the boxes near the language codes you want and press "Next". The program will replace the existing core languages with the new content from the file. NOTE that you can import ONLY the languages which already have a .xml file created and have their column in the program. All other languages will be ignored.		Just check the boxes near the language codes you want and press "Next". The program will replace the existing core languages with the new content from the file. NOTE that you can import ONLY the languages which already have a .xml file created and have their column in the program. All other languages will be ignored.

			== Other features ==
	'''Hide/show languages''' Sometimes you may need to temporarily hide some languages to prevent confusing during the translation. To do so press "Hide/show languages" button on the main Localization Tool screen. The program will offer you to select the languages you want to hide:		'''Hide/show languages''' Sometimes you may need to temporarily hide some languages to prevent confusing during the translation. To do so press "Hide/show languages" button on the main Localization Tool screen. The program will offer you to select the languages you want to hide:

Line 190:		Line 198:

	Check the appropriate boxes and press "Next". To show the hidden languages again, you need to press "Hide/show languages" button again and just uncheck the boxes, then press "Next".		Check the appropriate boxes and press "Next". To show the hidden languages again, you need to press "Hide/show languages" button again and just uncheck the boxes, then press "Next".

	'''Reloading the core mod''' If you need to discard all the changes you made after running the Localization tool, there is button for it. Press it, confirm and all the changes will be reset.		'''Reloading the core mod''' If you need to discard all the changes you made after running the Localization tool, there is button for it. Press it, confirm and all the changes will be reset.

	~~Download:~~

	~~[http://atomictorch.com/Files/LocalizationUtility.zip AT Localization Utility]~~

Silberspeer at 09:50, 24 June 2015

2015-06-24T09:50:13Z

Silberspeer at 09:43, 24 June 2015

2015-06-24T09:43:02Z

Show changes

Atomic-admin: Created page with "{{Draft}} Download: [http://atomictorch.com/Files/LocalizationUtility.zip AT Localization Utility]"

2015-06-24T07:40:03Z

Created page with "{{Draft}} Download: [http://atomictorch.com/Files/LocalizationUtility.zip AT Localization Utility]"

New page

{{Draft}}

Download:

[http://atomictorch.com/Files/LocalizationUtility.zip AT Localization Utility]

← Older revision		Revision as of 09:50, 24 June 2015
Line 4:		Line 4:
	Before starting work with the Localization Utility, you need to unpack the core file, which contains all the languages, used in your currennt version of the game. Usually it is in C:\Program Files (x86)\Steam\steamapps\common\VoidExpanse\Core\core.cpk		Before starting work with the Localization Utility, you need to unpack the core file, which contains all the languages, used in your currennt version of the game. Usually it is in C:\Program Files (x86)\Steam\steamapps\common\VoidExpanse\Core\core.cpk
	This file actually is a .zip file, so you can unpack it with any archiver, which can unpack .zip files. You can even rename the file to core.zip before unpacking. Create a folder for contents of this archive and unpack it there.		This file actually is a .zip file, so you can unpack it with any archiver, which can unpack .zip files. You can even rename the file to core.zip before unpacking. Create a folder for contents of this archive and unpack it there.



	== Download Localization Utility ==		== Download Localization Utility ==
Line 12:		Line 10:

	[[File:VoidExpanse_Localization_Tool_00.png\|400px]]		[[File:VoidExpanse_Localization_Tool_00.png\|400px]]







	== Selecting the core package sourse ==		== Selecting the core package sourse ==
Line 25:		Line 17:

	Press 'Ok' and follow to the brouse window, where you need to select the folder where you have unpacked the .cpk package. You can always change the core folder, using 'Select core mod folder' button at the main program screen.		Press 'Ok' and follow to the brouse window, where you need to select the folder where you have unpacked the .cpk package. You can always change the core folder, using 'Select core mod folder' button at the main program screen.

	After selecting this folder and confiming it, the program will go to the main localisation interface.		After selecting this folder and confiming it, the program will go to the main localisation interface.

Line 31:		Line 22:

	== Editing and adding a new language ==		== Editing and adding a new language ==

	On the top left part of the screen you see a tabs which allow you to switch between different groups of textual content of the game. Starting with the third column of the main window there are languages columns, the lines conisting corresponding sentenses in different languages. Basically there are two languages, English-American and Russian. These localizations are ready and to start a new one, you need to add a new language column.		On the top left part of the screen you see a tabs which allow you to switch between different groups of textual content of the game. Starting with the third column of the main window there are languages columns, the lines conisting corresponding sentenses in different languages. Basically there are two languages, English-American and Russian. These localizations are ready and to start a new one, you need to add a new language column.

	To do so press 'Add new language' button. The program offers to create a new .xml file for your language and to open the folder, where these .xml files are stored. Agree to that.		To do so press 'Add new language' button. The program offers to create a new .xml file for your language and to open the folder, where these .xml files are stored. Agree to that.



	[[File:VoidExpanse_Localization_Tool_04.png\|400px]]		[[File:VoidExpanse_Localization_Tool_04.png\|400px]]









	When the folder opens, you will see something like that:		When the folder opens, you will see something like that:
Line 54:		Line 34:
	Each language has its own configuration file and you need to create a new one. The easiest way is to copy the existing file and rename it according to the language you are going to localize. After that you need to open this file with notepad and change the corresponding parts of it according to the language you chose.		Each language has its own configuration file and you need to create a new one. The easiest way is to copy the existing file and rename it according to the language you are going to localize. After that you need to open this file with notepad and change the corresponding parts of it according to the language you chose.
	The imporant moment is that the game recognizes distinct language codes. So renaming the .xms file and changing it needs to be done referring the language code table below:		The imporant moment is that the game recognizes distinct language codes. So renaming the .xms file and changing it needs to be done referring the language code table below:

	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
Line 186:		Line 165:
	\| vi_vn		\| vi_vn
	\|}		\|}


	After you renamed and edited the new .xml file you must rerun the program. When it starts, you will see the new language column there. All the fields it it are blank, this is where your work starts. Just click on the field, put your translation in and press Enter. The cursor switches to the next line below and you can start editing it by double-pressing Enter of clicking Left Mouse Button on it.		After you renamed and edited the new .xml file you must rerun the program. When it starts, you will see the new language column there. All the fields it it are blank, this is where your work starts. Just click on the field, put your translation in and press Enter. The cursor switches to the next line below and you can start editing it by double-pressing Enter of clicking Left Mouse Button on it.
Line 192:		Line 170:
	== Filter and Search ==		== Filter and Search ==
	Filter and Search fields upon the main editing window can make your work fast and more comfortable. If you put a word or sentense into the Filter field, the program will leave on the screen only the lines consisting that sentense. If you put a part of the text to the Search field, the program will highlight all the text matches with this sentense.		Filter and Search fields upon the main editing window can make your work fast and more comfortable. If you put a word or sentense into the Filter field, the program will leave on the screen only the lines consisting that sentense. If you put a part of the text to the Search field, the program will highlight all the text matches with this sentense.



	== Import and export of the CSV files ==		== Import and export of the CSV files ==
Line 202:		Line 178:

	You need to specify how you want to open this file because there are many ways of doing it. In our case you just need to press "Ok".		You need to specify how you want to open this file because there are many ways of doing it. In our case you just need to press "Ok".










	If you want to '''Import''' the the content from CSV-file, first you need to press "Import language as CSV" button. The program will offer you to select the file to import the content from. When you are done and confirmed it, the program will ask which languages need to be imported from the selected files:		If you want to '''Import''' the the content from CSV-file, first you need to press "Import language as CSV" button. The program will offer you to select the file to import the content from. When you are done and confirmed it, the program will ask which languages need to be imported from the selected files:



	[[File:VoidExpanse_Localization_Tool_06.png\|400px]]		[[File:VoidExpanse_Localization_Tool_06.png\|400px]]








	Just check the boxes near the language codes you want and press "Next". The program will replace the existing core languages with the new content from the file. NOTE that you can import ONLY the languages which already have a .xml file created and have their column in the program. All other languages will be ignored.		Just check the boxes near the language codes you want and press "Next". The program will replace the existing core languages with the new content from the file. NOTE that you can import ONLY the languages which already have a .xml file created and have their column in the program. All other languages will be ignored.
Line 230:		Line 188:

	[[File:VoidExpanse_Localization_Tool_07.png\|400px]]		[[File:VoidExpanse_Localization_Tool_07.png\|400px]]









	Check the appropriate boxes and press "Next". To show the hidden languages again, you need to press "Hide/show languages" button again and just uncheck the boxes, then press "Next".		Check the appropriate boxes and press "Next". To show the hidden languages again, you need to press "Hide/show languages" button again and just uncheck the boxes, then press "Next".

	'''Reloading the core mod''' If you need to discard all the changes you made after running the Localization tool, there is button for it. Press it, confirm and all the changes will be reset.		'''Reloading the core mod''' If you need to discard all the changes you made after running the Localization tool, there is button for it. Press it, confirm and all the changes will be reset.