mirror of https://github.com/keymanapp/keyman.git synced 2026-08-06 00:45:32 +00:00

History

Joshua A. Horton f94cd9f5dd feat(web): standalone osk tech demo / 'test' page		2023-01-24 15:49:38 +07:00
..
src	feat(web): standalone osk tech demo / 'test' page	2023-01-24 15:49:38 +07:00
.build-builder	chore(web): moves main web script to /web, adds .build-builder file as flag for CI	2022-10-18 13:59:19 +07:00
.gitattributes	Patches up the /samples pages.	2018-01-08 09:51:19 +07:00
.gitignore	change(web): unit_tests -> src/test/auto	2022-10-24 11:55:40 +07:00
build.sh	feat(web): starts implementation of CI publish-s.keyman action	2023-01-20 15:02:18 +07:00
ci.sh	change(web): improved debug path for publish-s.keyman	2023-01-20 15:02:19 +07:00
history.md	chore: merge stable history	2020-04-29 06:33:31 +10:00
index.html	chore(web): web index page cleanups	2022-11-29 09:47:32 +07:00
LICENSE	Move KeymanWeb project to web/	2017-05-26 11:00:34 +07:00
NOTICE	Move KeymanWeb project to web/	2017-05-26 11:00:34 +07:00
package.json	change(web): element-wrapper modularization + unit test conversion	2023-01-20 15:09:56 +07:00
README.md	docs(web): updates Web readme post-reorg	2023-01-20 12:51:49 +07:00
test.sh	chore(web): Merge branch 'change/web/reorg-source-src-reorg' into change/web/reorg-tools	2022-12-01 10:42:47 +07:00

README.md

Keyman Engine for Web

The Original Code is (C) SIL International

Prerequisites

See build configuration for details on how to configure your build environment.

The following folders contain the distribution for Keyman Engine for Web:

src                       Source code
src/resources/osk         OSK resources for inclusion in mobile app builds;
                          keymanweb-osk.ttf is maintained at https://github.com/silnrsi/font-keymanweb-osk

build/app/web/release     Fully-compiled KeymanWeb modules for release
build/app/embed/release   Fully-compiled KMEA/KMEI modules for inclusion in mobile app builds
build/app/web/debug       Fully-compiled but non-minified KeymanWeb modules
build/app/embed/debug     Fully-compiled but non-minified KMEA/KMEI modules

src/samples               Sample pages demonstrating ways to link with KeymanWeb
src/test/manual           Test-case web-pages for various aspects of KeymanWeb functionality
src/test/auto             A Node-driven test suite for automated testing of KeymanWeb

Usage

Open index.html or samples/index.html in your browser. Be sure to compile Keyman Engine for Web before viewing the pages.

Refer to the samples for usage details.

To view pages using compiled Keyman Engine for Web,

cd to keyman/web/
Run ./build.sh
- Use ./build.sh --help for the script's documentation.

Unit Testing

Before running unit tests on Keyman Engine for Web, first run ./build.sh according to the instructions above.

Once the build is complete, running npm test will run the unit testing suite on your local machine in-browser. Alternatively, see test.sh, which the former command executes.

Debugging Unit Tests

During development, to run a specific unit test, change the it to it.only. You can also run all tests under a specific group with describe.only.
From this directory, run ./test.sh --debug. Alternatively, from web/ or any web/ subdirectory,
```
npm run test -- --debug
```
The -- part tells npm to funnel anything to the script as the script's command-line parameters. As long as it's run from somewhere within the web/ folder's hierarchy, that line will always run from web/, as that's where package.json is.
When the browser halts, click the "Debug" button which opens a new debugging tab.
In the Dev console, you can set a breakpoint in your test and refresh the page to debug