Rename "National" keys to "Writing system" keys.
authorGary Kacmarcik <garykac@google.com>
Fri, 25 Jan 2013 13:12:15 -0800
changeset 18 8b0d18e9c45e
parent 17 d513fa801ea4
child 19 748a6d8941b2
Rename "National" keys to "Writing system" keys.
Auto-number tables with captions.
source_respec.htm
table.css
--- a/source_respec.htm	Fri Jan 25 11:04:31 2013 -0800
+++ b/source_respec.htm	Fri Jan 25 13:12:15 2013 -0800
@@ -433,7 +433,7 @@
             <section id="key-event-motivation">
                 <h1>Motivation for Adding the <code>code</code> Attribute</h1>
                 <p>As discussed in more detail later in this document, the standard PC keyboard has a set of keys (which
-                   we label "National" keys) that generate different <code>char</code> and <code>key</code> values 
+                   we refer to as "writing system" keys) that generate different <code>char</code> and <code>key</code> values 
                    based on the current keyboard layout selected by the user.
                    This situation makes it difficult to write code that detects keys based on their physical
                    location since the code would need to know which layout is in effect in order to know which
@@ -717,7 +717,7 @@
                 <section id="keyboard-laptops">
                     <h1>Laptop Keyboard Layouts</h1>
                     <p>The limited space available on laptop keyboards often means that the physical key layout needs
-                       to be adjusted to fit all the required keys. The National keys in the Alphanumeric section tend
+                       to be adjusted to fit all the required keys. The writing system keys in the Alphanumeric section tend
                        to remain intact, but the other keyboard sections are usually combined with other keys or
                        removed altogether.
                     </p>
@@ -733,15 +733,15 @@
 
                 <section id="key-alphanumeric-section">
                     <h1>Alphanumeric Section</h1>
-                    <p>The Alphanumeric section keys fall into two general classes: "national" keys whose meaning changes based on
+                    <p>The Alphanumeric section keys fall into two general categories: "writing system" keys whose meaning changes based on
                        the current keyboard layout, and "functional" keys which are (mostly) the same for all layouts.
                     </p>
-                    <section id="key-alphanumeric-national">
-                        <h1>National Keys</h1>
-                        <p>The National keys are those that change meaning based on the current keyboard layout.
+                    <section id="key-alphanumeric-writing-system">
+                        <h1>Writing System Keys</h1>
+                        <p>The "writing system" keys are those that change meaning based on the current keyboard layout.
                         </p>
-                        <object class="figure" data="keyboard-codes-alphanum1.svg" type="image/svg+xml" width="653" height="225" title="The national keys in the alphanumeric section."></object>
-                        <p>This figure shows a hypothetical keyboard that combines all the "national" keys (shown in
+                        <object class="figure" data="keyboard-codes-alphanum1.svg" type="image/svg+xml" width="653" height="225" title="The writing system keys in the alphanumeric section."></object>
+                        <p>This figure shows a hypothetical keyboard that combines all the writing system keys (shown in
                            blue and green) found on the various keyboards.
                            Blue keys are present on all standard keyboards while green keys are only available on some keyboards.
                         </p>
@@ -750,8 +750,8 @@
                            (i.e., based on the US keyboard layout) in that position. For keys that don't
                            exist on the US keyboard, names from the UK or Japanese layouts are used instead.
                         </p>
-                        <table id="table-key-code-alphanumeric-national" class="data-table full-width">
-                            <caption>Table 1: List of code values for national keys in the Alphanumeric section.</caption>
+                        <table id="table-key-code-alphanumeric-writing-system" class="data-table full-width">
+                            <caption>List of code values for writing system keys in the Alphanumeric section.</caption>
                             <thead><tr><th>Code Value</th><th>USB Usage ID<br/>Page 0x07<br/>(Informative)</th><th>Notes (Informative)</th></tr></thead>
                             <tbody>
                                 <tr><td><code id="code-BackQuote" class="key-code">'BackQuote'</code></td>
@@ -877,17 +877,17 @@
                         </p>
                         <object class="figure" data="keyboard-codes-alphanum2.svg" type="image/svg+xml" width="653" height="225" title="The standard set of functional keys in the alphanumeric section."></object>
                         <table id="table-key-code-alphanumeric-functional" class="data-table full-width">
-                            <caption>Table 2: List of code values for functional keys in the Alphanumeric section.</caption>
+                            <caption>List of code values for functional keys in the Alphanumeric section.</caption>
                             <thead><tr><th>Code Value</th><th>USB Usage ID<br/>Page 0x07<br/>(Informative)</th><th>Notes (Informative)</th></tr></thead>
                             <tbody>
                                 <tr><td><code id="code-AltLeft" class="key-code">'AltLeft'</code></td>
                                     <td>0xe2</td><td>Labelled <code class="keycap">Alt</code> or <code class="keycap">Option</code>.</td></tr>
                                 <tr><td><code id="code-AltRight" class="key-code">'AltRight'</code></td>
                                     <td>0xe6</td><td>Labelled <code class="keycap">Alt</code> or <code class="keycap">Option</code>. This is the <code class="keycap">AltGr</code> key on many keyboard layouts.</td></tr>
+                                <tr><td><code id="code-CapsLock" class="key-code">'CapsLock'</code></td>
+                                    <td>0x39</td><td></td></tr>
                                 <tr><td><code id="code-ContextMenu" class="key-code">'ContextMenu'</code></td>
                                     <td>0x65</td><td>The application context menu key, which is typically found between the right OS key and the right Control key.</td></tr>
-                                <tr><td><code id="code-CapsLock" class="key-code">'CapsLock'</code></td>
-                                    <td>0x39</td><td></td></tr>
                                 <tr><td><code id="code-ControlLeft" class="key-code">'ControlLeft'</code></td>
                                     <td>0xe0</td><td></td></tr>
                                 <tr><td><code id="code-ControlRight" class="key-code">'ControlRight'</code></td>
@@ -912,7 +912,7 @@
                         </p>
                         <object class="figure" data="functional-row-a.svg" type="image/svg+xml" width="700" height="160" title="Comparison of the lower row of functional keys on different keyboards."></object>
                         <table id="table-key-code-alphanumeric-functional" class="data-table full-width">
-                            <caption>Table 3: List of code values for functional keys found on Japanese and Korean keyboards.</caption>
+                            <caption>List of code values for functional keys found on Japanese and Korean keyboards.</caption>
                             <thead><tr><th>Code Value</th><th>USB Usage ID<br/>Page 0x07<br/>(Informative)</th><th>Notes (Informative)</th></tr></thead>
                             <tbody>
                                 <tr><td><code id="code-Convert" class="key-code">'Convert'</code></td>
@@ -939,7 +939,7 @@
                     </p>
                     <object class="figure" data="control-pad.svg" type="image/svg+xml" width="495" height="135" title="Standard Control Pad layouts"></object>
                     <table id="table-key-code-controlpad" class="data-table full-width">
-                        <caption>Table 4: List of code values for keys in the ControlPad section.</caption>
+                        <caption>List of code values for keys in the ControlPad section.</caption>
                         <thead><tr><th>Code Value</th><th>USB Usage ID<br/>Page 0x07<br/>(Informative)</th><th>Notes (Informative)</th></tr></thead>
                         <tbody>
                             <tr><td><code id="code-Delete" class="key-code">'Delete'</code></td>
@@ -969,7 +969,7 @@
                     </p>
                     <object class="figure" data="arrow-pad.svg" type="image/svg+xml" width="160" height="115" title="Standard Arrow Pad layout"></object>
                     <table id="table-key-code-arrowpad" class="data-table full-width">
-                        <caption>Table 5: List of code values for keys in the ArrowPad section.</caption>
+                        <caption>List of code values for keys in the ArrowPad section.</caption>
                         <thead><tr><th>Code Value</th><th>USB Usage ID<br/>Page 0x07<br/>(Informative)</th><th>Notes (Informative)</th></tr></thead>
                         <tbody>
                             <tr><td><code id="code-ArrowDown" class="key-code">'ArrowDown'</code></td>
@@ -995,7 +995,7 @@
                        listed in the table below.
                     </p>
                     <table id="table-key-code-numpad" class="data-table full-width">
-                        <caption>Table 6: List of code values for keys in the Numpad section.</caption>
+                        <caption>List of code values for keys in the Numpad section.</caption>
                         <thead><tr><th>Code Value</th><th>USB Usage ID<br/>Page 0x07<br/>(Informative)</th><th>Notes (Informative)</th></tr></thead>
                         <tbody>
                             <tr><td><code id="code-NumLock" class="key-code">'NumLock'</code></td>
@@ -1076,7 +1076,7 @@
                        Because of this, the <code>code</code> is always set to the function key name.
                     </p>
                     <table id="table-key-code-function" class="data-table full-width">
-                        <caption>Table 7: List of code values for keys in the Function section.</caption>
+                        <caption>List of code values for keys in the Function section.</caption>
                         <thead><tr><th>Code Value</th><th>USB Usage ID<br/>Page 0x07<br/>(Informative)</th><th>Notes (Informative)</th></tr></thead>
                         <tbody>
                             <tr><td><code id="code-Esc" class="key-code">'Esc'</code></td>
@@ -1147,7 +1147,7 @@
                        keyboards.
                     </p>
                     <table id="table-key-code-media" class="data-table full-width">
-                        <caption>Table 8: List of code values for media keys.</caption>
+                        <caption>List of code values for media keys.</caption>
                         <thead><tr><th>Code Value</th><th>Notes (Informative)</th></tr></thead>
                         <tbody>
                             <tr><td><code id="code-BrowserBack" class="key-code">'BrowserBack'</code></td>
@@ -1204,7 +1204,7 @@
                        They are listed here are for reference purposes.
                     </p>
                     <table id="table-key-code-legacy" class="data-table full-width">
-                        <caption>Table 9: List of code values for legacy keys.</caption>
+                        <caption>List of code values for legacy keys.</caption>
                         <thead><tr><th>Code Value</th><th>Notes (Informative)</th></tr></thead>
                         <tbody>
                             <tr><td><code id="code-Meta" class="key-code">'Meta'</code></td>
--- a/table.css	Fri Jan 25 11:04:31 2013 -0800
+++ b/table.css	Fri Jan 25 13:12:15 2013 -0800
@@ -1,8 +1,20 @@
+body {
+  counter-reset: table;
+}
+
 /* default alignment for tables */
 table {
   margin-bottom: 1em;
 }
 
+table > caption {
+  counter-increment: table;
+}
+
+table > caption:before {
+  content: "Table " counter(table) ": ";
+}
+
 td {
   vertical-align: middle;
 }