Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

CLDR-17093 kbd: remove vkeys #3284

Merged
merged 1 commit into from
Sep 27, 2023
Merged

CLDR-17093 kbd: remove vkeys #3284

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
150 changes: 5 additions & 145 deletions docs/ldml/tr35-keyboards.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ The LDML specification is divided into the following parts:
* [File and Directory Structure](#File_and_Dir_Structure)
* [Extensibility](#Extensibility)
* [Element Hierarchy](#element-hierarchy)
* [Element: keyboard](#Element_Keyboard)
* [Element: keyboard3](#Element_Keyboard)
* [Element: locales](#Element_locales)
* [Element: locale](#Element_locale)
* [Element: version](#Element_version)
Expand All @@ -92,8 +92,6 @@ The LDML specification is divided into the following parts:
* [Element: layers](#Element_layers)
* [Element: layer](#Element_layer)
* [Element: row](#Element_row)
* [Element: vkeys](#Element_vkeys)
* [Element: vkey](#Element_vkey)
* [Element: variables](#Element_variables)
* [Element: string](#element-string)
* [Element: set](#element-set)
Expand All @@ -116,7 +114,6 @@ The LDML specification is divided into the following parts:
* [Keyboard IDs](#Keyboard_IDs)
* [Principles for Keyboard IDs](#Principles_for_Keyboard_IDs)
* [Platform Behaviors in Edge Cases](#Platform_Behaviors_in_Edge_Cases)
* [CLDR VKey Enum](#CLDR_VKey_Enum)
* [Keyboard Test Data](#keyboard-test-data)
* [Test Doctype](#test-doctype)
* [Test Element: keyboardTest](#test-element-keyboardtest)
Expand Down Expand Up @@ -172,7 +169,7 @@ Some goals of this format are:
Some non-goals (outside the scope of the format) currently are:

1. Adaptation for screen scaling resolution. Instead, keyboards should define layouts based on physical size. Platforms may interpret physical size definitions and adapt for different physical screen sizes with different resolutions.
2. Unification of platform-specific vkey and scan code mapping tables.
2. Unification of platform-specific virtual key and scan code mapping tables.
3. Unification of pre-existing platform layouts themselves (e.g. existing fr-azerty on platform a, b, c).
4. Support for prior (pre 3.0) CLDR keyboard files. See [Compatibility Notice](#Compatibility_Notice).
5. Run-time efficiency. [LDML is explicitly an interchange format](./tr35.md#Introduction), and so it is expected that data will be transformed to a more compact format for use by a keystroke processing engine.
Expand Down Expand Up @@ -336,7 +333,7 @@ This is the top level element. All other elements defined below are under this e
>
> Parents: _none_
>
> Children: [displays](#Element_displays), [import](#Element_import), [info](#Element_info), [keys](#Element_keys), [layers](#Element_layers), [locales](#Element_locales), [names](#Element_names), [settings](#Element_settings), [_special_](tr35.md#special), [transforms](#Element_transforms), [variables](#Element_variables), [version](#Element_version), [vkeys](#Element_vkeys)
> Children: [displays](#Element_displays), [import](#Element_import), [info](#Element_info), [keys](#Element_keys), [layers](#Element_layers), [locales](#Element_locales), [names](#Element_names), [settings](#Element_settings), [_special_](tr35.md#special), [transforms](#Element_transforms), [variables](#Element_variables), [version](#Element_version)
>
> Occurrence: required, single
>
Expand Down Expand Up @@ -950,7 +947,7 @@ where a flick to the Northeast then South produces two code points.
### <a name="Element_import" href="#Element_import">Element: import</a>

The `import` element is used to reference another xml file so that elements are imported from
another file. The use case is to be able to import a standard set of vkeys, transforms, and similar
another file. The use case is to be able to import a standard set of transforms, and similar
from the CLDR repository. `<import>` is not recommended as a way for keyboard authors to
split up their keyboard into multiple files, as the intent is for each single XML file to contain all that is needed for a keyboard layout.

Expand All @@ -965,8 +962,7 @@ If two identical elements are defined, the later element will take precedence, t
```
> <small>
>
> Parents: [displays](#Element_displays), [keyboard3](#Element_keyboard), [keys](#Element_keys), [layers](#Element_layers), [names](#Element_names), [reorders](#Element_reorders), [transformGroup](#Element_transformGroup), [transforms](#Element_transforms), [variables](#Element_variables), [vkeys](#Element_vkeys)
>
> Parents: [displays](#Element_displays), [keyboard3](#Element_keyboard), [keys](#Element_keys), [layers](#Element_layers), [names](#Element_names), [reorders](#Element_reorders), [transformGroup](#Element_transformGroup), [transforms](#Element_transforms), [variables](#Element_variables)
> Children: _none_
>
> Occurrence: optional, multiple
Expand Down Expand Up @@ -1438,79 +1434,6 @@ Here is an example of a `row` element:

* * *

### <a name="Element_vkeys" href="#Element_vkeys">Element: vkeys</a>

On some architectures, applications may directly interact with keys before they are converted to characters. The keys are identified using a virtual key identifier or vkey. The mapping between a physical keyboard key and a vkey is keyboard-layout dependent. For example, a French keyboard would identify the top-left key as being an `A` with a vkey of `A` as opposed to `Q` on a US English keyboard. While vkeys are layout dependent, they are not modifier dependent. A shifted key always has the same vkey as its unshifted counterpart. In effect, a key may be identified by its vkey and the modifiers active at the time the key was pressed.

**Syntax**

```xml
<vkeys>
{a set of vkey elements}
</vkeys>
```

> <small>
>
> Parents: [keyboard3](#Element_keyboard)
>
> Children: [import](#Element_import), [_special_](tr35.md#special), [vkey](#Element_vkey)
>
> Occurrence: optional, single
>
> </small>

There is at most a single vkeys element per keyboard.

A `vkeys` element consists of a list of `vkey` elements.

* * *

### <a name="Element_vkey" href="#Element_vkey">Element: vkey</a>

A `vkey` element describes a mapping between a key and a vkey.

**Syntax**

```xml
<vkey from="{from}" to="{to}" />
```

> <small>
>
> Parents: [vkeys](#Element_vkeys)
>
> Children: _none_
>
> Occurrence: required, multiple
>
> </small>

_Attribute:_ `from` (required)

> The vkey being mapped from. See [CLDR VKey Enum](#CLDR_VKey_Enum) for a reference table.

_Attribute:_ `to` (required)

> The resultant vkey identifier. See [CLDR VKey Enum](#CLDR_VKey_Enum) for a reference table.

**Example**

This example shows some of the mappings for a French keyboard layout:

```xml
<keyboard3>
<vkeys>
<vkey from="Q" to="A" />
<vkey from="W" to="Z" />
<vkey from="A" to="Q" />
<vkey from="Z" to="W" />
</vkeys>
</keyboard3>
```

* * *

### <a name="Element_variables" href="#Element_variables">Element: variables</a>

> <small>
Expand Down Expand Up @@ -2595,69 +2518,6 @@ The following are the design principles for the IDs.

* * *

## <a name="CLDR_VKey_Enum" href="#CLDR_VKey_Enum">CLDR VKey Enum</a></a>

In the following chart, “CLDR Name” indicates the value used with the `from` and `to` attributes of the [vkey](#Element_vkey) element.

| CLDR Name | US English ISO | Hex<sup>1</sup> | Notes |
|-----------|----------------|-----------------|-------------|
| SPACE | A03 | 0x20 |
| 0 | E10 | 0x30 |
| 1 | E01 | 0x31 |
| 2 | E02 | 0x32 |
| 3 | E03 | 0x33 |
| 4 | E04 | 0x34 |
| 5 | E05 | 0x35 |
| 6 | E06 | 0x36 |
| 7 | E07 | 0x37 |
| 8 | E08 | 0x38 |
| 9 | E09 | 0x39 |
| A | C01 | 0x41 |
| B | B05 | 0x42 |
| C | B03 | 0x43 |
| D | C03 | 0x44 |
| E | D03 | 0x45 |
| F | C04 | 0x46 |
| G | C05 | 0x47 |
| H | C06 | 0x48 |
| I | D08 | 0x49 |
| J | C07 | 0x4A |
| K | C08 | 0x4B |
| L | C09 | 0x4C |
| M | B07 | 0x4D |
| N | B06 | 0x4E |
| O | D09 | 0x4F |
| P | D10 | 0x50 |
| Q | D01 | 0x51 |
| R | D04 | 0x52 |
| S | C02 | 0x53 |
| T | D05 | 0x54 |
| U | D07 | 0x55 |
| V | B05 | 0x56 |
| W | D02 | 0x57 |
| X | B02 | 0x58 |
| Y | D06 | 0x59 |
| Z | B01 | 0x5A |
| SEMICOLON | C10 | 0xBA |
| EQUAL | E12 | 0xBB |
| COMMA | B08 | 0xBC |
| HYPHEN | E11 | 0xBD |
| PERIOD | B09 | 0xBE |
| SLASH | B10 | 0xBF |
| GRAVE | E00 | 0xC0 |
| LBRACKET | D11 | 0xDB |
| BACKSLASH | D13 | 0xDC |
| RBRACKET | D12 | 0xDD |
| QUOTE | C11 | 0xDE |
| LESS-THAN | B00 | 0xE2 | 102nd key on European layouts, right of left shift. |
| ABNT2 | B11 | 0xC1 | Extra key, left of right-shift, Brazilian Portuguese ABNT2 keyboards |

Footnotes:

* <sup>1</sup> Hex value from Windows, web standards, Keyman, etc.

* * *

## Keyboard Test Data

Keyboard Test Data allows the keyboard author to provide regression test data to validate the repertoire and behavior of a keyboard. Tooling can run these regression tests against an implementation, and can also be used as part of the development cycle to validate that keyboard changes do not deviate from expected behavior. In the interest of complete coverage, tooling could also indicate whether all keys and gestures in a layout are exercised by the test data.
Expand Down
16 changes: 0 additions & 16 deletions keyboards/3.0/fr-t-k0-azerty.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,22 +23,6 @@
</names>
<settings fallback="omit" />

<vkeys>
<vkey from="Q" to="A" />
<vkey from="W" to="Z" />
<vkey from="A" to="Q" />
<vkey from="Z" to="W" />
<vkey from="BKQUOTE" to="QUOTE" /> <!-- i.e., OEM_3 >>> OEM_7 -->
<vkey from="MINUS" to="LBRKT" />
<vkey from="LBRKT" to="RBRKT" />
<vkey from="COLON" to="M" />
<vkey from="QUOTE" to="BKQUOTE" />
<vkey from="M" to="COMMA" />
<vkey from="COMMA" to="PERIOD" />
<vkey from="PERIOD" to="SLASH" />
<vkey from="SLASH" to="EXCLAMATION" /> <!-- i.e., OEM_2 >>> OEM_8 -->
</vkeys>

<displays>
<!-- Note: displays is only used for keycap presentation -->
<!-- this example is not required for this keyboard as we use the spacing
Expand Down
13 changes: 1 addition & 12 deletions keyboards/dtd/ldmlKeyboard3.dtd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ The CLDR Keyboard Subcommittee is currently developing major changes to the CLDR
Please view the subcommittee page for the most recent information.
<https://cldr.unicode.org/index/keyboard-workgroup> -->

<!ELEMENT keyboard3 ( import*, locales?, version?, info?, names, settings?, vkeys?, displays?, keys?, forms?, layers*, variables?, transforms*, special* ) >
<!ELEMENT keyboard3 ( import*, locales?, version?, info?, names, settings?, displays?, keys?, forms?, layers*, variables?, transforms*, special* ) >
<!--@TECHPREVIEW-->
<!ATTLIST keyboard3 locale CDATA #REQUIRED >
<!--@MATCH:validity/bcp47-wellformed-->
Expand Down Expand Up @@ -77,17 +77,6 @@ Please view the subcommittee page for the most recent information.
<!ATTLIST settings fallback (omit) #IMPLIED >
<!--@VALUE-->

<!ELEMENT vkeys ( import*, vkey*, special* ) >
<!--@TECHPREVIEW-->

<!ELEMENT vkey EMPTY >
<!--@TECHPREVIEW-->
<!ATTLIST vkey from CDATA #REQUIRED >
<!--@MATCH:any-->
<!ATTLIST vkey to CDATA #REQUIRED >
<!--@MATCH:any-->
<!--@VALUE-->

<!ELEMENT displays ( import*, display*, displayOptions*, special* ) >
<!--@TECHPREVIEW-->

Expand Down
21 changes: 0 additions & 21 deletions keyboards/dtd/ldmlKeyboard3.xsd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,6 @@ Note: DTD @-annotations are not currently converted to .xsd. For full CLDR file
<xs:element minOccurs="0" ref="info"/>
<xs:element ref="names"/>
<xs:element minOccurs="0" ref="settings"/>
<xs:element minOccurs="0" ref="vkeys"/>
<xs:element minOccurs="0" ref="displays"/>
<xs:element minOccurs="0" ref="keys"/>
<xs:element minOccurs="0" ref="forms"/>
Expand Down Expand Up @@ -148,26 +147,6 @@ Note: DTD @-annotations are not currently converted to .xsd. For full CLDR file



<xs:element name="vkeys">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="import"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="vkey"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="special"/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:element name="vkey">
<xs:complexType>
<xs:attribute name="from" use="required"/>
<xs:attribute name="to" use="required"/>
</xs:complexType>
</xs:element>




<xs:element name="displays">
<xs:complexType>
<xs:sequence>
Expand Down
Loading