libwebsockets/doc-assets
Andy Green 63d2f844db lhp: Lightweight HTML Parser
Introduce a very lightweight html5 + css2.1+ stateful stream parser, along
the same lines as the lws json and cbor ones.

This is interesting primarily because of just how low-resource it is for
modest css + html, it uses an lwsac to hold the entirity of the css in
memory at once but the html is parsed in chunks without any need to keep
previous chunks around (chunks may be as small as 1 byte).

A user callback receives element entry and exit callbacks with payload and
all attributes parsed out, CSS related to the active element stack is
parsed to provide a list of active css attributes, which takes heap for the
duration of the parsing.

In effect this provides rich information about the html and css state to
the callback, which has the job of producing the layout in a user-defined
way.

As such, there is no DOM in memory at one time, there is only a stack of
active elements like <html><body><div>xxx with their associated attributes
(like class).  So as it is, it does not support DOM modification such as
JS changing elements after parsing, although elements with interesting IDs
could be kept around by the callback.  There is a corresponding tiny and
relatively flat heap usage regardless of html size.

Default CSS is specified as recommended in the CSS 2.1 standard.

Inline <style></style> elements are supported, but not pre-html5 style= in
element attributes, since these are incompatible with strict CSP.

What the attributes should mean on your system, eg, font-size, font-family
etc is left for the user callback to decide, along with how to lay out the
items using the CSS attributes, and render them.

Fixed point 32.32 constants are used (fraction expressed at parts in 100M)
instead of floating point.

If you have presentation needs, even on a constrained display on a
constrained microcontroller, this makes it feasible to use standardized
markup and styling instead of roll your own.
2022-05-04 08:43:26 +01:00
..
abstract-overview.svg abstract: allow completely generic instantiation and destruction 2019-06-26 14:33:34 +01:00
accept-flow-1.svg role: raw-proxy 2018-12-01 11:05:59 +08:00
accept-flow-2.svg role: raw-proxy 2018-12-01 11:05:59 +08:00
accept-flow-3.svg role: raw-proxy 2018-12-01 11:05:59 +08:00
backtrace.png alloc: compressed backtrace instrumentation support 2022-03-15 10:28:09 +00:00
fault-injection.png Fault injection 2021-04-05 10:55:04 +01:00
http-proxy-overview.svg minimal examples: update for CSP best practices 2018-11-21 17:03:29 +08:00
jit-trust-logo.png tls: JIT Trust 2021-06-22 15:55:29 +01:00
jit-trust-overview.png tls: JIT Trust 2021-06-22 15:55:29 +01:00
jit-trust-paths.png tls: JIT Trust 2021-06-22 15:55:29 +01:00
jit-trust-single-trust.png tls: JIT Trust 2021-06-22 15:55:29 +01:00
jit-trust-system-trust.png tls: JIT Trust 2021-06-22 15:55:29 +01:00
lhp-104-212-red.jpg lhp: Lightweight HTML Parser 2022-05-04 08:43:26 +01:00
lhp-400-300-red.jpg lhp: Lightweight HTML Parser 2022-05-04 08:43:26 +01:00
lhp-acep7.jpg lhp: Lightweight HTML Parser 2022-05-04 08:43:26 +01:00
lhp-epd-flex-104.jpg lhp: Lightweight HTML Parser 2022-05-04 08:43:26 +01:00
lhp-example-g4.jpg lhp: Lightweight HTML Parser 2022-05-04 08:43:26 +01:00
lhp-overview.png lhp: Lightweight HTML Parser 2022-05-04 08:43:26 +01:00
lhp-rgb-example.png lhp: Lightweight HTML Parser 2022-05-04 08:43:26 +01:00
lhp-ss-unification.png lhp: Lightweight HTML Parser 2022-05-04 08:43:26 +01:00
lifecycle-context.png docs: explain context and client lifecycle 2020-09-18 11:37:17 +01:00
lifecycle-server-wsi.png docs: explain context and client lifecycle 2020-09-18 11:37:17 +01:00
lifecycle-wsi.png docs: explain context and client lifecycle 2020-09-18 11:37:17 +01:00
lws_cache-1.png lws_cache_ttl 2021-06-22 15:55:29 +01:00
lws_cache-2.png lws_cache_ttl 2021-06-22 15:55:29 +01:00
lws_dll.svg docs: lws_dll and lws_dll2 documentation 3 2019-03-26 14:54:50 +08:00
lws_metrics-decimation.png lws_metrics 2021-03-08 21:47:28 +00:00
lws_metrics-policy.png lws_metrics 2021-03-08 21:47:28 +00:00
lws_ota.png lws_ota 2022-03-25 08:18:30 +00:00
lws_sequencer.svg lws_sequencer 2019-06-25 12:10:18 +01:00
lws_struct-overview.svg lws_struct 2019-04-06 06:08:47 +08:00
lws_system_states.png lws_ota 2022-03-25 08:18:30 +00:00
lws-crypto-overview.svg JOSE: refactor and prepare for JWE 2018-12-27 06:45:31 +08:00
lws-detailed-latency-example.png detailed latency stats 2019-09-22 03:06:59 -07:00
lws-fts.svg fulltext search 2018-10-26 13:53:28 +08:00
lws-overview.png changelog: prepare for v4.1 2020-07-15 16:18:00 +01:00
lws-relpol-1.svg docs: release-policy README and pics 2018-11-14 08:57:29 +08:00
lws-relpol-2.svg docs: release-policy README and pics 2018-11-14 08:57:29 +08:00
lws-relpol-3.svg docs: release-policy README and pics 2018-11-14 08:57:29 +08:00
lws-relpol-4.svg docs: release-policy README and pics 2018-11-14 08:57:29 +08:00
lws-relpol-5.svg docs: release-policy README and pics 2018-11-14 08:57:29 +08:00
lws-smp-example.png smp: add some overview docs on the related minimal example 2018-04-19 16:16:48 +08:00
lws-smp-ov.png smp: add some overview docs on the related minimal example 2018-04-19 16:16:48 +08:00
lws-sspc-1.png sspc: refactor to allow different transports 2021-10-08 09:48:41 +01:00
lws-sspc-2.png sspc: refactor to allow different transports 2021-10-08 09:48:41 +01:00
lwsac.svg lwsac 2018-10-16 05:05:56 +08:00
lwsgt-overview.png plugin table dirlisting 2016-07-14 08:57:28 +08:00
rpi-uart-1.png sspc: refactor to allow different transports 2021-10-08 09:48:41 +01:00
rpi-uart.png sspc: refactor to allow different transports 2021-10-08 09:48:41 +01:00
smd-message.png smd-add-ss-rx-forwarder-helper 2021-01-05 10:56:38 +00:00
smd-proxy.png smd-add-ss-rx-forwarder-helper 2021-01-05 10:56:38 +00:00
smd-single-process.png smd-add-ss-rx-forwarder-helper 2021-01-05 10:56:38 +00:00
ss-api1.png examples: move existing to m-e-lowlevel and start repoulating m-e with SS 2021-10-08 09:49:05 +01:00
ss-api2.png examples: move existing to m-e-lowlevel and start repoulating m-e with SS 2021-10-08 09:49:05 +01:00
ss-api3.png examples: move existing to m-e-lowlevel and start repoulating m-e with SS 2021-10-08 09:49:05 +01:00
ss-explain.png client: secure streams 2020-03-04 12:17:49 +00:00
ss-operation-modes.png ss: server: h1, h2, ws basic support 2020-07-27 12:05:24 +01:00
ss-state-flow-server.png ss: server: h1, h2, ws basic support 2020-07-27 12:05:24 +01:00
ss-state-flow.png docs: ss: update client state lifecycle with destroy api note 2020-10-19 16:35:03 +01:00
threadpool-states.svg threadpool 2018-09-11 18:27:59 +08:00
threadpool.svg threadpool 2018-09-11 18:27:59 +08:00
work.png README.md: update with work retrospective and more Sai info 2021-10-05 06:48:26 +01:00
wss2.png README.md: serve from repo 2018-08-14 19:09:23 +08:00