spiegel-keyman/developer/js
2019-10-05 14:50:39 -06:00
..
source [Developer] Remove model version from metadata in packages (kmlmp) 2019-10-03 06:00:08 +10:00
tests [Developer] Remove extraneous version tag from test 2019-10-03 21:00:46 +10:00
.gitignore [developer] Initial lexical model compiler files (not yet working) 2019-05-08 10:40:46 +10:00
.npmignore Create publish script and document. 2019-09-30 13:24:51 -06:00
build.sh build.sh always installs deps, even when given -test. 2019-10-02 13:46:02 -06:00
package-lock.json Start to document how npm packaging will work. 2019-09-30 09:59:55 -06:00
package.json Make it work with the developer tools. 2019-10-01 12:54:57 -06:00
README.md Make lexical-model-compiler README slightly more user-centric. 2019-10-05 14:50:39 -06:00
tsconfig.json Add a few more strict checks. 2019-08-19 15:26:28 -06:00

Keyman Developer

This package provides the following Keyman command line tools:

  • kmlmc — takes lexical model sources and compiles them in to a .js file.
  • kmlmp — uses a .model.kmp file to generate a redistributable lexical model package.
  • kmlmi — merges Keyman lexical model .model_info files.

kmlmc is intended to be used standalone, or as part of a build system. kmlmp is used only by command line tools. kmlmi is used exclusively in the lexical-models repository.

In order to build lexical models, these tools must be built and compiled.

Install

Install kmlmc, kmlmp, and kmlmi globally:

npm install -g @keymanapp/lexical-model-compiler

Usage

To compile a lexical model from its .model.ts source, use kmlmc:

kmlmc my-lexical-model.model.ts --outFile my-lexical-model.js

To see more command line options by using the --help option:

kmlmc --help
kmlmp --help
kmlmi --help

How to build from source

Run build.sh:

./build.sh

How to run the tests

./build.sh -test

How to update the package version

NOTE: this step should only be performed on the CI server:

./build.sh -version MAJOR.MINOR.${BUILD_NUMBER} [-tier (alpha|beta)]