Open Source Keyman keyboards
Switch branches/tags
Nothing to show
Clone or download
LornaSIL Merge pull request #576 from dyacob/gff-amharic-1.7-keyboard-info-fix
gff_amharic v1.7: Setting lastModifiedDate to commit time.
Latest commit aa3f075 Dec 12, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
experimental/n/ntl_onekey fix typo in previous check-in Apr 6, 2018
legacy Add "helpLink" field Nov 27, 2018
release Merge pull request #576 from dyacob/gff-amharic-1.7-keyboard-info-fix Dec 11, 2018
resources
tools
.gitignore Merge pull request #35 from dyacob/gff_amharic May 22, 2018
README.md
build.cmd Testing build.cmd for CI Sep 26, 2017
build.sh
ci.sh test for Windows support in the package before attempting to build co… Feb 26, 2018

README.md

Open Source Keyman keyboards

File Layout

Keyboards are grouped into three folders:

  • release - keyboards with full source that pass our stringent quality checks, Unicode only
  • legacy - binary distributions of keyboards, migrated from Tavultesoft servers, Unicode and non-Unicode
  • experimental - keyboards that have not yet passed the quality check, available from the 'experimental' category in Keyman apps with Keyman 10 and later. Unicode only.

Within each of the folders, keyboards are further grouped by first letter or by prefix, where multiple keyboards share the same prefix indicating provenance, for example sil or gff.

Contributing

First, read the guide! https://help.keyman.com/developer/keyboards/

Keyman Developer 10.0 is recommended to edit these files. https://keyman.com/developer

Building Keyboards

Prerequisites

Windows:

  • Git for Windows (or MinGW)
  • You will need to use Git Bash or equivalent to build (not tested with Cygwin), not Windows Command Prompt or PowerShell.
  • You can also WSL (Bash on Ubuntu on Windows) if you place the repo in a Windows-accessible path (such as /mnt/c/...), so the Keyman Developer Compiler can run (requires Windows 10 Anniversary Update or later). Beware of line-ending changes if mixing Windows and WSL usage!

Linux, macOS:

  • WINE is required in order to run the Keyman Developer compiler which is currently a Windows-only executable.

Build instructions

build.sh can be used to build all the keyboards from the command line.

  • The Keyman Developer compiler is included in the tools/ folder and so Keyman Developer is not required for builds.

  • Common build.sh parameters:

    • --help List build.cmd parameters
    • -s Quieter build
    • -c Clean instead of build
    • -d Include debug information
    • -w Treat warnings as errors
    • [target] Specific folder to build
  • Each keyboard also includes a project file which can be used to build the project - either from the command line kmcomp compiler, or from the Keyman Developer IDE.

Deprecated keyboards

If a keyboard has been replaced by another keyboard, include a DEPRECATED.md file in the folder referencing the new keyboard name.

Common links