r0nk / simplecpu

A website to explain how computers actually work.
MIT License
270 stars 35 forks source link

Spanish version #17

Open sirikon opened 9 years ago

sirikon commented 9 years ago

I could translate this to spanish, this is a so useful resource that would help some spanish students a lot when they start to learn the basics of computer science.

r0nk commented 9 years ago

This sounds like a great idea, however my only concern is something like this http://kotaku.com/5880007/racial-epithet-shows-up-on-minecraft-menu-developer-apologizes?tag=minecraft Happening, not accusing you of anything, as you already seem to have a pretty good standing on github, but as support for other languages might be added, a good system to address things like that might be good to discuss now.

sirikon commented 9 years ago

I understand, and I can assure you, as native spanish, that I'll take care that everything sounds right and is politically correct.

A way to do this, as this project uses HTML directly without PHP/Ruby/Python/Node or something in the backend, is create a folder for every translation (Main: simplecpu.com, spanish: simplecpu.com/es, etc...), those folders would be clones of the english version but with resources in his respective language, and after, release only the translations that we are sure that are correct and safe, labeled with stable or something like that.

The translations versions labeled as "safe", can be in a url like simplecpu.com/beta/... with "unstable" releases, with a link to the Issues section in this repository to report wrong translations.

r0nk commented 9 years ago

Ok, this sounds like a good system. Just out of curiosity, as you probably know a bit more about this then I do, is there a standard way for people to look for Spanish versions of websites? I'm thinking about how Spanish speaking people will find the Spanish version of the site.

sirikon commented 9 years ago

There are a few methods:

Automatically in the backend: When the server receives a request, there are some ways to get the user's default language. Automatically in the frontend: (bad method, kills the SEO) Get the user's language and then redirect to the right place (JavaScript). Manually in the frontend: A combobox/list/whatever of languages/flags at the page's header to select a specific language.

I think the best way is combine the third method (manually in the frontend) with this:

<html lang="es" dir="ltr">

In each page, specify the "lang" attribute with the language code, this will help Google to give to the user the page with the right language (anyway Google can get it using the Google Translator's algorythm to recognize languages)

WANG-lp commented 9 years ago

This is a cool project. I can translate this to Chinese.

r0nk commented 9 years ago

The 'es' directory with all the relevant files has been added, feel free to fork it and translate.

nikolavp commented 9 years ago

If there are po files I might be able to translate this to Bulgarian(will be cool)

mgarciaisaia commented 9 years ago

I've been translating LearnGitBranching, and Peter found a way to auto-translate the site. Surely you can get inspired by that.

I'll try to translate this project to Spanish soon :)

sirikon commented 9 years ago

That's awesome, thanks @mgarciaisaia

mgarciaisaia commented 9 years ago

Maybe tonight I finish it :)

@r0nk, do you know how you'll deploy this? I'm currently testing this by symlinking scripts/, scripts/ and styles/ to the parent's directories. And it would be difficult to maintain as the original version gets updated.

r0nk commented 9 years ago

What I'm going to do next with the translation I haven't figured out yet. Ways to deploy is is something I'm going to research soon (currently I'm recovering from my first attempts to tinker with the linux kernel, so I have to re-setup everything.) The patch and general interest is awesome though, so as soon as everythings not on fire I should be able to craft a good system for this.

mgarciaisaia commented 9 years ago

Hey, great.

Not for this weekend, but I'll see if I am able to understand how LGB works and apply it here.

I'll probably never do that, really - my attention span sucks - but I'd probably publish the Spanish version on GitHub:Pages with a link to the English version, and maybe make a PR with a link to the Spanish version.

If any time in the future I get inspired and do anything better, I'll let you know, but at least doing that I can give this to the Operating Systems students at my university.

What I'm going to do next with the translation I haven't figured out yet. Ways to deploy is is something I'm going to research soon (currently I'm recovering from my first attempts to tinker with the linux kernel http://imgur.com/rFJfi, so I have to re-setup everything.) The patch and general interest is awesome though, so as soon as everythings not on fire I should be able to craft a good system for this.

— Reply to this email directly or view it on GitHub https://github.com/r0nk/simplecpu/issues/17#issuecomment-62230562.