Skip to content

Commit

Permalink
Adding L10n docs
Browse files Browse the repository at this point in the history
  • Loading branch information
ozten committed Jan 14, 2011
1 parent c70994c commit f173127
Show file tree
Hide file tree
Showing 3 changed files with 37 additions and 0 deletions.
1 change: 1 addition & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ Contents

gettingstarted
libs
l10n_setup


Indices and tables
Expand Down
34 changes: 34 additions & 0 deletions docs/l10n_setup.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
L10n Setup
==========

So you'd like to localize your webapp. **Congratulations!**

Playdoh comes with all of the libraries and tools you need
in the dev and production requirements.

Steps
-----

The following steps will get you started:

#. Create a SVN reposity based on MDN_ locale directory.
This will give you a README.txt, compile-mo.sh, and
show you the proper directory layout.
#. Compile the po files and mirror the SVN repository in a
git repository via a cron job that runs every 15 minutes.
Example: (TBD)
/home/fwenzel/bin/autol10n/autol10n.sh
#. Add your git repo as an external to this project
It should create a locale directory at the top level
#. Read locale/README.txt for a better understanding of
what Django management commands are used to extract and
merge strings into your po files. It has instructions
for adding more locales.

Q&A
---
Why SVN? Our localizers like to use either SVN or Verbatim.

Why a git repo to mirror an SVN repo? This allows us to have an external reference and update easily.

.. _MDN: http://svn.mozilla.org/projects/mdn/trunk/locale/
2 changes: 2 additions & 0 deletions docs/libs.rst
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,8 @@ Internationalization (i18n) and Localization (L10n)
* `tower <https://github.com/clouserw/tower>`_\*:
A library that builds on Babel and Jinja2 to make extracting strings easy and
uniform.
* `The Translate toolkit <http://translate.sourceforge.net/wiki/toolkit/index>`_:
Tools for working between translation formats.

Middleware
----------
Expand Down

0 comments on commit f173127

Please sign in to comment.