Design Proposals
Each release of the Unicode CLDR is a stable release and may be used as reference material or cited as a normative reference by other specifications. Each version, once published, is absolutely stable and will never change. Implementations may also apply CLDR Corrigenda to a release. Bug reports and feature requests for subsequent versions may be filed at Bug Reports.
The following table lists the files for each released version. For license information, see the Unicode Terms of Use; in particular, Exhibit 1.
- The Release Note contains a general description of the contents of the release, and any relevant notes about the release.
- The Data link points to a set of zip files containing the contents of the release (the files are complete in themselves, and do not require files from earlier releases -- for the structure of the zip file, see Repository Organization).
- The Spec is the version of UTS #35: LDML that corresponds to the release.
- The Delta document points to a list of all the bug fixes and features in the release, which be used to get the precise corresponding file changes using BugDiffs.)
- The SVN tag can be used to get the files in SVN.
Access to the latest working snapshot of CLDR, and access to data collected for other platforms is available through the web. The SVN Tag can be used to get the contents of the release, as described below.
Repository Access
CLDR files are maintained in the SVN source code repository at http://unicode.org/repos/cldr/. At the top level of the repository, there are three subdirectories below:
- trunk - The latest CLDR files along the main line development
- tags - The tagged version of CLDR files including official release versions
- branches - The working branches
There are several ways to access the repository contents.
Simple SVN Browsing. For browsing a particular file for a particular version, or revision history of a particular file, use the Trac Browser. For example:
Simple SVN File Access. For downloading a particular file, use the SVN Browser. For example:
Advanced SVN Access. For more access to the source repository, you can use an SVN client to check out or export LDML files directory from the repository at http://unicode.org/repos/cldr/. For example:
- Export entire contents of CLDR 1.7 release -
svn export http://unicode.org/repos/tags/release-1-7 [LOCALE_PATH]
- Check out the latest CLDR snapshot -
svn co http://unicode.org/repos/trunk [LOCAL_PATH]
- Synchronize the local CLDR contents originally checked out with the latest revision -
svn update
At the top level of each SVN repository tree, there are a number of special folders, plus a number of platform folders. To see the structure, go to Trac Browser or SVN Browser. The special folders are listed below.
- common — CLDR data corresponding to the release
- collation — collation LDML files
- dtd — the latest dtd files for the release
- main — the main locale-dependent LDML files
- rbnf — rule-based number formats
- segments — rules for segmenting text
- supplemental — additional files with non-linguistic data
- transforms — data for transliteration and other text transforms
- docs — source files for the CLDR site, design docs, presentations, etc. The newer design docs are in Design Proposals
- external — old comparison files with generated platform data. This is provided for comparison only, and is not to be viewed as authoritative or referenceable.
- posix — generated POSIX files
- test — conformance test files for CLDR data. The format of the tests is explained in a readMe.html.
- tools — source for internal tools for processing CLDR data
The common, dtd, tools, and test folders are in each release.
CLDR includes reference versions of POSIX-format locale source files that are generated using the default options for each supported locale. The reference versions of POSIX source information contain those data fields that are included in the POSIX specification.
Many operating system platforms provide additional extensions to the minimal POSIX required field set. Individual implementations may require addition of the platform-specific fields or a non-default character repertoire in order to provide full functionality on a given POSIX compliant operating system. As of the current release, the POSIX locale generation tools do not generate such platform-specific extensions, but they can be modified to support this.
The 1.0 version of CLDR is described here for historical interest only. It was hosted on the OpenI18N site before the CLDR project moved to the Unicode Consortium.
|
|