This README.md file was created to guide contributors on how to contribute translations to the FreeGPT WebUI project. The translations are located in the translations folder and are generated by babel-flask.

To modify an existing translation, follow the steps below:

1. Inside the translations folder, you will find all existing translations in the project.

2. Translate the strings in the .po file found within the folder of the language translation you want to modify.
   
   The identifiers of the strings to be translated are in the format msgid "string" and should be translated in the msgstr "" field. For example:

msgid "New Conversation"
msgstr "Nova Conversa"

3. Add your name and GitHub profile to the "Contributors" section at the beginning of the .po file. If there are already contributors, add your name to the list. For example:

# Portuguese (Brazil) translations for FreeGPT WebUI.
# Copyright (C) 2023 FreeGPT WebUI.
# This file is distributed under the same license as the FreeGPT WebUI
# project.
# Contributors:
# Ramon - github.com/ramonvc/
# Your Name - github.com/yourprofile/
# ...

4. Create a pull request with the changes so we can review and incorporate them into the project.

To add a new language, follow the steps below:

1. Install babel-flask (if not already installed) using the command pip install Flask-Babel.

2. Inside the project folder use the following code to generate the folder with the translation template, replacing LANGUAGE_CODE with the language code. Example: en_US

pybabel init -i ./translations/messages.pot -d translations -l LANGUAGE_CODE

3. Translate the strings in the created .po file. The identifiers of the strings to be translated are in the format msgid "string" and should be translated in the msgstr "" field. For example:

msgid "New Conversation"
msgstr "Nova Conversa"

4. Add your name and GitHub profile to the "Contributors" section at the beginning of the .po file. For example:

# Portuguese (Brazil) translations for FreeGPT WebUI.
# Copyright (C) 2023 FreeGPT WebUI.
# This file is distributed under the same license as the FreeGPT WebUI
# project.
# Contributors:
# Ramon - github.com/ramonvc/
# ...

5. Create a pull request with the changes so we can review and incorporate them into the project.