Skip to main content

Overview

Due to the complexities involved in distributing and deploying across 194 languages and 15 regions it's helpful to understand the processes involved.

The plan

MWF distributions are divided between the MWF JavaScript libraries and the MWF CSS libraries. The two are distributed together for each release. This means that you must import 2 distributions to your web pages: one for the CSS and one for the JavaScript. You will want to use the same release versions for each distribution to avoid functionality problems.

However, understanding the relationship between the two is very important. There is a 1:1 relationship between the CSS libraries and the JavaScript libraries. When they do not match, you are certain to see functionality problems on your web pages. On the other hand, there is a 1:many relationship between the JavaScript library and the CSS library. This is because each release of MWF includes CSS libraries for all of those 190 locales across 13 regions.

So, how do you know which libraries to use? Using the information from the CDN page, you do the following:

  1. Download the current Manifest file.
  2. From the information in the Manifest file, download a copy of the localization.json file.
  3. Use the information in the localization.json file to determine the locale you wish to use for your web page.
  4. From the Manifest file, determine which distribution path you want to use from the 4 options for your CSS library.
  5. Next, determine the distribution path you want to use from the 4 options for your JavaScript library.
  6. Now you need to determine the name of the CSS distribution according to the instructions on the CDN page. This represents the specific CSS library appropriate for your web page and your locale.
  7. Now you need to determine which JavaScript library to use. See the library list on the Scripting page to determine the name of the library version you need. Note that these names rarely change.
  8. To assemble the URL needed to import your MWF CSS library, combine the path from Step 4 with the library name from Step 6.
  9. To assemble the URL needed to import your MWF JavaScript library, combine the path from Step 5 with the library name from Step 7.
  10. Use these URLs to import the localized MWF distribution into your web pages.