|
|
# How can I find Yakforms in my language ?
|
|
|
|
|
|
[Framaforms.org](https://framaforms.org/), the first instance of Yakforms, is only in French.
|
|
|
|
|
|
Yakforms doesn't support multiple languages for now : that means that an instance will only be in an single language.
|
|
|
Here are the languages currently available :
|
|
|
|
|
|
[](https://weblate.framasoft.org/engage/yakforms/?utm_source=widget)
|
|
|
|
|
|
If you're looking for Yakforms in your language, you should consider [installing your own instance](https://framagit.org/framasoft/framaforms/-/wikis/Installing-Yakforms-through-the-installation-profile) !
|
|
|
|
|
|
Once you've done that, and you want to shift your instance from English to another language, you should refer to [this page](https://framagit.org/framasoft/framaforms/-/wikis/Changing-an-instance-language).
|
|
|
|
|
|
# How does Drupal translation work ? :gear:
|
|
|
|
|
|
Quite simply : **like every other software**, meaning with `.po` files. These are basically files that contain every pieces of text that can appear to the user somewhere on the website, which are written **exclusively in English**, and their equivalent in another language. Drupal works with **modules**, and each module comes with some `.po` files (assuming its community is large enough for these files to have been produced at some point).
|
|
|
|
|
|
For example, `mymodule.fr.po` is a translation file for a module called **mymodule**, written in English, that contains every piece of text translated to French.
|
|
|
|
|
|
So quite simply to answer the title question : Drupal comes with a translation mechanism. If you manage to put you hands on the right `.po` file (most can be automatically imported), you'll have a fully working website in your chosen language.
|
|
|
|
|
|
# How can I help translate the software ?
|
|
|
|
|
|
The easiest way to help is by using [Weblate](https://weblate.framasoft.org/engage/yakforms), an online platform aimed to make software translation easier for communities.
|
|
|
|
|
|
Note that the only translation we need to do for now is that of the **custom modules**, that is, the ones developped specifically for Yakforms. They are pretty simple to spot : they all in the begin with the word `yakforms`
|
|
|
|
|
|
There are also **templates** that have to be translated out of Weblate. These are little pieces of HTML codes that are used to build general-utility pages (the site's frontpage, but also the page the user lands on when trying to access an expired form, etc). To help translate these, you'll have to contribute through Git : there's no other way.
|
|
|
1. clone the repo
|
|
|
2. browse to this repo, then `sites/all/modules/yakforms/includes/html`.
|
|
|
3. in this subfolder, access the folder corresponding to your [language code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). If the one you want doesn't exist, create it.
|
|
|
4. in this subfolder, place your translated templates, with the same names as the English ones exactly.
|
|
|
5. submit your work through [an MR on the Git repo](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html).
|
|
|
|
|
|
## Using Weblate
|
|
|
|
|
|
Our Weblate platform can be found [here](https://weblate.framasoft.org/engage/yakforms/). You'll have to register, and you should be all set to start translating the user interface !
|
|
|
|
|
|
**Can't find the language you were looking for ?** If you are willing to spend some of your time to translate the software in a language that is not yet set up, please open a topic on [our forum](https://framacolibri.org/) to discuss !
|
|
|
|
|
|
[](**https://weblate.framasoft.org/engage/yakforms**/?utm_source=widget)
|
|
|
|
|
|
## Something in the code looks weird to you ?
|
|
|
|
|
|
Some text doesn't appear to be translatable ?
|
|
|
|
|
|
You found a typo in the original text, or some text looks confusing to you ?
|
|
|
|
|
|
User content appears to be translatable ?
|
|
|
|
|
|
Please [open an issue](https://docs.gitlab.com/ee/user/project/issues/) to share your thoughts !
|
|
|
|
|
|
# Need help ? :thinking:
|
|
|
If you'd like to contribute but the instructions above are confusing to you, suffer no more and [open a topic on our forum](https://framacolibri.org/). |