summaryrefslogtreecommitdiff
path: root/data/extensions/jid1-KtlZuoiikVfFew@jetpack/node_modules/pathfinder/docs/l10n.md
blob: 2207d16db5d688084332ccfdb6a2169e7b3212da (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
<!-- contributed by Erik Vold [erikvvold@gmail.com]  -->

The `l10n` module allows one to localize their Jetpack.

## Example ##

    var _ = require("l10n").l10n({
      filename: "text.properties",
      baseURL: require("self").data.url("locale")
    });
    console.log(_("hello.world"));

<api name="l10n">
@function
  Creates and returns a function which can be used to access translations by
  key.

  Translations should be grouped together in a folder which contains a folder
  for each locale being supported whose name is the locale being supported
  (examples: "en", "en-US", "ja", "ja-JP"). Inside each locale's folder should
  be a `.properties` file with a name that is the same for every locale. Here
  is a example of how you might organize things:

  - data/
      - locale/
          - en/
              - text.properties
          - ja/
              - text.properties

@param options {object}
  

@prop filename {string}
  The name of the file storing the translations.
@prop baseURL {string}
  The url to the folder containing the locale folders.
@prop [defaultLocale] {string}
  Defines the locale to use when you don't have translations for the user's
  locale. The default is `"en"`.
</api>