Skip to content

[kalasha] keyboard submission#3917

Draft
Meng-Heng wants to merge 15 commits intokeymanapp:masterfrom
Meng-Heng:kalasha_keyboard
Draft

[kalasha] keyboard submission#3917
Meng-Heng wants to merge 15 commits intokeymanapp:masterfrom
Meng-Heng:kalasha_keyboard

Conversation

@Meng-Heng
Copy link
Copy Markdown
Contributor

@Meng-Heng Meng-Heng commented Mar 11, 2026

On behalf of Elsa Cooper and Malachi James.

Test-bot: skip

@Meng-Heng Meng-Heng marked this pull request as draft March 11, 2026 05:21
@keyman-server
Copy link
Copy Markdown
Collaborator

Thank you for your pull request. You'll see a "build failed" message until the Keyman team has reviewed the pull request and manually initiated the build process.

Every change committed to this branch will become part of this pull request. When you have finished submitting files and are ready for the Keyman team to review this pull request, please post a "Ready for review" comment.

Co-authored-by: Darcy Wong <darcy_wong@sil.org>
Copy link
Copy Markdown
Contributor

@darcywong00 darcywong00 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few minor changes for the build to compile

"kls"
],
"description": "The Kaḷaṣamondr keyboard is created to type the kalasha language with Roman (Latin) script. Allowing keyboard users to write in English and Kalasha without switching keyboards."
}
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think you can remove .keyboard_info since kmc generates it now.

@LornaSIL
Copy link
Copy Markdown
Contributor

LornaSIL commented Mar 12, 2026

The kalasha.php file needs to have the style information inside the php header, not outside.
Use the $pagestyle setting something like the following. There are actually a lot of keyboards you can look at for a sample.

<?php 
  $pagename = 'Amazigh Latin (SIL) Keyboard Help';
  $pagetitle = $pagename;
  $pagestyle = <<<END
    samp {font-size:16pt; line-height:.8em;}
    kbd {color:black; font:9pt Arial; border:solid 1px grey; background:#ccc; margin:0px 1px;  padding:2px 4px; vertical-align:middle; line-height:2em; -webkit-border-radius: 3px; -moz-border-radius: 3px; border-radius: 3px;}
    table { border-collapse: collapse; width: 25%; font-size: small; }
    td, th { border: 1px solid #cccccc; text-align: left; padding: 5px; font: 12pt Tahoma;}
    tr:nth-child(even) { background-color: #eeeeee; }
    tr { height: 2.2em; }
END;
  
  require_once('header.php');
?>

Also, all graphics used in the php file must be in the help folder, not pulled from the welcome folder. This is because they help folder is actually copied into another repo at build time. So, it won't find those files the .php file is looking for. It's unfortunate they have to be duplicated in the repo, but that's the system for now.

@LornaSIL
Copy link
Copy Markdown
Contributor

Keyboard name should be made consistent. Currently there is Kalasha and Kaḷaṣamondr in various files. (It is fine for the filename to be kalasha and the keyboard name to be Kaḷaṣamondr if that's what they want.)

As said above, LICENSE.md should be included on the Details tab of the .kps or it won't compile on the build system (it does compile locally, but the online build system is more strict).

@LornaSIL
Copy link
Copy Markdown
Contributor

I double-checked the langtag and it is correctly kls for the Latin script for this language.

@Meng-Heng Meng-Heng marked this pull request as ready for review March 13, 2026 04:17
@Meng-Heng
Copy link
Copy Markdown
Contributor Author

Keyboard name should be made consistent. Currently there is Kalasha and Kaḷaṣamondr in various files. (It is fine for the filename to be kalasha and the keyboard name to be Kaḷaṣamondr if that's what they want.)

Yes, I am considering to use the kalasha as the id and Kaḷaṣamondr for the name. The keyboard was sent to me like that. I'll update.

…s, and apply the style correctly

Co-authored-by: Lorna
@Meng-Heng Meng-Heng marked this pull request as draft March 13, 2026 07:45
@Meng-Heng
Copy link
Copy Markdown
Contributor Author

Also, all graphics used in the php file must be in the help folder, not pulled from the welcome folder. This is because they help folder is actually copied into another repo at build time.

I have two help/longpress.gif welcome/longpress.gif, do I need to add both files to KPS?

@LornaSIL
Copy link
Copy Markdown
Contributor

I have two help/longpress.gif welcome/longpress.gif, do I need to add both files to KPS?

You need the one from welcome in the .kps. You shouldn't include anything from help (unless the welcome file is referencing those graphics in the help folder).

@Meng-Heng
Copy link
Copy Markdown
Contributor Author

Thank you.

@LornaSIL
Copy link
Copy Markdown
Contributor

Are you still working on this PR? It's still in draft.
Also, LICENSE.md should be referenced on the Details tab of the .kps. I don't think it s.

@Meng-Heng
Copy link
Copy Markdown
Contributor Author

I am waiting on the keyboard authors to test the keyboard to see if it is the right behavior they are looking for.
Yes, sorry about that. I got confused between the Details and the File tabs.

$pagestyle = <<<END
body {
font-family: Arial, Helvetica, sans-serif;
margin: 40px;
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might be able to remove the margin styling.
Otherwise the title bar gets

Image
Suggested change
margin: 40px;

Comment on lines +5 to +52
body {
font-family: Arial, Helvetica, sans-serif;
background: #f9f9f9;
}

table {
width: 100%;
border-collapse: collapse;
background: white;
}

thead.main-header, .main-foot {
background: #2c3e50;
color: white;
}

thead.sub-header {
background-color: #284a6e;
color: white;
}

th, td {
padding: 12px 16px;
text-align: left;
border-bottom: 1px solid #ddd;
}

th {
font-weight: 600;
letter-spacing: 0.02em;
}

tbody tr:hover {
background: #f5f7fa;
}

tbody tr:nth-child(even) {
background: #fafafa;
}

kbd {
font-size: 20px;
background-color: black;
color: white ;
border-radius: 20px;
text-align: center;
padding: 2px 25px;
}
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These mostly should not be included here -- they are too broad. In particular, do not override styling for body.

To have styles that apply only to the keyboard section and not to the frame content, then use the tag article, for example:

        article table {
          width: 100%;
          border-collapse: collapse;
          background: white;
        }

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants