[wp-polyglots] Locale Directory Structure

[Ryan Boren]

In order to make automated packaging easier, let's define the locale
directory structure more precisely.

All trunk development happens under lc_CC/trunk/.  Beneath this we have
the following arrangement (using fr_FR as an example):

./fr_FR/trunk/dist:
license.txt  readme.html

./fr_FR/trunk/messages:
fr_FR.mo  fr_FR.po

./fr_FR/trunk/theme:
404.php       comments-popup.php  index.php       search.php
archive.php   footer.php          links.php       sidebar.php
archives.php  header.php          page.php        single.php
comments.php  images              searchform.php  style.css

./fr_FR/trunk/theme/images:
kubrickbgcolor.jpg  kubrickbgwide.jpg  kubrickheader.jpg
kubrickbg.jpg       kubrickfooter.jpg


Consider the dist directory to be the root of a wordpress installation.
There is no need for a dist/wordpress/ subdirectory.  The dist directory
will typically contain license.txt, readme.html, and
wp-config-sample.php.  If you put other WP files in there, please place
them in a directory structure that corresponds to the core WP structure.
For example, wp-admin/install.php should go in
dist/wp-admin/install.php.  By the way, including wp-config-sample.php
is not necessary if you are just setting WPLANG.  That can be automated.
If you want to localize the example username and password and the
comments, then including wp-config-sample.php is necessary.

I notice that some locales are providing different versions of the
default theme for each character set they support.  Let's decide on a
structure for this.  How about:

lc_CC/trunk/theme/UTF-8/index.php
lc_CC/trunk/theme/ISO-8859-1/index.php

The character set name must match the name used for the po and mo files.

lc_CC.UTF-8.mo
lc_CC.ISO-8859-1.mo

Also, let's use standard character set names.

http://www.iana.org/assignments/character-sets

For example, UTF-8 is not UTF or Unicode.  There is no such thing as
UTF, and Unicode is a set of code tables, not a specific character
encoding.

http://www.cl.cam.ac.uk/~mgk25/unicode.html#utf-8

If a character set is not specified, UTF-8 is assumed.

Ryan