Not logged in - Login

Translating VocaDB

We need help with adding and fixing the translations on VocaDB.

See the GitHub page on this topic here.

Overview

Main parts of the VocaDB user interface are translatable. This guide is for you If you wish to help translating the interface into your language.

Available language options are:

  • Chinese (Simplified)
  • English
  • Finnish
  • German
  • Japanese
  • Korean
  • Portuguese
  • Russian
  • Spanish

There are currently two methods to help with the translations: Translating the text via "Crowdin" or directly through editing the resource files with GitHub. For the second method you need some technical expertise.

1. Translating through Crowdin

Crowdin is a localization management platform for companies and teams.

You can join VocaDB's translation project using this invite link. There, you can easily search for missing translations or fix existing ones.

2. Editing the resource files

VocaDB user interface is translated with .resx resource files. Most of the resources are under these folders: Web\App_GlobalResources, Web\Resources and Model\Resources (including subfolders).

Note that you only need to care about the files ending with ".resx" and no other dots in the name. For example "AlbumCollectionStatusNames.resx", you don't need "AlbumCollectionStatusNames.fi.resx" or "AlbumCollectionStatusNames.Designer.cs".

To edit these files you'll need a resource file editor such as ResX Resource Manager or Zeta resource editor.

Editing the files can be done in one of two possible ways.

Forking the repository on Github

(preferred)

  • Fork the repository on Github.
  • Clone the repository to your PC.
  • Copy the original resource file and name it with the culture-specific suffix.
    • For example, "AlbumCollectionStatusNames.resx" for German would be named "AlbumCollectionStatusNames.de.resx".
  • Commit your changes and send a pull request to the original repository.

Downloading the repository

(if you're not comfortable with version control)

  • Download the whole repository as a .zip file from Github.
  • Copy and rename the resource files as mentioned above, edit the copied files.