Re: Easy language switching for the documentation website - Mailing list pgsql-www
From | damien clochard |
---|---|
Subject | Re: Easy language switching for the documentation website |
Date | |
Msg-id | 4E17185D.301@dalibo.info Whole thread Raw |
In response to | Re: Easy language switching for the documentation website (Magnus Hagander <magnus@hagander.net>) |
List | pgsql-www |
Le 08/07/2011 16:01, Magnus Hagander a écrit : > On Thu, Jul 7, 2011 at 23:24, damien clochard <damien@dalibo.info> wrote: >> Hi guys, >> >> For now, the documentation has only two full and up-to-date translations >> : Japenese and French... so i guess what i'm gonna talk about will only >> concern french and japanese speaking people. >> >> From my personnal experience, I've talked with a lot of French-speaking >> PostgreSQL users about the documentation. Most of them read both the >> french and the english version, because when they have difficulties to >> understand a paragraph, it's a good thing to go to the translations and >> get a second chance to understand. It's also usefull when you're >> confused by weird translations. For exemple "deadlock" is sometimes >> translated as "verrous morts" which sounds really strange when you first >> read it :) >> >> Anyway, for the french documentation we ended putting a small javascript >> link on each page to jump directly to the english version. >> >> For now, it's only available on the 9.1 doc ( just click on the link >> named "Version Anglaise" on the left ) : >> >> http://docs.postgresql.fr/9.1/explicit-locking.html >> >> This works with a very simple js that goes like that : >> >> function jump_to_english() { >> var fr_url = location.href; >> var fr_pattern = "http://docs.postgresql(.fr|fr.org)/([7-9].[0-4])"; >> var en_pattern = "http://www.postgresql.org/docs/$2/static"; >> var reg=new RegExp(fr_pattern, ""); >> window.location = fr_url.replace(reg,en_pattern) ; >> } >> >> >> So far people seem to like, the only problem is that once you've jump >> from French to English, you might want to go backward as easily :) >> >> So here my question : could we add a javascript like the one above on >> each english documentation page ? Of course i would have to adapted to >> support also Japanese (and maybe german) >> >> If think this would be a big improvements for non-english users and >> probably it could motivate people to translate the doc in other >> languages. By making existing translations more visible, some people may >> ask themselves : "why not translating this page in my own language ?" >> >> I know javascript is not active on every browser and this code is a >> quick and dirty hack. But it's simple and it works fine so i really it's >> worth trying :-) >> >> Any comments on this is more than welcome ! > > > This thing relies upon the URLs being the same, right? Yes. For the french doc, we keep the original english filenames. I assume the japanese and germans do the same.... > So if we want > to do that, why do we need to fiddle with javascript - we could just > put links directly into the templates and have "real links" instead of > javascript, no? > Sure! I just don't know how to do that :) The javascript way was just easier for me :) If someone wants to implement a real link it's even better :) -- damien clochard dalibo.com | dalibo.org