Opened 5 weeks ago

Last modified 3 days ago

#31384 needs_information enhancement

localize snowflake website

Reported by: emmapeel Owned by:
Priority: Medium Milestone:
Component: Circumvention/Snowflake Version:
Severity: Normal Keywords: l10n, anti-censorship-roadmap-september
Cc: emmapeel, dcf, arlolra, cohosh, phw Actual Points:
Parent ID: Points:
Reviewer: Sponsor: Sponsor28

Description

https://snowflake.torproject.org/ should appear at least on our priority 12 languages.

Child Tickets

Change History (8)

comment:1 Changed 5 weeks ago by emmapeel

The file at https://gitweb.torproject.org/pluggable-transports/snowflake.git/tree/proxy/static/index.html (thanks cohosh) is easily translatable, but i am not sure how users will change from one language to the other.

i could provide a folder with different translations of the index.html page to be loaded as a git submodule, if you want, i.e.:

translations/

index+fr.html
index+de.html
etc

Then, we just need to add a little menu with the translated languages on top.

what do you think?

comment:2 Changed 4 weeks ago by emmapeel

Status: newneeds_review

the translations of the web interface are available at

https://gitweb.torproject.org/translation.git/log/?h=snowflake-website-indexhtml

i.e. repo https://git.torproject.org/translation.git

branch snowflake-website-indexhtml

Please let me know if you can use them to provide a localized version of the webpage.

comment:3 Changed 4 weeks ago by gaba

Keywords: anti-censorship-roadmap-october added
Sponsor: Sponsor28

comment:4 Changed 4 weeks ago by gaba

Keywords: anti-censorship-roadmap-september added; anti-censorship-roadmap-october removed

comment:5 in reply to:  2 ; Changed 3 weeks ago by dcf

Keywords: snowflake-webextension removed
Status: needs_reviewneeds_information

Replying to emmapeel:

Please let me know if you can use them to provide a localized version of the webpage.

I have some process-related questions.

How do we know which language to use? In comment:2 you mentioned adding a menu to the page. I see such a menu at https://tb-manual.torproject.org/, defaulting(?) to English. Should we also look at the Accept-Language HTTP header (i.e., the user's in-browser configured language)? Do other Tor Project pages do that?

What is the process for handling revisions to the source text? Will the translation.git repository periodically get a revised index.html, then make changes in that repository? Then we import those changes back into snowflake.git? Is there some way to notify each group about when updates are ready from the other side?

comment:6 in reply to:  5 Changed 3 weeks ago by cohosh

Replying to dcf:

Replying to emmapeel:

Please let me know if you can use them to provide a localized version of the webpage.

I have some process-related questions.

How do we know which language to use? In comment:2 you mentioned adding a menu to the page. I see such a menu at https://tb-manual.torproject.org/, defaulting(?) to English. Should we also look at the Accept-Language HTTP header (i.e., the user's in-browser configured language)? Do other Tor Project pages do that?

Looks like arlo's most recently changes in #30310 use the navigator.language property to set the translation and default to English if none exist. See https://github.com/keroserene/snowflake/commit/da21c6710cd871d931f2eea2a185b78b1907d3db#diff-c371ea9d4448f98b3fda1dfca95c925eR93

comment:7 Changed 3 weeks ago by arlolra

Parent ID: #30310

comment:8 in reply to:  5 Changed 3 days ago by emmapeel

Replying to dcf:

I have some process-related questions.

How do we know which language to use? In comment:2 you mentioned adding a menu to the page. I see such a menu at https://tb-manual.torproject.org/, defaulting(?) to English. Should we also look at the Accept-Language HTTP header (i.e., the user's in-browser configured language)? Do other Tor Project pages do that?

The ideal will be to allow users to change it by hand, as our own browser allows to hide your language and many people browse the web in English because of fingerprinting, or sometimes are using public computers, etc, so it is unlikely that they will have the proper language configured.

What is the process for handling revisions to the source text? Will the translation.git repository periodically get a revised index.html, then make changes in that repository? Then we import those changes back into snowflake.git? Is there some way to notify each group about when updates are ready from the other side?

I can hook the translation system to the repository at https://gitweb.torproject.org/pluggable-transports/snowflake.git/plain/proxy/static/index.html, so the changes on the file will be reflected some hours later on the translation platform (i have done that already with messages.json). transifex will pull the source files twice a day I think.

It would be great if somebody from the team can join transifex, as sometimes there are comments translators do on the source strings that would be nice if you review.

From inside of transifex you could see if the file is translated and reviewed, the comments, etc.

I can help you decide on the languages that are ready when you approach release.

We could also make a call for translations to speed up the process, currently many languages are translated but not reviewed.

Also, if you have friends that want to review a specific language before publishing, send them to me, as we need trusted reviewers for many languages.

Note: See TracTickets for help on using tickets.