git.oblomov.eu Git - xorg/xkeyboard-config/blob - docs/README.symbols

   1
   2 The files in the symbols directory describe possible layouts for a given
   3 keyboard.
   4
   5 The default layout in each file should describe the most common layout
   6 for its kind, ususally the symbols printed on the keys. Layout variants
   7 can describe common differences that are not necessarily printed on the keys.
   8 (e.g. a phonetic version of Cyrillic).
   9
  10 The names of the files are referenced throughout the XKB rules, and may be
  11 exposed in the X server configuration and in user configuration tools.
  12 The filenames use the following convention:
  13
  14 Country layouts:
  15
  16   Keyboard layouts for a country must use the 2-letter code from the
  17   ISO-3166 standard.
  18
  19 Language layouts:
  20
  21   Keyboard layouts for a language must use the 3-letter code from the
  22   ISO-639 standard.
  23
  24 Script layouts:
  25
  26   Keyboard layouts for a script must use the 4-letter code from the
  27   ISO-15924 standard.
  28
  29 Other:
  30
  31   Keyboard layouts that do not fit in the above model and directories
  32   must use a filename between 5 and 8 characters.
  33
  34 The ISO codes can be found at the following addressed:
  35
  36 Country layouts:  http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/iso_3166-1_decoding_table.html
  37 Language layouts: http://www.loc.gov/standards/iso639-2/langcodes.html
  38 Script layouts:   http://www.unicode.org/iso15924/iso15924-codes.html