adding Lakota keyboard layouts

adding Lakota keyboard layouts

[Grant Shoshin Shangreaux]

Hello emacs-devel,

I've created some keyboard layouts for the Lakota language using
quail-define-package and quail-define-rules. I'd like to commit them to
Emacs itself, and would appreciate any suggestions or best practices for
adding them. It looks like they might belong in the lisp/international/
directory?

If I understand the contribution guide correctly, I can send the patch
to the bugs list. I have FSF assignment straightened out. Thanks in
advance for any advice!

-Grant

Re: adding Lakota keyboard layouts

[Robert Pluim]

>>>>> On Mon, 17 May 2021 20:29:49 -0500, Grant Shoshin Shangreaux <grant@churls.world> said:

    Grant> Hello emacs-devel,
    Grant> I've created some keyboard layouts for the Lakota language using
    Grant> quail-define-package and quail-define-rules. I'd like to commit them to
    Grant> Emacs itself, and would appreciate any suggestions or best practices for
    Grant> adding them. It looks like they might belong in the lisp/international/
    Grant> directory?

quail packages normally go in lisp/leim/quail

    Grant> If I understand the contribution guide correctly, I can send the patch
    Grant> to the bugs list. I have FSF assignment straightened out. Thanks in
    Grant> advance for any advice!

Sending it to the bugs list will work. Try to follow the directions in
CONTRIBUTE regarding commit messages, formatting etc.

Robert
-- 

Re: adding Lakota keyboard layouts

[Eli Zaretskii]

> From: Grant Shoshin Shangreaux <grant@churls.world>
> Date: Mon, 17 May 2021 20:29:49 -0500
> 
> I've created some keyboard layouts for the Lakota language using
> quail-define-package and quail-define-rules. I'd like to commit them to
> Emacs itself, and would appreciate any suggestions or best practices for
> adding them. It looks like they might belong in the lisp/international/
> directory?

It should be in lisp/leim/quail/.

Lakota uses the Latin script, right?  So I think your input method(s)
should be in the latin-*.el files, depending on whether they are
prefix or postfix.  Does that sound right?

> If I understand the contribution guide correctly, I can send the patch
> to the bugs list. I have FSF assignment straightened out. Thanks in
> advance for any advice!

Thanks.  As Robert said, please read CONTRIBUTE and format
accordingly.  We generally prefer the patches to be formatted by
"git format-patch" relative to the current master branch, if that is
feasible for you.

Re: adding Lakota keyboard layouts

[Grant Shoshin Shangreaux]

[-- Attachment #1: Type: text/plain, Size: 892 bytes --]


Eli Zaretskii writes:

> Lakota uses the Latin script, right?  So I think your input method(s)
> should be in the latin-*.el files, depending on whether they are
> prefix or postfix.  Does that sound right?

Yeah that sounds right to me. I'm contributing two orthographies, but
they're both based on latin text. Fits in with the Hawaiian methods in
the same file. Currently, I just have postfix, but may
follow up with prefix input methods in the future.

> Thanks.  As Robert said, please read CONTRIBUTE and format
> accordingly.  We generally prefer the patches to be formatted by
> "git format-patch" relative to the current master branch, if that is
> feasible for you.

yes no problem. i'm going to attach the patch here for now, since this
thread is already open and there's no "bug" to attach it to yet on the
other list.

let me know what else may be needed for this patch! thanks


[-- Attachment #2: Lakota postfix input methods --]
[-- Type: text/x-diff, Size: 2281 bytes --]

From 0caaf81a098ef168681672107a37bfaca8498d52 Mon Sep 17 00:00:00 2001
From: Grant Shangreaux <grant@churls.world>
Date: Sun, 23 May 2021 11:28:25 -0500
Subject: [PATCH] * lisp/leim/quail/latin-post.el Add: Lakota postfix
 definitions

---
 lisp/leim/quail/latin-post.el | 49 +++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/lisp/leim/quail/latin-post.el b/lisp/leim/quail/latin-post.el
index 10408776a2..f4876622b4 100644
--- a/lisp/leim/quail/latin-post.el
+++ b/lisp/leim/quail/latin-post.el
@@ -1298,6 +1298,55 @@
  ("a__" ["a_"])
  )
 
+;; Input modes of various orthographies for the Lakota language.
+;; I'd like to acknowledge the elders and ancestors who fought
+;; to keep the language and culture alive.
+;; Grant Shangreaux <grant@churls.world> 2021-05-23
+
+(quail-define-package
+ "lakota-white-hat-postfix" "Lakota" "Lak " t
+ "Lakota White Hat orthography input method.
+Unused letters `r' and `v' are used to add the dot above and macron
+diacritics for used in this orthography. The glottal stop is produced
+by repeating the `'' character."
+nil t nil nil nil nil nil nil nil nil t)
+
+(quail-define-rules
+ ("f" ?ŋ)
+ ("r" #x307)                            ; COMBINING DOT ABOVE
+ ("v" #x304)                            ; COMBINING MACRON
+ ("''" ?’)
+ )
+
+(quail-define-package
+ "lakota-slo-postfix" "Lakota" "SLO " t
+ "Suggested Lakota Orthography input method.
+Uses a postfix modifier key for adding accent diacritics. To add stress
+to a vowel, simply type the single quote ' after the vowel. All other characters
+are bound to a single key. Mitákuyepi philámayaye ló. "
+nil t nil nil nil nil nil nil nil nil t)
+
+(quail-define-rules
+ ;; accented vowels
+ ("a'" ?á) ("A'" ?Á)
+ ("e'" ?é) ("E'" ?É)
+ ("i'" ?í) ("I'" ?Í)
+ ("o'" ?ó) ("O'" ?Ó)
+ ("u'" ?ú) ("U'" ?Ú)
+
+ ;; consonants with caron
+ ("c" ?č) ("C" ?Č)
+ ("j" ?ȟ) ("J" ?Ȟ)
+ ("q" ?ǧ) ("Q" ?Ǧ)
+ ("x" ?ž) ("X" ?Ž)
+ ("r" ?š) ("R" ?Š)
+
+ ;; velar nasal n
+ ("f" ?ŋ)
+
+ ;; glottal stop
+ ("''" ?’))
+
 (quail-define-package
  "norwegian-postfix" "Latin-1" "NO<" t
  "Norwegian (Norsk) input method (rule: AE->Æ   OE->Ø   AA->Å   E\\='->É
-- 
2.20.1

Re: adding Lakota keyboard layouts

[Robert Pluim]

>>>>> On Sun, 23 May 2021 11:47:21 -0500, Grant Shoshin Shangreaux <grant@churls.world> said:

    Grant> Eli Zaretskii writes:

    >> Lakota uses the Latin script, right?  So I think your input method(s)
    >> should be in the latin-*.el files, depending on whether they are
    >> prefix or postfix.  Does that sound right?

    Grant> Yeah that sounds right to me. I'm contributing two orthographies, but
    Grant> they're both based on latin text. Fits in with the Hawaiian methods in
    Grant> the same file. Currently, I just have postfix, but may
    Grant> follow up with prefix input methods in the future.

    >> Thanks.  As Robert said, please read CONTRIBUTE and format
    >> accordingly.  We generally prefer the patches to be formatted by
    >> "git format-patch" relative to the current master branch, if that is
    >> feasible for you.

    Grant> yes no problem. i'm going to attach the patch here for now, since this
    Grant> thread is already open and there's no "bug" to attach it to yet on the
    Grant> other list.

    Grant> let me know what else may be needed for this patch! thanks

Thanks for this, comments below (disclaimer: I know nothing about
Lakota orthography)

    Grant> From 0caaf81a098ef168681672107a37bfaca8498d52 Mon Sep 17 00:00:00 2001
    Grant> From: Grant Shangreaux <grant@churls.world>
    Grant> Date: Sun, 23 May 2021 11:28:25 -0500
    Grant> Subject: [PATCH] * lisp/leim/quail/latin-post.el Add: Lakota postfix
    Grant>  definitions

Youʼre missing a ChangeLog and a NEWS entry. See commit 229c51afbf for
an example

    Grant> ---
    Grant>  lisp/leim/quail/latin-post.el | 49 +++++++++++++++++++++++++++++++++++
    Grant>  1 file changed, 49 insertions(+)

    Grant> diff --git a/lisp/leim/quail/latin-post.el b/lisp/leim/quail/latin-post.el
    Grant> index 10408776a2..f4876622b4 100644
    Grant> --- a/lisp/leim/quail/latin-post.el
    Grant> +++ b/lisp/leim/quail/latin-post.el
    Grant> @@ -1298,6 +1298,55 @@
    Grant>   ("a__" ["a_"])
    Grant>   )
 
    Grant> +;; Input modes of various orthographies for the Lakota language.
    Grant> +;; I'd like to acknowledge the elders and ancestors who fought
    Grant> +;; to keep the language and culture alive.
    Grant> +;; Grant Shangreaux <grant@churls.world> 2021-05-23
    Grant> +
    Grant> +(quail-define-package
    Grant> + "lakota-white-hat-postfix" "Lakota" "Lak " t
    Grant> + "Lakota White Hat orthography input method.
    Grant> +Unused letters `r' and `v' are used to add the dot above and macron
    Grant> +diacritics for used in this orthography. The glottal stop
    Grant> is produced

Two spaces after '.', here and below

    Grant> +by repeating the `'' character."
    Grant> +nil t nil nil nil nil nil nil nil nil t)
    Grant> +
    Grant> +(quail-define-rules
    Grant> + ("f" ?ŋ)
    Grant> + ("r" #x307)                            ; COMBINING DOT ABOVE
    Grant> + ("v" #x304)                            ; COMBINING MACRON

I guess these combine if you use the ? notation, which looks
terrible. Perhaps a comment to that effect?

Also, in the lakota-slo-postfix, you produce eg á, whereas this
method produces ȧ. Are they intended to represent the same sound? If
so, could it be confusing to have them represented differently?

    Grant> + ("''" ?’)
    Grant> + )
    Grant> +
    Grant> +(quail-define-package
    Grant> + "lakota-slo-postfix" "Lakota" "SLO " t
    Grant> + "Suggested Lakota Orthography input method.
    Grant> +Uses a postfix modifier key for adding accent diacritics. To add stress
    Grant> +to a vowel, simply type the single quote ' after the vowel. All other characters
    Grant> +are bound to a single key. Mitákuyepi philámayaye ló. "
    Grant> +nil t nil nil nil nil nil nil nil nil t)
    Grant> +
    Grant> +(quail-define-rules
    Grant> + ;; accented vowels
    Grant> + ("a'" ?á) ("A'" ?Á)
    Grant> + ("e'" ?é) ("E'" ?É)
    Grant> + ("i'" ?í) ("I'" ?Í)
    Grant> + ("o'" ?ó) ("O'" ?Ó)
    Grant> + ("u'" ?ú) ("U'" ?Ú)
    Grant> +
    Grant> + ;; consonants with caron
    Grant> + ("c" ?č) ("C" ?Č)
    Grant> + ("j" ?ȟ) ("J" ?Ȟ)
    Grant> + ("q" ?ǧ) ("Q" ?Ǧ)
    Grant> + ("x" ?ž) ("X" ?Ž)
    Grant> + ("r" ?š) ("R" ?Š)
    Grant> +
    Grant> + ;; velar nasal n
    Grant> + ("f" ?ŋ)
    Grant> +
    Grant> + ;; glottal stop
    Grant> + ("''" ?’))
    Grant> +
    Grant>  (quail-define-package
    Grant>   "norwegian-postfix" "Latin-1" "NO<" t
    Grant>   "Norwegian (Norsk) input method (rule: AE->Æ   OE->Ø   AA->Å   E\\='->É
    Grant> -- 
    Grant> 2.20.1


Robert
-- 

Re: adding Lakota keyboard layouts

[Grant Shoshin Shangreaux]

[-- Attachment #1: Type: text/plain, Size: 1391 bytes --]


Robert Pluim writes:

> Youʼre missing a ChangeLog and a NEWS entry. See commit 229c51afbf for
> an example

Thank you for the review! I finally had a chance to sit down with this
again and I'm attaching an updated patch that also includes one input
mode added to the latin-prefix file.

I added the NEWS entry, but I apologize, I wasn't able to determine
which ChangeLog I should be adding to. I tried to format my commit
message as documented in the CONTRIBUTE file. 

>
> Two spaces after '.', here and below
>

Good to know the docstrings still follow two spaces after a period, I
believe I've got them all sorted now

>
> I guess these combine if you use the ? notation, which looks
> terrible. Perhaps a comment to that effect?
>

I added a comment, I'd be glad to know if there was a better way to
insert these combining character literals. This proved to be the best
way I could come up with to keep the input mode simple.

> Also, in the lakota-slo-postfix, you produce eg á, whereas this
> method produces ȧ. Are they intended to represent the same sound? If
> so, could it be confusing to have them represented differently?
>

The White Hat orthography doesn't add diacritics to vowels. I added a
table in the docstring to show the intended use of the combining marks
for the consonants. I hope that makes it a bit clearer.

- Grant


[-- Attachment #2: Lakota input modes --]
[-- Type: text/x-diff, Size: 5510 bytes --]

From 2c5ed933f515d2115f37695e8f1b784e88104127 Mon Sep 17 00:00:00 2001
From: Grant Shangreaux <grant@churls.world>
Date: Sun, 23 May 2021 11:28:25 -0500
Subject: [PATCH] Add: input modes for Lakota orthographies

The White Hat and Suggested Lakota Orthography are represented here
by three different input modes: A prefix and postfix mode for the SLO
and a postfix mode for the White Hat orthography.
* lisp/leim/quail/latin-post.el: lakota-slo-postfix, lakota-white-hat-postfix
* lisp/leim/quail/latin-pre.el: lakota-slo-prefix
* etc/HELLO: a welcome message in Lakota
---
 etc/HELLO                     |  1 +
 etc/NEWS                      |  7 +++++
 lisp/leim/quail/latin-post.el | 58 +++++++++++++++++++++++++++++++++++
 lisp/leim/quail/latin-pre.el  | 29 ++++++++++++++++++
 4 files changed, 95 insertions(+)

diff --git a/etc/HELLO b/etc/HELLO
index 0cebb2bb7c..577c2828de 100644
--- a/etc/HELLO
+++ b/etc/HELLO
@@ -59,6 +59,7 @@ Italian (italiano)	Ciao / Buon giorno
 Javanese (ꦧꦱꦗꦮꦶ)	console.log("ꦲꦭꦺꦴ");
 Kannada (ಕನ್ನಡ)	ನಮಸ್ಕಾರ
 Khmer (ភាសាខ្មែរ)	ជំរាបសួរ
+Lakota (Lakȟotiyapi)	Taŋyáŋ yahí!
 Lao (ພາສາລາວ)	ສະບາຍດີ / ຂໍໃຫ້ໂຊກດີ
 Malayalam (മലയാളം)	നമസ്കാരം
 Maldivian (ދިވެހި)	އައްސަލާމު ޢަލައިކުމް / ކިހިނެހް؟
diff --git a/etc/NEWS b/etc/NEWS
index da1372baf4..551affe234 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1214,6 +1214,13 @@ deprecated.  Errors in the Inscript method were corrected.
 *** New input method 'cham'.
 There's also a Cham greeting in "etc/HELLO".
 
+---
+*** New input methods for Lakota language orthographies
+Two orthographies are represented here, the Suggested Lakota Orthography
+and what is known as the White Hat Orthography.  Input methods lakota-slo-prefix,
+lakota-slo-postfix, and lakota-white-hat-postfix have been added.
+There is also a Lakota greeting in "etc/HELLO".
+
 ** Ispell
 
 +++
diff --git a/lisp/leim/quail/latin-post.el b/lisp/leim/quail/latin-post.el
index 10408776a2..8329fff82e 100644
--- a/lisp/leim/quail/latin-post.el
+++ b/lisp/leim/quail/latin-post.el
@@ -1298,6 +1298,64 @@
  ("a__" ["a_"])
  )
 
+;; Input modes of various orthographies for the Lakota language.
+;; I'd like to acknowledge the elders and ancestors who fought
+;; to keep the language and culture alive.
+;; Grant Shangreaux <grant@churls.world> 2021-05-23
+
+(quail-define-package
+ "lakota-white-hat-postfix" "Lakota" "Lak " t
+ "Lakota White Hat orthography input method with postfix modifiers.
+The `f' key produces the nasal ŋ while unused letters `r' and `v' add
+the combining dot above and macron diacritics respectively.  This allows
+production of all the consonants:
+
+cv -> c̄    hr -> ḣ    pv -> p̄    tv -> t̄
+cr -> ċ    kv -> k̄    pr -> ṗ    tr -> ṫ
+gr -> ġ    kr -> k̇    sr -> ṡ    zr -> ż
+
+The glottal stop is produced by repeating the ' character.  This orthography
+does not use stress diacritics on vowels. Mit̄ak̄uyep̄i p̄ilamayayap̄ilo."
+nil t nil nil nil nil nil nil nil nil t)
+
+(quail-define-rules
+ ("f" ?ŋ)
+ ("''" ?’)
+ ;; using hex representation as these characters combine with the ? syntax
+ ("r" #x307)                            ; COMBINING DOT ABOVE
+ ("v" #x304))                            ; COMBINING MACRON
+
+
+
+(quail-define-package
+ "lakota-slo-postfix" "Lakota" "SLO " t
+ "Suggested Lakota Orthography input method with postfix modifier.
+To add stress to a vowel, simply type the single quote ' after the vowel.
+The glottal stop is produced by repeating the ' character.  All other
+characters are bound to a single key.  Mitákuyepi philámayayapi ló."
+nil t nil nil nil nil nil nil nil nil t)
+
+(quail-define-rules
+ ;; accented vowels
+ ("a'" ?á) ("A'" ?Á)
+ ("e'" ?é) ("E'" ?É)
+ ("i'" ?í) ("I'" ?Í)
+ ("o'" ?ó) ("O'" ?Ó)
+ ("u'" ?ú) ("U'" ?Ú)
+
+ ;; consonants with caron
+ ("c" ?č) ("C" ?Č)
+ ("j" ?ȟ) ("J" ?Ȟ)
+ ("q" ?ǧ) ("Q" ?Ǧ)
+ ("x" ?ž) ("X" ?Ž)
+ ("r" ?š) ("R" ?Š)
+
+ ;; velar nasal n
+ ("f" ?ŋ)
+
+ ;; glottal stop
+ ("''" ?’))
+
 (quail-define-package
  "norwegian-postfix" "Latin-1" "NO<" t
  "Norwegian (Norsk) input method (rule: AE->Æ   OE->Ø   AA->Å   E\\='->É
diff --git a/lisp/leim/quail/latin-pre.el b/lisp/leim/quail/latin-pre.el
index b8b0fabfa8..3b9c942a8c 100644
--- a/lisp/leim/quail/latin-pre.el
+++ b/lisp/leim/quail/latin-pre.el
@@ -1337,4 +1337,33 @@
  ("``"  ["`"])
  )
 
+(quail-define-package
+ "lakota-slo-prefix" "Lakota" "SLO " t
+ "Suggested Lakota Orthography input method with prefix modifier.
+To add stress to a vowel, simply type the single quote ' before the vowel.
+The glottal stop is produced by repeating the ' character.  All other
+characters are bound to a single key.  Mitákuyepi philámayayapi ló."
+nil t nil nil nil nil nil nil nil nil t)
+
+(quail-define-rules
+ ;; accented vowels
+ ("'a" ?á) ("'A" ?Á)
+ ("'e" ?é) ("'E" ?É)
+ ("'i" ?í) ("'I" ?Í)
+ ("'o" ?ó) ("'O" ?Ó)
+ ("'u" ?ú) ("'U" ?Ú)
+
+ ;; consonants with caron
+ ("c" ?č) ("C" ?Č)
+ ("j" ?ȟ) ("J" ?Ȟ)
+ ("q" ?ǧ) ("Q" ?Ǧ)
+ ("x" ?ž) ("X" ?Ž)
+ ("r" ?š) ("R" ?Š)
+
+ ;; velar nasal n
+ ("f" ?ŋ)
+
+ ;; glottal stop
+ ("''" ?’))
+
 ;;; latin-pre.el ends here
-- 
2.20.1

Re: adding Lakota keyboard layouts

[Eli Zaretskii]

> From: Grant Shoshin Shangreaux <grant@churls.world>
> Cc: Eli Zaretskii <eliz@gnu.org>, emacs-devel@gnu.org
> Date: Fri, 18 Jun 2021 10:31:21 -0500
> 
> Thank you for the review! I finally had a chance to sit down with this
> again and I'm attaching an updated patch that also includes one input
> mode added to the latin-prefix file.

Thanks, installed.

Re: adding Lakota keyboard layouts

[Robert Pluim]

>>>>> On Fri, 18 Jun 2021 10:31:21 -0500, Grant Shoshin Shangreaux <grant@churls.world> said:
    >> Also, in the lakota-slo-postfix, you produce eg á, whereas this
    >> method produces ȧ. Are they intended to represent the same sound? If
    >> so, could it be confusing to have them represented differently?
    >> 

    Grant> The White Hat orthography doesn't add diacritics to vowels. I added a
    Grant> table in the docstring to show the intended use of the combining marks
    Grant> for the consonants. I hope that makes it a bit clearer.

D'oh. That was clear from your documentation already, but I misread it.

Thanks for this.

Robert
--