Skip to content

Public effort to improve Start11 language localizations for the product.

License

Notifications You must be signed in to change notification settings

jeffbargmann/Stardock-Software-Localization

 
 

Repository files navigation

enter image description here

Stardock-Software-Localization

Mission

A public effort to improve language localizations for the Stardock software product catalog.

Supported Languages

Stardock Software officially supports and maintains the following languages:

  • German
  • Spanish
  • French
  • Korean
  • Russian
  • Portuguese - Brazil
  • Chinese (Simplified)
  • Chinese (Traditional)

We will accept any other user-created languages, and include them in the products, but we will not officially maintain them. Any updates for the non-supported languages will have to come from the community via this project.

Editing and Submitting Languages

GitHub is the primary tool that Stardock uses to maintain our translations as it allows for streamlined contribution with a platform that is popular with many in our community. If you are familiar with this platform, you can skip to the Language File Format and Testing section to see how the language files are structured for each product, otherwise, onboarding directions are below.

The following directions are more for the laymen who want to contribute but do not want the complication of installing related software.

Creating a GitHub account

The one thing you will need is a free GitHub account.

Editing a current language file

In this example, we will:

  • Initiate editing an existing DeskScapes language file
  • Creating a fork \ branch to edit it under your credentials
  • Creating a 'pull request' to have it reviewed and included in the main repository

Click on the DeskScapes\DeskScapes 11 folder enter image description here

Click the pencil enter image description here

You will be notified that to edit the file, it needs to be 'forked' to continue. Forking any file is just an act to create a copy under your own account. enter image description here

You can now freely edit the file under your own forked copy. Once done, click the green 'commit changes' button enter image description here

Adding a new language file

The en (English) file can be used as a template for all new language files. Open it, copy all the text, and use the 'Add file' option to create a new file in your fork, pasting in the English text for editing. Add file

Commiting a new or edited language file

In the commit popup, add some details about what you added or changed and why (poorly phrased, inaccurate word choices, etc.). Click 'propose changes' once done: enter image description here

After you have edited one or more files, create a 'Pull request' (you are asking us to 'pull' your changes from your fork with this act) enter image description here

As you did for the individual files, you can write more details about any changes you made enter image description here

When complete, we are automatically notified. Once reviewed, we will communicate with you (via GitHub and its email notification system) if we have any questions and either accept or deny the pull. If accepted, you will be credited in the changelog for any application release.

Language File Format and Testing

App group A

  • Start11
  • Groupy
  • DeskScapes
  • Multiplicity

Group A File format

The en.lng file is the base for which all other language files are generated.

The only section that should be edited is under the [Strings] block and leaving the 'Exists=1' to start it.

[Strings] Exist = 1

English (en) file example:

"Which theme do you want to use?"="Which theme do you want to use?"

Spanish (es) file example:

"Which theme do you want to use?"="¿Qué tema quieres usar?"

The ; (semi-colon) is used for comments in the file and anything following it will not be read by the app.

Testing Language Files

After you have edited a language file, you should download it from your fork and put it in the app folder so it can seen to fit in the UI.

For example, this would be a translation that would be rejected as the translated text exceeds the UI's space for it. enter image description here

Language files for Group A products are stored in: C:\Program Files (x86)\Stardock[appName]\lang

For example, Groupy's language files are located in: C:\Program Files (x86)\Stardock\Groupy2\lang

App group B

  • Fences

Coming soon

About

Public effort to improve Start11 language localizations for the product.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published