spiegel-keyman/web/bulk_rendering
Marc Durdin 9f153ecc17 chore(common): cleanup sh global color variables
Some of the global color variables in shellHelperFunctions.sh were a
little dangerously named. This cleans that up and removes a couple of
redundant functions from other locations.

mac/bashHelperFunctions.sh should be removed and replaced with
references to shellHelperFunctions.sh -- but I wanted to leave that for
a separate branch.
2022-03-10 10:12:09 +11:00
..
build.sh chore(common): cleanup sh global color variables 2022-03-10 10:12:09 +11:00
compare.html fix(web): bulk rendering docs 2021-01-22 16:07:45 +11:00
index.html fix(web): bulk renderer using video stream capture 2021-01-22 15:51:38 +11:00
README.md fix(web): bulk rendering docs 2021-01-22 16:07:45 +11:00
renderer_core.ts refactor(web): centralizes element-oriented OSK display logic, polish for prior commits 2021-09-01 09:44:02 +07:00
tsconfig.json fix(web): bulk renderer using video stream capture 2021-01-22 15:51:38 +11:00

Bulk renderer

This renderer loads all the cloud keyboards from api.keyman.com and renders each of them to the document, saving each render as an inline (data-url) PNG for easy comparison.

Using the bulk renderer

  1. build.sh to build the renderer (must have already built KeymanWeb in ../source/, ./build.sh -debug).
  2. Open index.html (via http, not via file, as otherwise fonts will not be accessible).
  3. If you want a touch layout, use Developer Tools to select the appropriate emulation and then reload the page.
  4. Choose whether you wish to render all layers or just the default layer for each keyboard.
  5. If desired, filter out keyboards by id (regex).
  6. Run the render.
  7. Save the result to a .html file, either before.html or after.html.
  8. When swapping versions, don't forget to rebuild.

compare.html

Compare allows you to load two runs of the renderer side-by-side (simply save the run to either before.html or after.html in this folder). It defaults to a width of 20% which you might need to tweak depending on the size of your display and the width of the OSK images.