Generating Charts

Generate

The input for this is the cldr-staging/production file, and the output is in github cldr-staging. If for the development version, the input is main or the maint branch, but we should change that. 
  1. Make sure the version is right in ToolConstants (eg 30).
    1. Make sure the last number (eg 39.0) is in CLDR_VERSIONS
    2. When updating that, also add an new folder with that number, such as cldr-staging/docs/charts/39.0
  2. You will want the right status value:
    1. -DCHART_STATUS=beta (default, uses trunk, calls it β)
    2. -DCHART_STATUS=trunk (uses trunk, no β. Used at the end of the release, but before the final data is in cldr-archive)
    3. -DCHART_STATUS=release (only uses the cldr-archive, no β)
  3. So, here is what the VM arguments will look like:
    1. -DCHART_STATUS=release
    2. -DCHART_VERSION=39.0
  4. Run GenerateAllCharts. The results for each will be in ... cldr-staging/docs/charts/by_type/names.currency.html and so on. 
    1. If there is a failure in the Transform charts, it is often because of a missing dependency. 
      • Goto CLDRTransforms.DependencyOrder, and add an item there.
      • Example: addDependency("Latin-Bopomofo", "Latin-NumericPinyin");
  5. Spot-check for sanity.
    1. Start from the main page (eg cldr-staging/docs/charts/index.html), and click on each of those links. 
    2. On each of the subpages, take the first chart on each page, recursively.
    3. Use the "Index" link to go back up (not the back button), and make sure it goes to the right version of the page.
  6. Check into github.
  7. In the printout from delta_summary.txt, there is a listing of the sizes at the top
    1. Something like the following:
      1. # dir file added deleted changed total

        TOTAL 30,276 3,601 10,909 2,153,094

    2. Add those new figures to the release page

Start/End of Release


TBD: Fix the following.
  1. At the end of the release
    1. Generate with -DCHART_STATUS=trunk 
    2. Change the page http://cldr.unicode.org/index/charts to add the new release
    3. Check the redirection links on test-chart-links.
    4. On index.html; open it, and fix the version (eg to 25β => 25)
  2. At the start of the release:
    1. change ToolConstants to bump these values as appropriate, eg:
      1. DEFAULT_CHART_VERSION = "28";
    2. Create the archive (Creating the Archive) with at least the last release (if you don't have it already)
    3. generate as above. This will change the version to (say) "25β" visible on each page. 
    4. Spot check for sanity as well, as above.
    5. copy index.html from the last version to the current version; open it, and fix the version (eg to 25β)
    6. checkin to SVN
    7. Check the redirection links on test-chart-links.

Modifying the chart programs

The chart programs have grown over time, and need some cleanup. For example, the supplemental charts duplicate code that is now in SupplementalDataInfo. 

ShowLanguages. The messages that they use are in a file util/data/chart_messages.html. The right cell contains the key, which is extracted by lines like:

      PrintWriter pw = new PrintWriter(new FormattedFileWriter(index, "Zone \u2192 Tzid", null));

The key will be zone_tzid, in this case.

Comments