How to Help Translate Dataverse Into Your Language

[pdurbin]

Heads up that in IQSS/dataverse#5843 I took @JayanthyChengan steps and rewrote them a bit and added a section at the bottom called "How to Help Translate Dataverse Into Your Language". As of this writing it looks like this:

As you can see, I'm linking people who want to help to this repo so we should improve the README to explain how.

Any volunteers? 😄 We should try to get all the translations from https://github.com/IQSS/dataverse-docker/tree/master/dataversedock/dataverse-property-files at least:

It looks like @4tikhonov collected them and committed them. That's fine. The person doing the translation doesn't necessarily need to be a superstar with git, right?

Let's also not forget the Polish translation from @madryk and @MrK191 at CeON/dataverse#29 that I'm (currently) tracking at IQSS/dataverse-docker#15

There's also the Chinese translation at IQSS/dataverse#4798 that was added by @pengchengluo

There are others I'd like to reach out to as well, once the README is place. I'll have to check with @umuchlish if he knows if Slamet or Sjaeful are on GitHub.

[4tikhonov]

Hi @pdurbin, there is a reason behind why we're not moving all translations to the central repository: it's not going to work with the latest version of Dataverse, a lot of new properties were added from the December and users will see all those gaps with "???" signs. At the moment we're not able to keep all translations up-to-date as we've lost support from CESSDA community that did translation...

[4tikhonov]

I have created pull request with note about supported version of Dataverse but we have to find a sustainable solution to keep all translations synchronized with latest version.

[pdurbin]

@4tikhonov pull request #11 that you made looks good to me! Thank you! I don't have the power to merge but I think it'll be great to get those translations in there, even if they're a little behind.

[JayanthyChengan]

@4tikhonov - Thanks for your PR. Could you please replace "-" into "_" to have consistent in the folder names?
Also, if the property value is missing in any of the language file, the interface will display the corresponding English value and not "???" . Please create an issue , if you notice it.

[4tikhonov]

No, problem, I renamed and created new pull request.

[amberleahey]

You should now have permission to merge the pull request, let us know if you want to give permission to any of the translators. At some point we might want to consider who would be the reviewer for each language...? For French Canada, the main translator @mhvezina is the reviewer. If any changes are needed on French Canada, she would be reviewing.

[david-lareau-nrc]

Hopefully this is on topic. I've tried the last curl instructions:

curl http://localhost:8080/api/admin/datasetfield/loadpropertyfiles -X POST --upload-file languages.zip -H "Content-Type: application/zip"

I get

{"status":"ERROR","code":405,"message":"'/api/v1/admin/datasetfield/loadpropertyfiles' endpoint does not support method 'POST'. Consult our API guide at http://guides.dataverse.org."}

I'm a bit stumped with this. It's also unclear how Dataverse will understand that the zip file is for languages and should go with dataverse.lang.directory. Prior I've done:
./asadmin create-jvm-options '-Ddataverse.lang.directory=/var/www/dataverse/lang'

I'm running dataverse v. 4.14 build 1326-57a392d.

[david-lareau-nrc]

I found that if I simply copy the .properties file in my -Ddataverse.lang.directory then I get 'some' french text when I select french.

[JayanthyChengan]

Hi @david-lareau-nrc

The curl command should work in the develop branch, still not released.

[pdurbin]

@david-lareau-nrc hi! Obviously we are still working out the kinks in the process! Thanks for trying it out. I believe there are a few things going on:

• As @JayanthyChengan said, that new API isn't in a released version of Dataverse. I can point you at a war file if you're interested in playing around with a pre-release version. 😄
• I just took a quick look at the dataverse-v4.14 branch in this repo and I'm not sure if the French translation is ready yet so might want to try Dataverse 4.13 instead.
• The reason you're only seeing "some" French is that there are perhaps have a dozen properties files you have to copy over. All the strings aren't in a single file.
• This issue is mostly oriented toward improving the README to help people translate Dataverse. If you're able to help with that, great! While we're editing the README, we should probably provide more guidance on opening issues. Can you please go ahead and open a fresh one? Thanks! 😄

[david-lareau-nrc]

Thanks for your reply. I did copy all the property files (but I forgot to pluralise the word in my previous comment). Like you said, the French translation is not ready for 4.14, but at least I'm on the right track. I think I'll sit down and wait a bit for things to settle. I'm happy to be a tester ^_^

[mhvezina]

@david-lareau-nrc
French translation for version 4.14 was done more than a week ago and is available here:
https://github.com/GlobalDataverseCommunityConsortium/dataverse-language-packs/tree/dataverse-v4.14/fr_CA

[pdurbin]

@david-lareau-nrc it looks like you have something to test now! Thanks, @mhvezina !! 🎉 🎉

[david-lareau-nrc]

I've already been using the 4.14 branch so far since that's the version of Dataverse we are using. The only multi-lingual Dataverse I found so far is the Scholars Portal Dataverse, which seems to be running 4.10. If they bump up to 4.14 and have french all good then I'll question my configuration.

[pdurbin]

There are others I'd like to reach out to as well, once the README is place. I'll have to check with @umuchlish if he knows if Slamet or Sjaeful are on GitHub.

Even without the README in place I reached out to @sjaefulafandi and he created pull request #32, adding a translation of Dataverse in Indonesian.

That said, I think we need two things:

• CONTRIBUTING.md: An explanation of how to contribute to this repo (and can the new http://weblate.dataverse.org make this easier?)
• A link from README.md to CONTRIBUTING.md 😄