Edgewall Software

Changes between Version 18 and Version 19 of BabelFaq

Feb 3, 2014 12:47:23 AM (3 years ago)

Revert to @17


  • BabelFaq

    v18 v19  
     1= Frequently Asked Questions =
     3Here you can find answers to frequently asked questions about Babel.
     5[[PageOutline(2-4, Overview, inline)]]
     7== General ==
     9=== What is Babel? ===
     11Babel is a collection of Python utilities that assist in internationalizing and localizing Python applications, with an emphasis on web-based applications.
     13[[Image(http://www.edgewall.org/gfx/opensource-75x65.png, width=75, height=65, align=right)]]
     14=== What license governs the use of Babel? ===
     16Babel is released under the [wiki:License revised BSD license], which is a liberal open source license that has been [http://opensource.org/licenses/bsd-license.php approved] by the [http://opensource.org/ Open Source Initiative (OSI)].
     18=== What alternatives exist for Python projects? ===
     20Basically, two:
     22 * [http://cheeseshop.python.org/pypi/zope.i18n zope.i18n] has a scope similar to Babel (covering both `gettext` and the CLDR), but is closely tied to Zope 3.
     23 * [http://pyicu.osafoundation.org/ PyICU] is a Python/SWIG wrapper for the [http://www.icu-project.org/ International Components for Unicode] library. ICU provides access to locale data based on the CLDR (or the other way around).
     25Even though these alternatives exist, they are not often encountered in the Python web-app space outside of the Zope and OSAF communities. They both come with additional dependencies.
     27In addition, [http://turbogears.org/ TurboGears] includes an [http://docs.turbogears.org/1.0/Internationalization turbogears.i18n] package that provides a rather small fraction of what Babel provides for locale data. The [http://cheeseshop.python.org/pypi/wsgi18n/ wsgi18n] project basically takes the `turbogears.i18n` package and provides it as a library separate from the !TurboGears framework. Also somewhat related are the [http://translate.sourceforge.net/ Translate Toolkit] and [http://plone.org/products/i18ndude i18ndude] projects.
     29Anyway, Babel was developed because we saw the need for a comprehensive, framework-independent library that doesn't have dependencies on additional native code.
     31== Installation & Usage ==
     33=== What do I need to use Babel? ===
     35 * Babel 0.9.x requires //Python 2.3// or later (Babel 0.9.5 requires Python 2.4+ by accident, Python 2.3 support was fixed in Babel 0.9.6)
     36 * Babel trunk (1.0.x): //Python 2.4// or later
     37 * [http://peak.telecommunity.com/DevCenter/setuptools Setuptools] is optional and only used for installation if it's available.
     38 * Python 2.4 users need [http://pypi.python.org/pypi/elementtree/ elementtree] to run the {{{import_cldr.py}}} script (see [[SubversionCheckout]]).
     40For solid date formatting and time-zone support, you'll also need [http://pytz.sourceforge.net/ pytz]. However pytz is completely optional (unless you want to run the unit tests)
     42To build the docs, you need docutils, genshi, pygments and epydoc. Our source distributions (tar.gz/zip) already contain generated docs.
     44=== What plugins are available for Babel? ===
     46See BabelPlugins.
     48== Development ==
     50=== How can I install or run Babel directly from a checkout? ===
     52Some extra steps are needed for this. They are documented on SubversionCheckout.
    3 Incarrect Localization?
     55== Localization ==
    5  I don't  use Babel
     57=== How can I use Babel for RTL (Right to left) Languages, like Persian? ===