paper icon indicating copy to clipboard operation
paper copied to clipboard

Translations

Open medied opened this issue 7 years ago • 25 comments

Was talking to my mom about DEF the other day and realized how different it felt to explain it in spanish 🤔 . It would be nice to have the whitepaper translated to different languages for people who are more comfortable in a language other than english. I bet it would help in spreading the word too.

So was thinking about starting the spanish translation but thought I would check in first. @santisiri what do you think? This is not urgent of course and we should probably get the english one ready first

medied avatar Jul 22 '17 00:07 medied

I think it's an amaing idea and would love to have this in spanish. We can wait until the first draft is completed. But if you want to begin already, I'm glad to help as well.

Not sure what's the best convention but we could add a README_ES.mediawiki file for the translation. Feel free to start this anytime.

santisiri avatar Jul 22 '17 16:07 santisiri

This is such a fantastic idea. We can have a version in Portugese too, I'm sure Agatha or Paula would be happy to do the translation.

SFSandra avatar Jul 22 '17 22:07 SFSandra

Portuguese would be sweet. We have a big community in Brazil.

santisiri avatar Jul 25 '17 17:07 santisiri

cc'ing @paulamlb

Anyone who wants to translate to a different language should feel free to work under the translations directory :)

medied avatar Jul 25 '17 17:07 medied

Amazing! Will most definitely translate to Portuguese. As there is still a lot to be worked on, I will do that next week. Also I don't know if everybody does that, but I often translate things and my trick is to google translate it all and then go over everything (carefully) afterwards. Saves A LOT of time and works well.

paula-berman avatar Jul 25 '17 23:07 paula-berman

Paula that is a good plan!

SFSandra avatar Jul 25 '17 23:07 SFSandra

@paulamlb yes! That's what I do too, does save a lot of time 🙂

medied avatar Jul 25 '17 23:07 medied

Just to have a minimum of organization and depending on how many people jump to translations, am thinking we can use Github projects to coordinate (like the the one below) and Slack channels (see #habla-español):

https://github.com/DemocracyEarth/paper/projects/1

@paulamlb what do you think? Is it worth to have one for Portuguese? Or Chinese or whatever language.

This is of course if there's a lot of people interested in translating, otherwise a more simple approach might work just fine

medied avatar Aug 22 '17 23:08 medied

Just flagging FYI I just realized projects don't really work well to coordinate in this case: Github requires you to be a member of DEF to add cards to the project, oh well

medied avatar Aug 24 '17 23:08 medied

@paulamlb @SFSandra official membership to our github repo invitation sent.

santisiri avatar Aug 25 '17 16:08 santisiri

How the translation are maintained in sync?

bhack avatar Sep 12 '17 21:09 bhack

I don't know if we will never touch the document but when it is online there is https://m.mediawiki.org/wiki/Extension:Translate

bhack avatar Sep 12 '17 21:09 bhack

You mean when the original english document gets updated? Right now translations have to be manually updated to stay in sync. So thanks for that extension! Might come in handy for any future automation.

medied avatar Sep 12 '17 21:09 medied

The first thing we need to finish is fully translated the document, make proper editions and then automation, which could be a medium-term objective.

nelruk avatar Sep 12 '17 22:09 nelruk

Yes but you need also to check every translation if you touch the english content. How do you notify the translations contributors on each PR that you merge on master over the english text? Cause I suppose that the Master document is in english right?

bhack avatar Sep 12 '17 22:09 bhack

Yea exactly this could be a source confusion (see #204 for reference). I guess as long as we are doing it manually, every time master is updated we need to cascade that to every translation. An automatic solution would be very nice eventually

medied avatar Sep 13 '17 03:09 medied

With the extension:

Each unit is automatically tracked for changes, and translators immediately see what needs updating on a specific page or throughout the wiki.

bhack avatar Sep 13 '17 08:09 bhack

There's a way to automate, using github :

For each new commit :
If commit does not concern root's README.mediawiki, stop here
Find line numbers that changed
Parse mediawiki file to cut it into chapters (regex FTW)
Find the chapters the edited lines correspond to
Find contributors to those chapters in the other languages (blame)
Create an issue, with proper tags, description and assignees
Maybe even create an associated card in a project (github API is still experimental here)

If the chapter structure changes, it should be easy enough to compare with the translations' chapter structure and yell accordingly in a special case.

This can be hacked rather quickly with few lines of whatever language you can make a web service out of. But we'd need a server to host the bot, so that github can send its events to it.

domi41 avatar Sep 13 '17 16:09 domi41

Also see #211

domi41 avatar Sep 14 '17 20:09 domi41

Hello everyone. I'm starting to review the portuguese translation and realized that there are a lot figures to be translated. Do the editable files available? If don't, I'll try to write the translations over (means to add portuguese text boxes over the english text). Is that ok??

marcoht avatar Oct 04 '17 12:10 marcoht

hi @marcoht will this work

SFSandra avatar Oct 04 '17 18:10 SFSandra

It worked! Thanks!

marcoht avatar Oct 04 '17 20:10 marcoht

@SFSandra and @paulamlb I have finished most images' translation. How can I upload the files? Can I upload directly in the same directory where you've uploaded the english ones? Also, I've created ".xcf" (GIMP) editable files, which can be used to any translation easily. The schematic images of "dripping", PoI and smart contracts are still missing translation to portuguese. I'm working on them right now.

PS.: Just a remind: since the images were in ".png" format, I had to do some "artwork" to match colors, fonts and sizes. If any image is not ok, let me know.

marcoht avatar Oct 15 '17 19:10 marcoht

Hi @marcoht wow that is great news, you work fast! honestly I am not sure if you can upload to the repository - I think that you need to be invited to have that level of permission. I will check on that - otherwise, if you have a dropbox file you can share that way ([email protected]), and I will upload to the repo .

SFSandra avatar Oct 16 '17 03:10 SFSandra

Hi @SFSandra ! Thanks... I've uploaded some other files today there in the Dropbox folder. Now it is missing just one last. @paulamlb only one file missing now.

marcoht avatar Oct 22 '17 23:10 marcoht