[CONF] Apache OpenOffice Community > AOO4 - Websites Translation

[co...@apache.org]

Space: Apache OpenOffice Community (https://cwiki.apache.org/confluence/display/OOOUSERS)
Page: AOO4 - Websites Translation (https://cwiki.apache.org/confluence/display/OOOUSERS/AOO4+-+Websites+Translation)

Added by Samer Mansour:
---------------------------------------------------------------------
h2. Idea

Integrate Pootle translation service into the website.  Only on static pages on oo.org and oo.a.org, not for cwiki or mwiki etc.


*Benefits:*

Translations for announcements and the website can be done efficiently.

Translation can be done by anonymous visitors (uncommitted until reviewed).


I  looked at the documentation, but I need someone with experience with pootle to get help on possible ways to integrating it into our site.

h2. Build Solution

Based on idea of builds, pages are pre-generated.

*Template File*


A template file for each page that contains all the HTML/javascript/css it would normally but strings are replaces with pootle keys. ie. "HomePageTitle", "News.Apache4Annoucement"


The template file would be checked into the CMS.  This would barely change.

*Generating Translated Files*

Batch Mode - Script would iterate over each page for each language for a build and check it into the CMS.


Individual File - A user would initiate a build for a particular language and page.


*URL / File Structure*
openoffice.org/index.html
openoffice.org/index.html?force=it
openoffice.org/en/index.html
openoffice.org/fr/index.html
openoffice.org/de/index.html
openoffice.org/it/index.html

*Allow Override*

Variable "force" will send user to their choice of language. Drop down in the header on the homepage.  IE.  Someone  in Spain chooses view in Italian, or Canada chooses Romanian.

Incomplete code example of handling from base page, no locale in URL.


{code}
//User hits base page: ie. openoffice.org/index.html

var url = window.location.pathname;
var locale = "en";var force = window.location.search.replace( "?force=", "" );

if (force.length>0) { // Forced
  document.cookie = "usr.locale=" + force + ";";
  locale = force;
} else { //No language selected, detect it.
  locale = getCookie("usr.locale");
  if ( locale == null ) { // Not in Cookie
    if ( window.navigator.language ) { // Basically Every Browser
      locale = window.navigator.language;
    } else if ( navigator.browserLanguage ) { // Internet Explorer...
      locale = navigator.browserLanguage;
    }  }
  document.cookie = "usr.locale=" + locale + ";";}

if (translationExists(file, locale)) { //Simple file check
  redirect(file, locale);  // openoffice.org/<locale>/index.html
} else {
  redirect(file, "en"); // openoffice.org/en/index.html}
{code}
*Allow visitors to contribute to translation*

Surround pootle strings with a javascript onhover function (3 seconds wait, or double click) "Translation Poor? Click to translate\!" \-> Forwards visitor to Pootle instance in anonymous mode, visitor can then suggest a better translation.&nbsp; The suggestion is then reviewed and pushed through.


*Pootle Structure*


Thinking pages would be individual po files?
https://translate.apache.org/ca/OOoWebsite/index.po
https://translate.apache.org/ca/OOoWebsite/download.po
https://translate.apache.org/ca/OOoWebsite/why.po

Change your notification preferences: https://cwiki.apache.org/confluence/users/viewnotifications.action