Merge pull request #907 from keymanapp/chore/master-to-staging-a17s27

chore: Merge master to staging for Sprint a17s27

developer/language/guide/virtual-keys.md

@@ -98,10 +98,11 @@ Every key on the keyboard is identified by a virtual key code. Virtual
 keys are identified by square brackets `[ ]` containing a combination of
 zero or more shift-key codes and a virtual key code.
 
-Virtual keys are used in the key section of a rule. Virtual keys are not
+Virtual keys are only used in the key section of a rule. Virtual keys are not
 valid in the context of a rule, as the context consists solely of
-characters. As virtual keys can only be output on a few platforms, they
-should not be used in the output section of a rule.
+characters, nor in the output of the rule (note: Keyman for Windows did
+unofficially support output of virtual keys until version 14.0, but it never
+worked reliably).
 
 A typical use of virtual keys is to make rules to recognise
 non-character keys, such as <kbd>Backspace</kbd> or <kbd>Tab</kbd>; for
@@ -714,8 +715,6 @@ c override default bksp behaviour for 'ng'
 + [RALT K_E] > 'è'
 ```
 
-Virtual keys may not be used in the output or context parts of a rule.
-
 ## Virtual keys and touch layouts {#virtual-keys-and-touch-layouts}
 
 Touch layouts do not have physical keyboards, so the concept of virtual

keyboard/aksarabali_panlex/1.1.2/aksarabali_panlex.php

@@ -0,0 +1,36 @@
+<?php
+  $pagename = 'Aksara Bali Keyboard Help';
+  $pagetitle = 'Aksara Bali Keyboard Help';
+  $style = <<<EXTRA
+  span.bali {font-family: "Vimala","Noto Sans Balinese"; font-size: 12pt }
+EXTRA;
+  require_once('header.php');
+?>
+
+<p>This keyboard lets you type Aksara Bali (Balinese script) in Unicode. It is a Unicode reimplementation of the Bali Simbar keyboard (the de-facto standard keyboard in Bali for typing in Balinese script).</p>
+
+<p>The keyboard follows the Bali Simbar keyboard as closely as possible. Basic usage is as follows:</p>
+
+<ul>
+    <li>Type according to Balinese Latin orthography. For example, [W] [A] [Y] [A] [N] [space] types ⟨<span class='bali'>ᬯᬬᬦ᭄</span>⟩.</li>
+    <li>Right after you type a consonant, a question mark ⟨<span class='bali'>?</span>⟩ appears after it. This indicates that the input is incomplete and you still need to type a vowel, consonant, or punctuation mark. The question mark automatically disappears after subsequent input.</li>
+    <li>It is important to type [space] at the end of each word. This does not actually insert a space, but tells the keyboard not to apply certain automatic changes. For example, <em>bapan ceningé</em> typed without a space is incorrect: ⟨<span class='bali'>ᬩᬧᬜ᭄ᬘᭂᬦᬶᬗᬾ</span>⟩. Using [space], the result is the correct ⟨<span class='bali'>ᬩᬧᬦ᭄ᬘᭂᬦᬶᬗᬾ</span>⟩. In order to use explicit <em>adeg-adeg</em> between words, type [space] twice: ⟨<span class='bali'>ᬩᬧᬦ᭄‌ᬘᭂᬦᬶᬗᬾ</span>⟩. To insert a space character, type [Shift-space].</li>
+    <li>In order to override certain automatic changes after consonants, you may occasionally need to type [/]. This blocks various changes by inserting <em>adeg-adeg</em>. For example, typing [R] [/] ensures that [ᬭ] will not be converted to <em>surang</em>.
+    <li>The most common modifiers are Shift, Ctrl, and Ctrl-Shift. For example, [B] [E] types ⟨<span class='bali'>ᬩᭂ</span>⟩, [B] [Shift-E] types ⟨<span class='bali'>ᬩᬾ</span>⟩, and [Ctrl-Shift-E] types ⟨<span class='bali'>ᬏ</span>⟩; [S] types ⟨<span class='bali'>ᬲ</span>⟩ and [S] [Ctrl-'] types ⟨<span class='bali'>ᬰ</span>⟩.</li>
+</ul>
+
+<p>This keyboard contains several additions to the original Bali Simbar keyboard:</p>
+
+<ul>
+    <li>[/] types <em>adeg-adeg</em>.</li>
+    <li>[Ctrl-/] types ZWNJ (zero-width non-joiner). This may be used to prevent certain ligatures. For example, [L] [E] [Ctrl-A] types ⟨<span class='bali'>ᬎ</span>⟩, while [L] [E] [Ctrl-/] [Ctrl-A] types ⟨<span class='bali'>ᬍ‌ᬵ</span>⟩.
+    <li>[Ctrl-Shift-/] types ⟨<span class='bali'>/</span>⟩.</li>
+    <li>[Shift-number] types Arabic numerals. For example, [Shift-1] types ⟨<span class='bali'>1</span>⟩.
+    <li>[Ctrl-Alt-O] types <em>windu</em> ⟨<span class='bali'>᭜</span>⟩.</li>
+    <li>[Ctrl-Shift-,] types ⟨<span class='bali'>᭚᭜᭚</span>⟩. Repeat for ⟨<span class='bali'>᭟᭜᭟</span>⟩.</li>
+    <li>[Ctrl-Shift-.] types ⟨<span class='bali'>᭛᭜᭛</span>⟩. Repeat for ⟨<span class='bali'>᭟᭜᭟</span>⟩.</li>
+    <li>[Alt-vowel] types a dependent vowel even in places where it normally isn’t allowed. For example, [P] [I] [Alt-U] lets you type ⟨<span class='bali'>ᬧᬶᬸ</span>⟩, with <em>suku</em> after <em>ulu</em>. This is attested as a way to indicate a scribal error.</li>
+    <li>[Alt-R] types <em>rerekan</em>. For example, [P] [Alt-R] types ⟨<span class='bali'>ᬧ᬴</span>⟩.</li>
+</ul>
+
+<p>For much more detailed information, read the original <a href="bali_simbar_panduan.pdf">Bali Simbar keyboard guide</a> (in Indonesian), included with the permission of author I Made Suatjana. Keyboard instructions begin on page 8.</p>

keyboard/basic_kbddzo/1.0.1/basic_kbddzo.php

@@ -0,0 +1,27 @@
+<?php 
+  $pagename = 'Dzongkha Basic Keyboard Help';
+  $pagetitle = 'Dzongkha Basic Keyboard Help';
+  // Header we will tidy up later  
+  require_once('header.php');
+
+
+?>
+
+<p style='margin: 16px 0 0 0'>
+Dzongkha Basic keyboard was imported with permission from the Windows 10 keyboard.
+</p>
+<p>If square boxes are displayed instead of characters when using this keyboard (and in the keyboard layouts below), please read our <a href="/troubleshooting/#boxes">troubleshooting guide</a>.
+</p>
+<br/>
+
+<p>This keyboard makes use of SHIFT+RALT keys which are set by default when Keyman is installed. To use this keyboard, you must go to <b>Configuration.../Hotkeys</b> and select the hotkey for "Switch Keyman Desktop Off". Either change the hotkey or turn it off. Do the same for "Open Keyboard Menu" and for "Open Language Switcher".</p>
+
+<h2>Desktop Keyboard Layout</h2>
+<div id='osk' data-states='default shift rightalt rightalt-shift'>
+</div>
+
+<h2>Mobile/Tablet Keyboard Layout</h2>
+<div id='osk-tablet' data-states='default shift alt shift-alt'>
+</div>
+
+

keyboard/basic_kbdnko/1.1.1/basic_kbdnko.php

@@ -0,0 +1,29 @@
+<?php 
+  $pagename = 'N’Ko Basic Keyboard Help';
+  $pagetitle = 'N’Ko Basic Keyboard Help';
+  // Header we will tidy up later  
+  require_once('header.php');
+
+
+?>
+
+
+<p style='margin: 16px 0 0 0'>
+This keyboard is designed for languages using the N’Ko script.
+</p>
+<p>If square boxes are displayed instead of characters when using this keyboard (and in the keyboard layouts below), please read our <a href="/troubleshooting/#boxes">troubleshooting guide</a>.
+</p>
+<p>A font must be installed to support this keyboard. Windows includes the <b>Ebrima</b> font which supports the <b>N'Ko</b> script.</p>
+<br/>
+<p>The Noto Sans NKo font is included in the keyboard package to avoid tofu of the newly added characters.</p>
+
+<h2>Desktop Keyboard Layout</h2>
+<div id='osk'>
+</div>
+
+<h2>Phone/Tablet Keyboard Layout</h2>
+<div id='osk-tablet'>
+</div>
+
+
+

keyboard/basic_kbdsn1/1.2.1/basic_kbdsn1.php

@@ -0,0 +1,19 @@
+<?php 
+  $pagename = 'Sinhala Basic Keyboard Help';
+  $pagetitle = $pagename;
+  // Header we will tidy up later  
+  require_once('header.php');
+?>
+
+
+<p>
+This keyboard layout is designed for Sinhala.  It includes an on screen keyboard which can be viewed 
+by clicking on the Keyman icon and selecting the On Screen Keyboard menu item. The keyboard layout 
+follows the Windows 10 Sinhala layout.
+</p>
+
+<h1>Keyboard Layout</h1>
+
+<h2>Desktop Keyboard Layout</h2>
+<div id='osk' data-states='default shift rightalt'>
+</div>

keyboard/baybayin/1.1.1/baybayin.php

@@ -0,0 +1,15 @@
+<?php 
+  $pagename = 'Baybayin Keyboard Help';
+  $pagetitle = $pagename;
+  // Header we will tidy up later  
+  require_once('header.php');
+?>
+
+<p>
+This keyboard lets you type Baybayin script in Unicode. This keyboard includes an on screen keyboard which can be viewed by clicking on the Keyman icon and selecting the On Screen Keyboard menu item.
+</p>
+
+<h1>Desktop Keyboard Layout</h1>
+<div id='osk' data-states='default shift'>
+</div>
+

keyboard/baybayin/1.2/baybayin.php

@@ -0,0 +1,15 @@
+<?php 
+  $pagename = 'Baybayin Keyboard Help';
+  $pagetitle = $pagename;
+  // Header we will tidy up later  
+  require_once('header.php');
+?>
+
+<p>
+This keyboard lets you type Baybayin script in Unicode. This keyboard includes an on screen keyboard which can be viewed by clicking on the Keyman icon and selecting the On Screen Keyboard menu item.
+</p>
+
+<h1>Desktop Keyboard Layout</h1>
+<div id='osk' data-states='default shift'>
+</div>
+

keyboard/bhaiksuki_inscript/1.0.1/bhaiksuki_inscript.php

@@ -0,0 +1,20 @@
+<?php
+	$pagename = 'Bhaiksuki Inscript Keyboard Help' ;
+	$pagetitle = $pagename ;
+	// Header we will tidy up later
+	require_once( 'header.php' ) ;
+?>
+
+<p>
+	This keyboard is designed for the Sanskrit language, using the Bhaiksuki script with an Inscript layout.
+</p>
+
+<h2>Desktop Keyboard Layout</h2>
+<div id='osk' data-states='default shift alt'>
+</div>
+
+<h2>Phone Keyboard Layout</h2>
+<div id='osk-phone' data-states='default shift numeric rightalt'>
+</div>
+
+<p>© Joshua Wong</p>

keyboard/brahmi_inscript/1.0.1/brahmi_inscript.php

@@ -0,0 +1,20 @@
+<?php
+	$pagename = 'Brahmi Inscript Keyboard Help' ;
+	$pagetitle = $pagename ;
+	// Header we will tidy up later
+	require_once( 'header.php' ) ;
+?>
+
+<p>
+	This keyboard is designed for the Sanskrit language, using the Brahmi script with an Inscript layout.
+</p>
+
+<h2>Desktop Keyboard Layout</h2>
+<div id='osk' data-states='default shift alt'>
+</div>
+
+<h2>Phone Keyboard Layout</h2>
+<div id='osk-phone' data-states='default shift numeric rightalt'>
+</div>
+
+<p>© Joshua Wong</p>

keyboard/buhid/1.0.1/buhid.php

@@ -0,0 +1,27 @@
+<?php 
+  $pagename = 'Buhid Keyboard Help';
+  $pagetitle = $pagename;
+  // Header we will tidy up later  
+  require_once('header.php');
+?>
+
+
+<p class="p1"> Basic Buhid <span style="font-family: Noto Sans Buhid">(ᝊᝓᝑᝒ)</span> Keyboard for Philippines languages, included Tagalog, Buhid, etc. This keyboard covered all Buhid characters on the <a href="http://www.unicode.org/charts/PDF/U1740.pdf">Unicode Standard 13.0</a>. Other additional characters can be included in the future if necesarry. There is no standard keyboard layout yet for the Buhid Keyboard at the moment, so this keyboard can be one of the alternative options.</p>
+
+<p class="p1">This keyboard layout designed based on suggestions from the user group in social media. I would like to thank to the admins of <a href="https://www.facebook.com/groups/1136372230134825/">Writing Script in the Philippines</a> on Facebook : John Andy Untalan Uy, Joliana Juan Sawal, Luke Biglang-Awa, Melgazar Galvan, Nathaniel Pønce de Leøn, & Raymond Bondoc Figueroa for their inputs. If there any other suggestions about the layout design, please let me know.</p>  
+
+<p class="p1">The font used along with this keyboard is Noto Sans Buhid. In case you have not install it on your machine, you can simply download the font from the <a href="https://www.google.com/get/noto/">Google Noto website</a> and install it.</p>   
+
+<h1>Keyboard Layout</h1>
+
+<h2>Desktop Keyboard Layout</h2>
+<div id='osk' data-states='default shift'>
+</div>
+
+<h2>Mobile Keyboard Layout</h2>
+
+<div id='osk-phone' data-states='default numeric'>
+</div>
+
+<p class="footer">This keyboard is part of the <a href="https://kairaga.com>Kairaga.com">Kairaga.com</a> keyboard development program. Please send your thoughts to <a href="mailto:[email protected]">[email protected]</a></p> 
+

keyboard/burushaski_girminas_perso_arabic/1.25/burushaski_girminas_perso_arabic.php

@@ -1,14 +1,12 @@
 <?php 
   $pagename = 'Burushaski Perso Arabic Keyboard Help';
   $pagetitle = $pagename;
-  // Header we will tidy up later  
+  $style = <<<EXTRA
+  p,h1,h2 {font-family: "Burusho Quwatz Nastaliq";}
+EXTRA;
   require_once('header.php');
 ?>
-<head>
-<link rel="stylesheet" href="stylesheet.css">
-</head>
 
-  <body dir="rtl" style="color: #504949;" lang="bsk">
     <h1 align="right"><span lang="hi-IN">بروشسکی
         ارتھو گرافی ، کی بورڈ اور فونٹ</span></h1>
     <p align="right"><span lang="hi-IN"><span lang="hi-IN">بروشسکی

keyboard/dogra_inscript/1.0.2/dogra_inscript.php

@@ -0,0 +1,20 @@
+<?php
+	$pagename = 'Dogra Inscript Keyboard Help' ;
+	$pagetitle = $pagename ;
+	// Header we will tidy up later
+	require_once( 'header.php' ) ;
+?>
+
+<p>
+	This keyboard is designed for the Dogri language, using the Dogra script with an Inscript layout.
+</p>
+
+<h2>Desktop Keyboard Layout</h2>
+<div id='osk' data-states='default shift'>
+</div>
+
+<h2>Phone Keyboard Layout</h2>
+<div id='osk-phone' data-states='default shift'>
+</div>
+
+<p>© Joshua Wong</p>