Differences between revisions 16 and 31 (spanning 15 versions)
Revision 16 as of 2010-07-04 09:13:41
Size: 1826
Editor: robert.marik
Comment:
Revision 31 as of 2014-12-04 04:39:05
Size: 3818
Editor: kcrisman
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Localization of Sage = = Internationalization of Sage Notebook =
Line 3: Line 3:
== Languages Requested == Internationalization is the adaptation of products for potential use virtually everywhere, while localization is the addition of special features for use in a specific locale. For those new to the topic, "i18n" is a short-hand for "Internationalization" referring to the 18 letters between the I and and N. Similarly, "l10n" is shorthand for "localization". For more information, see the section "Useful Links".
Line 5: Line 5:
There have been repeated requests to localize Sage into different languages. Below is aa alphapbetical list of the requested languages: Note that this is only about the notebook. There are other efforts at translation of various documentation, such as on on this wiki for [[i18n/Italian|Italian]], and at least some of Sage's tutorial or "tour" is currently translated into various languages. Please email sage-devel or open Trac tickets!
Line 7: Line 7:
 * [[http://wiki.sagemath.org/i18n/Czech| Czech]]: Robert Mařík
 * [[http://wiki.sagemath.org/i18n/French| French]]: Alex Ghitza, Bertrand Meyer, Marc Mezzarobba
 * German: Michael Abshoff
 * [[http://wiki.sagemath.org/i18n/Italian| Italian]]: Cristian Consonni
 * Korean: DanDrake
 * Russian: Peter Ototsky
 * Spanish: Sean O'Quin, Oscar Lazo
== Project information ==

The initial pieces of the project are now complete. As of the end of 2014, we have the Sage notebook in [[https://github.com/sagemath/sagenb/tree/master/sagenb/translations|seven languages]].

 * Czech
 * German (Austrian)
 * English (US)
 * Spanish
 * French
 * Portuguese (Brazilian)
 * Russian

We would love to have more! Among other requests we have had are

 * Italian
 * Korean
 * Greek
 * Ukrainian

Also, maintaining translations is an ongoing job.
 * The notes at https://github.com/sagemath/sagenb/blob/master/README.rst about localization should still be true.
 * Please see https://github.com/sagemath/sagenb/pull/238 for a better way to keep things updated, which needs review.


== Old project description ==

This project would involve changing the Sage notebook so that the user interface language can be translated and changed on the fly. This project will require knowledge of Python, Mercurial, and basic web coding; knowing the GNU gettext utilities, Javascript, and the Jinja web templating system will be helpful. No knowledge of (human!) languages other than English is necessary.

=== Languages Requested ===

There have been repeated requests to localize Sage into different languages. Below is an alphabetical list of the requested languages:

 * [[i18n/Czech| Czech]]: Robert Mařík
 * [[i18n/French| French]]: Alex Ghitza, Bertrand Meyer, Marc Mezzarobba
 * [[i18n/German| German]]: Michael Abshoff
 * [[i18n/Italian| Italian]]: [[MarcoRofei|Marco Rofei]]
 * [[i18n/Korean| Korean]]: DanDrake
 * Portuguese (Brazilian): Luiz Aquino.
 * [[i18n/Russian| Russian]] : Peter Ototsky
 * [[i18n/Spanish| Spanish]]: Sean O'Quin, Oscar Lazo
 * [[i18n/Greek| Greek]]: Zafeirakis Zafeirakopoulos
Line 17: Line 51:
== Translations in Progress == === Localization in Progress ===
Line 20: Line 54:

[[http://trac.sagemath.org/sage_trac/ticket/9428 | Ticket #9428 - Internationalize the Sage Notebook]]
Line 24: Line 60:
 * Brazilian Portuguese (pt_BR): Luiz Aquino (100% ;) )
 * Czech (cs_CZ): Robert Mařík (~99% - the admin's Notebook server settings is for definiteness kept in English)
 * Greek (el_GR): Zafeirakis Zafeirakopoulos (~5%)
Line 25: Line 64:
== Useful Links == === Useful Links ===
Line 27: Line 66:
This page is about code localization. The translation of the documentation itself is an orthogonal issue that will be discussed elsewhere. The localization of code is commonly referred to as i18n. Below is a list of resources on the web to get started: This page is about code internationalization. The translation of the documentation itself is an orthogonal issue that will be discussed elsewhere. Below is a list of resources on the web to get started in this project:
Line 31: Line 70:
 * http://www.gnu.org/software/gettext/manual/gettext.html
 * http://jinja.pocoo.org/2/documentation/
Line 32: Line 73:
== Potential Problems == === Potential Problems ===
Line 36: Line 77:

Please add material as appropriate.

== Questions ==

  * Above, you write that this page is about "localization"...but the title is "i18n" and the second link above (the laptop.org one) explains that i18n and l10n are two different things. What exactly is this about? :) Also, what do you mean by "code localization"? (I've never been involved in this sort of stuff, so I don't know many of the terms. --DanDrake

Internationalization of Sage Notebook

Internationalization is the adaptation of products for potential use virtually everywhere, while localization is the addition of special features for use in a specific locale. For those new to the topic, "i18n" is a short-hand for "Internationalization" referring to the 18 letters between the I and and N. Similarly, "l10n" is shorthand for "localization". For more information, see the section "Useful Links".

Note that this is only about the notebook. There are other efforts at translation of various documentation, such as on on this wiki for Italian, and at least some of Sage's tutorial or "tour" is currently translated into various languages. Please email sage-devel or open Trac tickets!

Project information

The initial pieces of the project are now complete. As of the end of 2014, we have the Sage notebook in seven languages.

  • Czech
  • German (Austrian)
  • English (US)
  • Spanish
  • French
  • Portuguese (Brazilian)
  • Russian

We would love to have more! Among other requests we have had are

  • Italian
  • Korean
  • Greek
  • Ukrainian

Also, maintaining translations is an ongoing job.

Old project description

This project would involve changing the Sage notebook so that the user interface language can be translated and changed on the fly. This project will require knowledge of Python, Mercurial, and basic web coding; knowing the GNU gettext utilities, Javascript, and the Jinja web templating system will be helpful. No knowledge of (human!) languages other than English is necessary.

Languages Requested

There have been repeated requests to localize Sage into different languages. Below is an alphabetical list of the requested languages:

If your language is missing please add it. In addition if you are willing to help out translating please add your name to the language in question.

Localization in Progress

sage-notebook thread about i18n translations

Ticket #9428 - Internationalize the Sage Notebook

To avoid duplication:

  • German (de_DE/AT): Harald Schilly (~5%, please help ;) )

  • Brazilian Portuguese (pt_BR): Luiz Aquino (100% ;) )

  • Czech (cs_CZ): Robert Mařík (~99% - the admin's Notebook server settings is for definiteness kept in English)
  • Greek (el_GR): Zafeirakis Zafeirakopoulos (~5%)

This page is about code internationalization. The translation of the documentation itself is an orthogonal issue that will be discussed elsewhere. Below is a list of resources on the web to get started in this project:

Potential Problems

  • cython code
  • potential performance impact