Translations

v1.11 changed how translations are handled. For the older instructions, look here.

If you'd like to collaborate, then you can translate the tool to another language by following these instructions.

Table of Contents

Click to expand

• Creating new translations
• Updating existing translations
• Side notes
  • About XML
  • Some notes about the tool

Creating new translations

• Look up the ISO code for your language (e.g. "en-US" is English, USA): http://www.lingoes.net/en/translator/langcode.htm

• Open the languages folder which is located in C:\Users\<your name>\AppData\Local\Fallout 76 Quick Configuration\

  • (Tip: You can open it via "🗀 Browse")
    

• Create a folder and name it after your language's ISO code. (e.g. de-DE)

• Copy en-US.xml into the new folder and rename it to your language's ISO code. (e.g. de-DE.xml)

• Copy the *.html and *.rtf files into the new folder. You don't need to rename them.
  This should yield you something like this:

  🗀 languages\
  │
  ├── 🗀 en-US\
  │   ├── en-US.xml
  │   └── (original html and rtf files...)
  │
  ├── 🗀 de-DE\
  │   └── de-DE.xml
  │   └── (to be translated html and rtf files...)
  │
  └── ...
  

• Open the newly created xml file and change the following:

  <Language name="English (USA)" iso="en-US">

  to something like this:

  <Language name="Deutsch (Deutschland)" iso="de-DE" author="datasnake">

  (If you add author="your name goes here" then your name will be shown when the language is selected)

• Start translating. :)

  • RTF files can be opened in WordPad, Word (paid), or LibreOffice (free).
  • XML and HTML files can be opened in any text editor. (I recommend Visual Studio Code or Notepad++)

• When you're done, you can send me a PM and attach the files. I'll add your translation to the GitHub repo, so people can easily download it through the tool. Please use dropbox, Google Drive or any other file sharing service.

Updating existing translations

• Open the tool, select "English (USA)" first, and then select the language you want to update.
  Example:
  
  This will create a template (e.g. de-DE\de-DE.template.xml). It will also copy any new html or rtf files to the language folder.
• Delete the old file and rename the template file from e.g. de-DE.template.xml to de-DE.xml.
• Start translating the added texts.
  • RTF files can be opened in WordPad, Word (paid), or LibreOffice (free).
  • XML and HTML files can be opened in any text editor. (I recommend Visual Studio Code or Notepad++)
• When you're done, you can send me a PM and attach the files. I'll add your translation to the GitHub repo as usual.

Side notes

Please, make sure that you don't change any of the IDs (e.g. id="buttonApply").
Otherwise the tool won't recognize it.
Because of this, be especially careful with bulk replacing texts in a text editor. Don't do this:

Also, when it's iso="en-US" then the file has to be named en-US.xml.

To add a newline in a text="<your text goes here>", you need to write \n or 
.
For example, text="This is line 1\nThis is line 2"
will produce:

This is line 1
This is line 2

About XML

If you want to know more about XML, you can look up a full tutorial:

• Syntax
• Elements
• Attributes

But I don't think it is necessary to know all of this if you just want to translate it.

Some notes about the tool

You don't need to restart the tool everytime you want to see the changes you made.
Just click on the refresh button in the App Settings:

This will also load any newly added translations to the dropdown list.