Multi-language ability is one of the top requests from (mostly) international Kwik users. As the development goes on for version 1.8, I would like to provide this tutorial, enabling the interested ones to get ready for this new useful resource (design once, have it in multiple languages with a few clicks). Remember this is not a final version yet so, minor changes may appear before the beta-testing and final version launch.
At the end of this tutorial, you will be able to have a project like this:
Analyzing the project
First I created a regular Book project and designed page1 like this:
Checking the LAYERS panel you see:
- kwkcover is the background used in all pages (originally it was name cover, and then I applied the Tools->Shared Assetcommand to allow it being saved only once but used in several pages)
- kwkwitch is the little witch (I applied the same Tools->Shared Assettechnique here, as I will use her again in the next page)
- butRead is the English button (reads “Read to Me”), and will be used to set the language of the project;
- butLeia is the same button but now for the Spanish selection (reads “Lea para Mi”);
- Candice is the title of the storybook;
For page2, I created:
Checking the LAYERS panel you see:
- kwkcoversame background as first page;
- kwkwitchsame witch from the first page (wearing black);
- witchSpathe same witch (wearing white);
- butBuy a light blue button that will appear only in the English page;
- butCompre a light orange button that will appear only in the Spanish page;
- father is the English text line (reads “My father is nice!”, to be used when the reading is in English;
- padre is the Spanish text line (reads “Mi padre es bueno!”, to be used when the reading is in Spanish;
I exported all images and pages clicking the Preview button (the button with a tablet image, left side of the project name). After that, I disabled the Export Images option (via Settings panel, or clicking the second button from the left in the status bar, right side of “Version 1.7.2”), as it takes the exporting process longer and I have already all the images I wanted exported.
Setting you multi-language project
The next thing I needed to do now was to inform Kwik this is going to be a multi-language project. The way to do that is going to the Project menu, selecting the new button Multi-language settings:
Clicking the new button, I got this window:
I then clicked the + (add) button, and entered the language name and its identification code:
I did the same for the Spanish language. You will need to do this for EVERY language you plan to cover in your project.
Creating the language buttons
Still in page1, I selected the butRead and attached a button to it (via Interaction->Add Button). It opened the following window:
I selected the new Set Language action, which opened the window:
I then picked the English as this is the English button, right?
After adding the Set Language action, I also entered a GoToPage, sending it to the next page after the click.
I did the same for the Spanish button. This pretty much sets the first page. This is the result of this first page:
In the next posting, I will show how to make the magic in page2. Meanwhile, send your comments here!
* You have seen the Multi-layer and Languages settings at the end of the button window. I will cover it later. For now, they are not going to be used.
UPDATE: Since version 1.8 the Set Language feature changes the language and refreshes the current page (never triggering the GO TO PAGE used in this demo). In order to change pages in this demo, you will need to swipe pages with your finger or create another button to do it.
The reason of this change was due several requests that usually users pick a language, it refreshes the interface allowing them to understand the options in their own language, then then click a Read to Me or I Read button.