Translations about paper

[SFSandra]

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.

[paula-berman]

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.

[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

[santisiri]

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]

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

[SFSandra]

hi @marcoht will this work

[medied]

cc'ing @paulamlb

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

[SFSandra]

Paula that is a good plan!

[medied]

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

[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

[santisiri]

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

[bhack]

How the translation are maintained in sync?

[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

[medied]

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.

[nelruk]

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.

[bhack]

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?

[medied]

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

[bhack]

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.

[domi41]

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]

Also see #211

[marcoht]

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]

It worked! Thanks!

[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.

[SFSandra]

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 .

[marcoht]

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.